Limits & access
Plan limits, history and usage rights.
Account-wide limits
REST and MCP share account rate, concurrency and UTC daily credit accounting. X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset describe the per-minute request allowance. X-Credits-Limit, X-Credits-Remaining and X-Credits-Cost report the daily credit allowance, what is left after the request, and what the request spent. These headers are omitted for unlimited entitlements.
Every limit applies to the whole account across all of its API keys. The daily credit allowance is a hard cap: a request that costs more than the credits left returns 429 with the daily-credit-limit error until 00:00 UTC, and Retry-After gives the seconds until that reset. REST and MCP draw from the same allowance. Per-minute and concurrency limits count requests, not credits, and also return 429; follow Retry-After before retrying.
Credits per request
Each request spends credits by endpoint. Per-symbol endpoints charge for every distinct symbol, instrument ID or company ID in the request, and each page is a separate request. Whole-market reads without symbols, exports and flat-file downloads cost 500. Failed requests (4xx and 5xx) and 304 Not Modified responses are refunded, so revalidating with If-None-Match is free. MCP tool calls cost what their REST endpoint costs; MCP setup, tool discovery and get_api_documentation are free. GET /v1/usage reports today's balance without spending credits.
| Endpoint | Credits |
|---|---|
GET /v1/analyst-ratings | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/analytics/risk | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/bars | 5 credits per symbol, 25 per symbol for intraday intervals. |
GET /v1/bonds | 5 credits per request. |
GET /v1/bonds/yields | 5 credits per symbol. |
GET /v1/calendar | 5 credits per request. |
GET /v1/companies | 5 credits per request. |
GET /v1/companies/{id} | 5 credits per request. |
GET /v1/conditions | 5 credits per request. |
GET /v1/congressional-trades | 5 credits per request. |
GET /v1/corporate-actions | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/crypto/assets | 5 credits per request. |
GET /v1/datasets | 5 credits per request. |
GET /v1/datasets/{dataset}/coverage | 5 credits per request. |
GET /v1/dividends | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/earnings | 5 credits per request. |
GET /v1/economic/events | 5 credits per request. |
GET /v1/economic/observations | 5 credits per series. |
GET /v1/economic/series | 5 credits per request. |
GET /v1/economic/sovereign-ratings | 5 credits per request. |
GET /v1/eod | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/estimates | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/exchanges | 5 credits per request. |
POST /v1/exports | 500 credits per request. |
GET /v1/exports/{id} | Free. |
GET /v1/filings | 50 credits per request. |
GET /v1/filings/{filing_id}/exhibits | 50 credits per request. |
GET /v1/filings/{filing_id}/sections | 50 credits per request. |
GET /v1/financials/concepts | 5 credits per request. |
GET /v1/financials/facts | 50 credits per symbol. |
GET /v1/financials/metric-definitions | 5 credits per request. |
GET /v1/financials/metrics | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/financials/segments | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/financials/statements | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/flat-files | 5 credits per request. |
GET /v1/flat-files/{dataset}/{date} | 5 credits per request; 500 credits to download the file. |
GET /v1/funds | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/funds/{instrument_id}/allocations | 50 credits per request. |
GET /v1/funds/{instrument_id}/holdings | 50 credits per request. |
GET /v1/health | Free. |
GET /v1/indicators | 25 credits per symbol. |
GET /v1/indicators/definitions | 5 credits per request. |
GET /v1/indices | 5 credits per request. |
GET /v1/indices/{instrument_id}/constituents | 50 credits per request. |
GET /v1/insider-transactions | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/instruments | 5 credits per request. |
GET /v1/instruments/{id} | 5 credits per request. |
GET /v1/instruments/{instrument_id}/events | 5 credits per request. |
GET /v1/instruments/{instrument_id}/identifiers | 5 credits per request. |
GET /v1/instruments/{instrument_id}/symbols | 5 credits per request. |
GET /v1/intraday | 25 credits per symbol. |
GET /v1/ipos | 5 credits per request. |
GET /v1/market-status | 5 credits per request. |
GET /v1/movers | 25 credits per request. |
GET /v1/news | 25 credits per request. |
GET /v1/news/{id} | 5 credits per request. |
GET /v1/news/sentiment | 25 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/options/bars | 50 credits per request. |
GET /v1/options/contracts | 50 credits per request. |
GET /v1/options/contracts/{id} | 50 credits per request. |
GET /v1/options/quotes | 50 credits per request. |
GET /v1/ownership | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/quotes | 5 credits per symbol. |
GET /v1/ratings/esg | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/sanctions | 5 credits per request. |
POST /v1/screener | 25 credits per request. |
GET /v1/securities | 5 credits per request. |
GET /v1/share-statistics | 50 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/short-interest | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/short-volume | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/snapshot | 5 credits per symbol. |
GET /v1/splits | 5 credits per symbol; 500 credits without symbols (whole market). |
GET /v1/symbols/search | 5 credits per request. |
GET /v1/ticker-types | 5 credits per request. |
GET /v1/tickers | 5 credits per request. |
GET /v1/trades | 50 credits per symbol. |
GET /v1/usage | Free. |
Effective access
Plan, key capability, market and symbol restrictions all apply. Free accounts are restricted to AAPL, NVDA, JNJ, PEP, MSFT, SPY and QQQ. History depth is enforced on delivery. Export requires bulk.download plus the chosen dataset capability; streaming requires websocket.subscribe and quotes access.
Missing permissions fail closed. Datasets marked Not yet available return 501 dataset-unavailable on every plan until a source is connected.
Plan comparison