Credit usage
The account's daily credit allowance, credits spent since 00:00 UTC and credits remaining, shared by REST and MCP across every API key on the account, and the request limits that apply to it: requests_per_minute and concurrent_requests are account-wide, like the credits. Reading it costs no credits. limit and remaining are null for accounts without a daily limit; remaining also counts the account's unexpired welcome credits, so it can exceed limit minus used. concurrent_requests is the simultaneous-request limit that X-Concurrency-Limit reports (per key for unlimited entitlements); requests_per_minute is null when no rate limit applies.
/v1/usage- Required capability
- Authenticated API key
- Data timing
- As published by the source
- Credits
- Free.
Parameters
No query parameters. Authentication is still required.
Response fields
Returns data as an object. All example values are illustrative.
planstring · null- plan
creditsobject- credits
requests_per_minuteinteger · null- requests per minute
concurrent_requestsinteger · null- concurrent requests
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Any API key can call this endpoint.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Included | As published | Not date-bounded |
| Developer | Included | As published | Not date-bounded |
| Pro | Included | As published | Not date-bounded |
| Commercial | Included | As published | Not date-bounded |
| Scale | Included | As published | Not date-bounded |
Free requests are limited to AAPL, NVDA, JNJ, PEP, MSFT, SPY, QQQ.
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans