Genesis API Documentation
Everything you need to integrate: authentication, limits, endpoints and response schemas.
DocumentationErrors
Errors
Errors return the matching HTTP status with a body:
json
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}| HTTP | Code | Description |
|---|---|---|
400 | bad_request | Invalid request parameters — details in message |
401 | invalid_key | Key missing, invalid or revoked, or the API plan has expired |
403 | plan_restricted | Endpoint is not included in your plan |
404 | not_found | Endpoint or resource not found |
410 | gone | The endpoint is retired — the replacement is in message |
429 | rate_limited | Rate limit exceeded — see X-RateLimit and Retry-After |
429 | download_limited | Download volume exceeded: 60 MB of compressed data per 10 seconds per key — see Retry-After |
500 | internal_error | Internal error, retry later |
503 | snapshot_not_ready | Data is being rebuilt or its source is restarting — retry in a few seconds, see Retry-After |
Every response carries an X-Request-Id header. When contacting support, send it with the request time in UTC, the endpoint and the status — never your key.