账户自查（免费）
这一组读的是**你自己的账户**，不是 X 数据，而且全部**不计费**。用的是和其它接口一样的 X-API-Key，所以 agent 或定时任务不用登录控制台就能查自己的余额。
最常用的是 /v1/usage：余额，加上今日与近 30 天的调用次数和消耗。只要一个数字的话，/v1/deposit/balance 更省事。
/v1/analytics 更进一步 —— 按天与按端点的明细、成功率、p50/p95 延迟，以及**余额还能撑几天**（同时算上 API 消耗与实时流订阅的固定日耗）。跑大批量任务前调一次，能提前知道够不够，而不是跑到一半撞上 402。
/v1/logs 返回最近调用的状态码、延迟与扣费，排查客户端问题时不用另加日志；/v1/stream/subscriptions 列出你在监控哪些账号、每天花多少。
多数情况下并不需要轮询这些接口：每个计费响应本身就带着 x-credits-used 与 x-credits-remaining 响应头。
GET/v1/usage
余额与用量
你的信用点余额，以及今日与近 30 天的调用次数和消耗。免费，不计费。
响应
200 OKhttps://socialapi.tech/v1/usage
{ "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 }
} }GET/v1/analytics
用量分析
按天与按端点的用量、成功率、p50/p95 延迟，以及按当前消耗速度余额还能撑几天。免费。
参数
daysint可选统计窗口天数，1-90（默认 14）
响应
200 OKhttps://socialapi.tech/v1/analytics
{ "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 }
} }GET/v1/logs
调用日志
最近的调用记录：端点、状态码、延迟、扣费。不用离开终端就能排查客户端问题。免费。
参数
limitint可选返回条数（默认 50）
响应
200 OKhttps://socialapi.tech/v1/logs
{ "status": "success", "data": [
{ "endpoint": "user/last_tweets", "status": 200,
"credits": "80", "latency_ms": 13 }
], "meta": { "count": 50 } }GET/v1/keys
API 密钥
你的密钥列表：备注、创建时间、最后使用时间。密钥本身以哈希存储、永不回传，只返回元信息。免费。
响应
200 OKhttps://socialapi.tech/v1/keys
{ "status": "success", "data": { "keys": [
{ "label": "production", "created_at": "2026-09-01",
"last_used": "2026-09-16" } ] }, "meta": { "count": 1 } }GET/v1/stream/subscriptions
监控订阅
你正在监控哪些账号、活跃与暂停各多少、每天花多少、余额还能撑多久。免费。
响应
200 OKhttps://socialapi.tech/v1/stream/subscriptions
{ "status": "success", "data": {
"active_count": 12, "paused_count": 0,
"cost_per_day": "3996", "days_left": 312.8
} }GET/v1/deposit/balance
信用点余额
只返回余额 —— 查余额时开销最小的调用。免费。
响应
200 OKhttps://socialapi.tech/v1/deposit/balance
{ "status": "success", "data": { "balance_credits": "1250000" } }