Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
Plans & limits
Limits are set by your plan. The current state is always available at /account/usage and in the headers of every response.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| Calls per month | 500K | 2M | 5M | 10M |
| Requests per second | 1 | 2 | 5 | 15 |
| Data freshness | 60 s | 30 s | 10 s | 5 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
| Header | Description | |
|---|---|---|
X-RateLimit-Limit | Requests-per-second limit for your plan | |
X-RateLimit-Remaining | Requests left in the current window | |
X-RateLimit-Reset | Unix time when the window resets | |
X-Quota-Limit | Call quota for the current 30-day period | |
X-Quota-Remaining | Calls left in the period | |
X-Quota-Reset | Unix time the quota resets | |
Retry-After | Seconds to wait before retrying (on 429 and 503) |