Genesis API Documentation

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

Errors

Errors return the matching HTTP status with a body:

json
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}
HTTPCodeDescription
400bad_requestInvalid request parameters — details in message
401invalid_keyKey missing, invalid or revoked, or the API plan has expired
403plan_restrictedEndpoint is not included in your plan
404not_foundEndpoint or resource not found
410goneThe endpoint is retired — the replacement is in message
429rate_limitedRate limit exceeded — see X-RateLimit and Retry-After
429download_limitedDownload volume exceeded: 60 MB of compressed data per 10 seconds per key — see Retry-After
500internal_errorInternal error, retry later
503snapshot_not_readyData 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.