Account (free)
Everything here reads **your own account**, not X data — and none of it costs credits. Same X-API-Key header as the rest of the API, so an agent or a cron job can check its own balance without a dashboard login.
/v1/usage is the one most people want: balance, plus calls and spend for today and the last 30 days. /v1/deposit/balance returns just the number if that is all you need.
/v1/analytics goes further — per-day and per-endpoint breakdowns, success rate, p50/p95 latency, and a **runway estimate**: how many days your balance lasts at the current burn rate, counting both API spend and any live-stream subscriptions. Worth calling before a long batch job so you find out in advance rather than halfway through a 402.
/v1/logs returns recent calls with status, latency and credits charged — useful for debugging a client without adding logging to it. /v1/stream/subscriptions lists which accounts you are monitoring and what that costs per day.
You rarely need to poll any of these: every billed response already carries x-credits-used and x-credits-remaining headers.
Balance & Usage
Your credit balance, plus calls and spend for today and the last 30 days. Free — not billed.
{ "status": "success", "data": {
"balance_credits": "1250000",
"today": { "calls": 42, "credits_spent": "3360" },
"month": { "calls": 1180, "credits_spent": "94400" },
"bonus_progress": { "cumulative_usd": "260.00", "current_pct": 3 }
} }Usage Analytics
Per-day and per-endpoint usage, success rate, p50/p95 latency, and how many days your balance lasts at the current burn rate. Free.
{ "status": "success", "data": {
"window_days": 14,
"health": { "calls": 1180, "ok": 1174, "success_rate": 0.995, "p50_ms": 304 },
"runway": { "burn_daily_credits": 6742, "days_left": 185.4 }
} }Request Log
Your recent calls with endpoint, status, latency and credits charged — debug a client without leaving your terminal. Free.
{ "status": "success", "data": [
{ "endpoint": "user/last_tweets", "status": 200,
"credits": "80", "latency_ms": 13 }
], "meta": { "count": 50 } }API Keys
Your keys with labels, creation and last-used time. Key values are stored hashed and never returned — only metadata. Free.
{ "status": "success", "data": { "keys": [
{ "label": "production", "created_at": "2026-09-01",
"last_used": "2026-09-16" } ] }, "meta": { "count": 1 } }Stream Subscriptions
Which accounts you are monitoring, how many are active versus paused, the daily cost, and how long your balance covers it. Free.
{ "status": "success", "data": {
"active_count": 12, "paused_count": 0,
"cost_per_day": "3996", "days_left": 312.8
} }Credit Balance
Just the balance — the smallest call for a balance check. Free.
{ "status": "success", "data": { "balance_credits": "1250000" } }