Guide

Errors & Rate Limits

Failed requests return error codes with a 4xx or 5xx status. Rate limits are enforced per API key by plan tier, and exceeding the limit returns 429 Too Many Requests with a Retry-After header. History depth is tiered by plan for certain endpoints, see the resource description for plan limits.

Error code

Status

Description

invalid_parameter

400

Missing or malformed parameter or request body.

unauthorized

401

Missing, invalid, or revoked API key.

subscription_required

403

Valid key, but its subscription is inactive.

forbidden

403

The key's plan does not include this resource.

not_found

404

The requested entity or path does not exist.

rate_limited

429

Rate limit or monthly quota exceeded — retry after Retry-After.

internal_error

500

Unexpected server error.

Plan

Rate limit

Starter

10 req/s

Pro

15 req/s

Premium

50 req/s

Header

Description

X-RateLimit-Limit

Requests allowed per second on your plan.

X-RateLimit-Remaining

Requests left in the current window.

X-RateLimit-Reset

When the window resets (Unix seconds).

Retry-After

Seconds to back off — sent only on 429 responses.