API Reference - Dot Prediction

Base URL

https://api.dotprediction.io

Authentication

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

curl https://api.dotprediction.io/v1/api/markets?provider=polymarket \
  -H "X-API-Key: YOUR_API_KEY"

Response Format

{
  "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)