> For the complete documentation index, see [llms.txt](https://resolvedmarkets.com/llms.txt). Every docs page is also served as Markdown: append `.md` to its URL or send `Accept: text/markdown`.

## Fetching & Pagination

Endpoints returning large result sets support `limit` and `offset` parameters.

| Parameter | Type | Default | Max | Description |
| --- | --- | --- | --- | --- |
| `limit` | integer | 500 | 5,000 | Maximum rows to return |
| `offset` | integer | 0 | — | Number of rows to skip |

```
# Page 1
GET /v1/markets/{id}/snapshots?limit=500&offset=0
# Page 2
GET /v1/markets/{id}/snapshots?limit=500&offset=500
# Page 3
GET /v1/markets/{id}/snapshots?limit=500&offset=1000
```

**Time-range filtering** — use `from` and `to` parameters:

```
GET /v1/markets/{id}/snapshots?from=2026-03-10 14:00:00&to=2026-03-10 15:00:00
```

Timestamps use `YYYY-MM-DD HH:MM:SS` or `YYYY-MM-DD HH:MM:SS.mmm` in UTC.

**Common filters**

| Filter | Values | Applies to |
| --- | --- | --- |
| `category` | crypto, sports, economics, weather | Markets, History endpoints |
| `subcategory` | BTC, NBA, FOMC, NYC, etc. | Markets, History endpoints |
| `crypto` | BTC, ETH, SOL, XRP | Most endpoints (legacy) |
| `timeframe` | Per-category discriminator, 21 values: crypto 5m/15m/1h/4h/1d/hit-price · sports game · economics rates · social weekly · weather daily-high/daily-low/event/seasonal · equities annual/monthly/daily/event/earnings/quarterly/valuation/comparison/leaderboard | Most endpoints |
| `side` | UP, DOWN | Snapshot endpoints |

**Paginated response shape**

```json
{
  "market_id": "0x...",
  "total": 54000,
  "limit": 500,
  "offset": 0,
  "data": [ /* ... */ ]
}
```