Errors
The problem types the API returns.
Each error's type links to a section here. See Conventions for the format.
Bad request
The query string or body can't be used: a limit outside 1–100, a malformed cursor, or a body that isn't a JSON object.
Unauthorized
No key, an unknown key, or a key that is revoked, expired, belongs to the other market, or whose creator has left the firm. The detail says which.
Forbidden
The key's scopes or its creator's role don't allow the action, or the call came from an IP address outside the key's allowlist.
Not found
The resource doesn't exist, or isn't in your firm.
Conflict
The action doesn't fit the current state (for example sending a request that was already sent), or an Idempotency-Key was reused with a different request.
Payload too large
The body is larger than 256 KB.
Unsupported media type
Send JSON with Content-Type: application/json.
Validation failed
The body has invalid values; errors lists them.
Too many requests
You passed the rate limit. Wait Retry-After seconds.
Server error
Something failed on our side. Retry with the same Idempotency-Key, and contact support with the request_id if it persists.