Genesis API Documentation

Everything you need to integrate: authentication, limits, endpoints and response schemas.

DocumentationPlans & limits

Plans & limits

Limits are set by your plan. The current state is always available at /account/usage and in the headers of every response.

TrialStartProMax
Calls per month500K2M5M10M
Requests per second12515
Data freshness60 s30 s10 s5 s

Endpoints outside your plan return 403 with the plan_restricted code. Requests over the limits are never billed.

Only a 200 response counts as a call. 304 (not modified) responses and 4xx/5xx errors do not use your quota, but they still count toward the requests-per-second limit.

Download volume is limited to 60 MB of compressed data per 10 seconds per key. Polling every dataset at your plan's freshness fits with room to spare; responses under 64 KB are not counted. Over the limit — 429 download_limited until the window ends, not counted. Save traffic with If-None-Match, filters and the coin parameter.

Rate limit headers

HeaderDescription
X-RateLimit-LimitRequests-per-second limit for your plan
X-RateLimit-RemainingRequests left in the current window
X-RateLimit-ResetUnix time when the window resets
X-Quota-LimitCall quota for the current 30-day period
X-Quota-RemainingCalls left in the period
X-Quota-ResetUnix time the quota resets
Retry-AfterSeconds to wait before retrying (on 429 and 503)