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

# API Reference

> Complete reference for all Dot Prediction API endpoints.

## Base URL

```
https://api.dotprediction.io
```

## Authentication

Pass your API key via the `X-API-Key` header:

```bash theme={null}
curl https://api.dotprediction.io/v1/api/markets?provider=polymarket \
  -H "X-API-Key: YOUR_API_KEY"
```

## Response Format

```json theme={null}
{
  "pagination": { "total": 100, "limit": 20, "has_more": true, "next_cursor": "abc123" },
  "markets": [],
  "meta": { "platforms_queried": ["polymarket"], "request_time": 45, "cache_hit": false }
}
```

## Rate Limits

| Tier | Limit       | Cost |
| ---- | ----------- | ---- |
| Free | 250 req/min | Free |
| Pro  | 500 req/min | Paid |

Rate limits are per user, shared across all API keys.

**Headers included in every response:**

| Header                  | Description                               |
| ----------------------- | ----------------------------------------- |
| `X-RateLimit-Limit`     | Max requests per minute                   |
| `X-RateLimit-Remaining` | Remaining requests in current window      |
| `Retry-After`           | Seconds to wait (on `429` responses only) |