Skip to main content

​
Error format

All errors follow a consistent envelope (RFC 7807-inspired): 
{
  "object": "error",
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid or missing API key.",
    "doc_url": "https://0xinsider.com/docs/api#authentication",
    "param": null
  },
  "meta": {
    "request_id": "req_550e8400"
  }
}

​
Error codes

HTTP StatusCodeDescription
400bad_requestInvalid parameter — check the param field for which one
401invalid_api_keyMissing, malformed, or revoked API key
402subscription_requiredValid key but no active Insider subscription
403forbiddenAccount has been deleted
404not_foundResource doesn’t exist
423account_lockedAccount is suspended
429rate_limitedExceeded 100 req/min — check Retry-After header
500internal_errorSomething went wrong on our end

​
Troubleshooting

​
”Invalid or missing API key”

  • Verify the Authorization header format: Bearer oxi_sk_test_...
  • Check that the key hasn’t been revoked at 0xinsider.com/developers
  • Keys are 76 characters total — ensure you copied the full key

​
”Active Insider subscription required”

Your API key is valid but your subscription has expired or you’re on the free tier. Subscribe at 0xinsider.com/pricing.

​
”Rate limit exceeded”

Wait for the number of seconds in the Retry-After response header, then retry. See Rate Limits for best practices.

​
500 errors

These are bugs on our end. Include the request_id from the response when contacting support@0xinsider.com.