> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket

> Prediction market platform providing real-time market-derived probabilities for political, economic, and cultural events.

Prediction market platform providing real-time market-derived probabilities for political, economic, and cultural events. Best for probabilistic forecasting workflows — gauging the likelihood of future events based on market consensus rather than polls or expert opinion. Unlike traditional financial data (SEC EDGAR, Nasdaq), Polymarket surfaces crowd-aggregated probability estimates for discrete outcomes.

4 endpoints available through Lava's AI Gateway.

<Info>This provider is **managed** — no additional setup required.</Info>

## Endpoints

### Query prediction market events, markets, and search

**GET** `https://gamma-api.polymarket.com/events?limit=5` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://gamma-api.polymarket.com/events?limit=5', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fgamma-api.polymarket.com%2Fevents%3Flimit%3D5" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get real-time market prices, spreads, and order books

**GET** `https://clob.polymarket.com/midpoint?token_id=13915689317269078219168496739008737517740566192006337297676041270492637394586` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://clob.polymarket.com/midpoint?token_id=13915689317269078219168496739008737517740566192006337297676041270492637394586', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fclob.polymarket.com%2Fmidpoint%3Ftoken_id%3D13915689317269078219168496739008737517740566192006337297676041270492637394586" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get open interest for a market

**GET** `https://data-api.polymarket.com/oi` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://data-api.polymarket.com/oi', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata-api.polymarket.com%2Foi" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

### Get position holders for a market

**GET** `https://data-api.polymarket.com/holders` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://data-api.polymarket.com/holders', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fdata-api.polymarket.com%2Fholders" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>