> ## 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.

# Get Polymarket Market Date Range

> Return the stored date range for a Polymarket market condition ID.

## Request

### Headers

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

### Query Parameters

<ParamField query="condition_id" type="string" required>
  The Polymarket market condition ID. Values are accepted with or without the `0x` prefix.
</ParamField>

## Response

<ResponseField name="market_condition_id" type="string">
  The normalized Polymarket market condition ID.
</ResponseField>

<ResponseField name="has_data" type="boolean">
  Whether any stored data was found for the market.
</ResponseField>

<ResponseField name="start_date" type="string">
  Earliest stored date for this market, or `null` if none exists.
</ResponseField>

<ResponseField name="end_date" type="string">
  Latest stored date for this market, or `null` if none exists.
</ResponseField>

<ResponseField name="available_date_count" type="integer">
  Number of distinct stored dates found for the market.
</ResponseField>

<Tip>
  Use this endpoint as the authoritative per-market availability check before requesting raw Polymarket data. Orderbook data exists for a subset of Polymarket markets from `2025-09-01`, but coverage is not continuous. Continuous Polymarket crypto-related market coverage begins on `2026-02-04`, and continuous coverage for all Polymarket markets begins on `2026-04-02`.
</Tip>

<Note>
  `GET /api/v1/polymarket/market/date-range` reflects stored dates in S3. It does not prove every second in that day is complete. `GET /api/v1/polymarket/market/data` still rejects dates earlier than `2026-02-08`.
</Note>

## Example

<CodeGroup>
  ```bash Raw HTTP (cURL) theme={null}
  curl -H "Authorization: Bearer YOUR_API_KEY" \
    "https://api.entityml.com/api/v1/polymarket/market/date-range?condition_id=8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4"
  ```

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

  response = requests.get(
      "https://api.entityml.com/api/v1/polymarket/market/date-range",
      headers={"Authorization": f"Bearer {os.environ['ENTITY_API_KEY']}"},
      params={
          "condition_id": "8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4"
      },
  )

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

### Example response

```json theme={null}
{
  "market_condition_id": "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4",
  "has_data": true,
  "start_date": "2026-02-04",
  "end_date": "2026-02-14",
  "available_date_count": 8
}
```
