Usage
GET /v1/usage 🔑 / session
Your plan limits and live usage.
{ "success": true, "plan": "pro",
"limits": { "per_min": 300, "per_day": 100000, "history_years": null, "credits": null },
"usage": { "minute_used": 21, "minute_remaining": 279, "day_used": 21,
"day_remaining": 99979, "credits_remaining": null } }
| Field | Meaning |
|---|---|
limits.history_years |
Your history window: 1 (Free), 10 (Developer), null = full |
limits.credits |
The plan's monthly allowance (500 on Free, null on paid plans) |
usage.minute_used |
Requests in the last 60 seconds (sliding window) |
usage.day_used |
Requests today |
usage.credits_remaining |
Free plan only: calls left this month. At 0, data requests return 402 credits_exhausted until the reset |
usage.credits_reset |
Free plan only: the date the allowance refills (the 1st of next month) |
On the Free plan, a call to /v1/usage itself counts as one call.
GET /v1/usage/history 🔑 / session
Daily request counts for the last 30 days, which feed the dashboard chart:
{ "success": true, "count": 1, "data": [ { "day": "2026-09-24", "requests": 21 } ] }