Errors - GammaFlip API

Error format

All errors return a JSON body with error and message:

{
  "error": "rate_limit_exceeded",
  "message": "Daily limit of 500 reached."
}

Code	Meaning	Common causes
`200`	OK	—
`400`	Bad Request	Invalid exchange name, malformed parameters
`401`	Unauthorized	Missing or invalid API key
`403`	Forbidden	Subscription doesn’t allow API access
`404`	Not Found	No data available for this coin/exchange/expiration
`429`	Too Many Requests	Daily quota exceeded — see rate limits
`500`	Server Error	Something went wrong on our side — retry or contact support

{ "error": "unauthorized", "message": "Invalid or missing API key." }

Check that:

{
  "error": "subscription_required",
  "message": "API access requires Pro subscription or active trial.",
  "current_tier": "premium"
}

Your subscription doesn’t include API access. The current_tier field shows your current plan. Upgrade to Pro to get API access.

{
  "error": "invalid_exchange",
  "message": "Exchange \"foo\" is not available."
}

Valid values: bybit, deribit, okx, all (aggregated).

{ "error": "no_data", "message": "No data available for XYZ." }

The combination of coin/exchange/expiration doesn’t exist. Common causes:

{ "error": "rate_limit_exceeded", "message": "Daily limit of 500 reached." }

See Rate Limits for handling strategies.