Problem details you can switch on

Every error is an RFC 9457 problem: a stable type URL that lands on its row below, the HTTP status, a detail that says what to change, the request id as instance, and suggestions where a close match exists.

Read the reference

404 application/problem+json

{
  "type": "https://arbitron.app/developers/errors#unknown-coin",
  "title": "Unknown coin",
  "status": 404,
  "detail": "No venue quotes a perpetual on 'ETHEREUM'. GET /api/v1/coins?q=ETHEREUM lists close matches.",
  "instance": "0HN7Q2K3J9R4P:00000001",
  "code": "unknown-coin",
  "docs": "https://arbitron.app/developers/errors",
  "suggestions": ["ETH", "ETC", "ETHFI"]
}

Every error code

400 invalid-parameter

A query value is out of range or the wrong shape. detail names the parameter and the accepted values.

401 unauthenticated

No key, or one that is mistyped, revoked, expired or rotated out. Send Authorization: Bearer with a key from the AI assistants & API page.

403 scope-missing

The key was created without the scope this endpoint needs; detail lists the scopes it has. Create a key with that scope.

403 plan-limit

The request reaches past the plan: a history window deeper than it includes, or a page larger than the Demo plan returns. Narrow the request or upgrade.

404 unknown-coin

No venue quotes a perpetual on that ticker. suggestions carries close matches, and GET /api/v1/coins?q= searches.

404 unknown-exchange

The venue is not one the API serves. suggestions lists the venues, as does GET /api/v1/exchanges.

404 unknown-card

No card of this account has that card_ref. Take the card_ref from GET /api/v1/me/cards; it belongs to your account only.

404 not-found

No endpoint at that path under /api/v1. GET /api/v1 lists the ones that exist.

429 rate-limited

The minute window is spent, or too many rejected keys came from one address. Wait Retry-After seconds, or pace the client from the RateLimit header.

429 quota-exhausted

The month's requests are used up. The quota resets on the 1st at 00:00 UTC; a higher plan has more.

503 snapshot-unavailable

The snapshot behind the endpoint is still warming up after a restart. Retry in a minute.

503 api-disabled

The API is not enabled on this host. Nothing to change on your side; it is a configuration fault on ours.