Errors
Every API error returns a stable code, HTTP status, request ID, and docs URL for support/debugging.
Error Envelope
json
{ "error": { "code": "invalid_request", "message": "Invalid Solana wallet address.", "requestId": "req_...", "docsUrl": "https://rugburn.io/docs/api/errors#invalid_request" }, "meta": { "requestId": "req_..." }}Codes
unauthorized401Missing API key.invalid_api_key401API key hash was not found.forbidden403Key is inactive, expired, revoked, or missing scope.invalid_request400Malformed JSON or invalid Solana address.not_found404No cached RugBurn evidence exists for the requested entity.rate_limited429Per-minute API key limit exceeded.quota_exceeded429Monthly quota exhausted.service_unavailable503Required schema or setup is missing.internal_error500Unexpected server failure.
