Rate Limits & Plans
Your StatAlpha plan controls three things:
- which surfaces you can use: web console, API, or both
- how much historical data you can query
- how many requests you can make per minute and per day
Your access and limits
Section titled “Your access and limits”Your account’s current plan determines web and API access, available history, and request limits. Limits and entitlements can vary by account and may change. Check My account or /me and /me/usage for your effective access and usage. Contact support if the information is unclear.
When a request limit is exceeded, the API returns 429. If your history allowance is limited, data outside the permitted window may be restricted or the requested range adjusted where supported.
Check Remaining Usage
Section titled “Check Remaining Usage”curl -s \ -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://api.statalpha.io/me/usage"The response includes your current account details and rate-limit usage.
Examples
Section titled “Examples”Web users can run analytics from:
https://app.statalpha.ioAPI users can call the same analytics through the API:
curl -s \ -H "Authorization: Bearer $ACCESS_TOKEN" \ "https://api.statalpha.io/stats/gap/summary?symbol=AAPL&time_window=12M"If your account is web-only and you call the API directly with an access token, the API returns 403.