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

# List Polymarket Markets

> List stored Polymarket market condition IDs from the backing S3 inventory.

## Request

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Example: `Bearer YOUR_API_KEY`
</ParamField>

### Query Parameters

<ParamField query="prefix" type="string">
  Optional condition ID prefix filter. Values are accepted with or without the `0x` prefix. Example: `0x8213`.
</ParamField>

<ParamField query="offset" type="integer">
  Number of markets to skip. Default: `0`.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of markets to return. Default: `100`. Max: `1000`.
</ParamField>

## Response

<ResponseField name="total_markets" type="integer">
  Total number of stored Polymarket markets after applying the optional prefix filter.
</ResponseField>

<ResponseField name="returned_count" type="integer">
  Number of market IDs returned in this page.
</ResponseField>

<ResponseField name="filter_prefix" type="string">
  The normalized prefix filter that was applied, if any.
</ResponseField>

<ResponseField name="market_condition_ids" type="array">
  Array of stored Polymarket market condition IDs.
</ResponseField>

<ResponseField name="pagination" type="object">
  Standard pagination metadata with `offset`, `limit`, `total_count`, and `has_more`.
</ResponseField>

<Tip>
  Each successful call to this endpoint counts as 1 API request.
</Tip>

## Example

<CodeGroup>
  ```bash Raw HTTP (cURL) theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://api.entityml.com/api/v1/polymarket/market/list?prefix=0x8213&offset=0&limit=5"
  ```

  ```python Python theme={null}
  import os
  import requests

  response = requests.get(
      "https://api.entityml.com/api/v1/polymarket/market/list",
      headers={"Authorization": f"Bearer {os.environ['ENTITY_API_KEY']}"},
      params={"prefix": "0x8213", "offset": 0, "limit": 5},
  )

  print(response.json())
  ```
</CodeGroup>

### Example response

```json theme={null}
{
  "total_markets": 1,
  "returned_count": 1,
  "filter_prefix": "0x8213",
  "market_condition_ids": [
    "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4"
  ],
  "pagination": {
    "offset": 0,
    "limit": 5,
    "total_count": 1,
    "has_more": false
  }
}
```