Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.alterscope.org/llms.txt

Use this file to discover all available pages before exploring further.

Tiers

TierRequests/MinuteRequests/DayNotable features
Free10100Basic yield data
Pro605,000Factor attribution, SHAP, WebSocket
Enterprise30050,000Custom limits, SLA, dedicated support
Limits apply per organization, not per key. Issuing a second key does not double your budget.

Response headers

Every successful response carries the current state of both windows:
HeaderMeaning
X-RateLimit-Limit-RPMPer-minute limit for your tier
X-RateLimit-Remaining-RPMRequests remaining this minute
X-RateLimit-Limit-RPDPer-day limit for your tier
X-RateLimit-Remaining-RPDRequests remaining today
The minute window resets on the wall clock minute. The day window resets at 00:00 UTC.

429 handling

When you exceed either window, the API returns:
HTTP/2 429 Too Many Requests
Retry-After: 30
Content-Type: application/json

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Per-minute limit reached. Retry after 30s.",
    "window": "minute"
  },
  "meta": { "request_id": "req_01HX..." }
}
The Retry-After header is in seconds. Honor it. The error.window discriminates minute from day so you can decide whether to backoff or pause for hours.
A simple exponential backoff is fine for the minute window. For the day window, throttle the producer rather than retry the request, otherwise you exhaust the quota the moment it resets.

Asking for more

Enterprise customers can negotiate per-route uplift or burst windows. Email engineering@alterscope.org with traffic shape and a target peak RPS.