Skip to main content

Rate Limits

Key-gated endpoints are rate-limited per plan, with a per-minute and (below Enterprise) a per-month budget. The budget is pooled across every API key on the account. Extra keys don't add throughput. Every response carries quota headers, and exceeding a limit returns 429 with Retry-After.

Per-plan limits

Developer60 req/min · 10,000 req/mo
Pro600 req/min · 200,000 req/mo
Enterprise3,000 req/min · unlimited monthly

Limits are pooled per account (per subscription), not per key: every active key on the account draws from one shared budget, so minting more keys never multiplies your throughput. Use extra keys for isolation and rotation (e.g. one per environment), not capacity. You can hold up to 5 active keys per subscription; creating a 6th returns 400 until you revoke one. The minute window smooths bursts; the monthly window caps total volume (Enterprise has no monthly cap).

Quota headers

Every key-gated response includes the minute-window headers, so you can throttle proactively instead of waiting for a 429. Plans with a monthly cap (Developer, Pro) also include the -Month headers; Enterprise has no monthly cap and so omits them:

X-RateLimit-LimitRequests allowed in the current minute window.
X-RateLimit-RemainingRequests left in the current minute window.
X-RateLimit-ResetUnix seconds until the minute window resets.
X-RateLimit-Limit-MonthRequests allowed in the current calendar month. Omitted on Enterprise (no monthly cap).
X-RateLimit-Remaining-MonthRequests left this month. Omitted on Enterprise.
X-RateLimit-Reset-MonthUnix seconds until the monthly window resets. Omitted on Enterprise.

Handling 429

When you exceed either window the API returns 429 Too Many Requests with a Retry-After header (seconds to wait). Back off for that long, then retry, preferably with exponential backoff and jitter for bursts. Cache where you can: the NBBO and pricing feeds are meant to be polled at a steady cadence, not hammered.

Market Health

Market health, the one keyless endpoint, is limited separately by IP (roughly 60 requests / 60s) and returns no per-key quota headers. Every other endpoint is key-gated; see Authentication to get a key.

Usage & licensing

Access to the API and its data is governed by our Terms of Service. You may not resell or redistribute the data, use it to build a competing service, or exceed your plan’s rate limits, and you must attribute SkinPricer as the source wherever the Terms permit you to display it. Abuse may be throttled or suspended.