API 参考
账户信息
通过程序化接口查询当前套餐、用量和自动升级进度。
GET
/v1/account概述
该端点返回你当前的套餐档位、TPS 限制、所需 Tip 金额,以及升级到下一档位的进度。非常适合需要监控账户状态,或按档位门槛动态调整 Tip 金额的机器人使用。
关于 Bolt Points (BP)
Bolt Points 是用于衡量套餐档位和升级进度的单位。每笔交易会根据 Tip 金额累计 BP。达到 BP 门槛后会自动解锁更高档位,享受更优费率和更高 TPS。
请求
curl 'https://bolttx.io/v1/account?api-key=YOUR_API_KEY'响应
示例
{
"plan": "growth",
"plan_upgraded_at": "2026-04-15T12:34:56",
"member_since": "2026-04-01T09:00:00",
"limits": {
"max_tps": 30,
"min_tip_bp": 5
},
"usage": {
"bolt_points": 235000,
"transactions_total": 125432,
"transactions_today": 1234
},
"next_tier": {
"plan": "pro",
"threshold_bp": 800000,
"remaining_bp": 565000,
"progress_percent": 29.4,
"benefits": {
"new_max_tps": 80,
"new_tip_bp": 3,
"tip_savings_percent": 40
}
}
}响应字段
| 字段 | 类型 | 描述 |
|---|---|---|
| plan | string | 当前档位:starter / growth / pro / whale |
| limits.max_tps | number | 当前套餐的每秒最大交易数 |
| limits.min_tip_bp | number | 单笔交易最低 Tip(单位:Bolt Points) |
| usage.bolt_points | number | 通过 Tip 累计获得的 Bolt Points 总量 |
| next_tier | object | null | 下一档位信息;若已是最高档位(巨鲸),则为 null |
| next_tier.threshold_bp | number | 升级到下一档位所需的 Bolt Points |
| next_tier.progress_percent | number | 升级进度(0 - 100) |
在机器人中自动调整 Tip 金额
通过该端点读取套餐的最低 Tip 要求,并据此设置交易 Tip。档位升级后最低 Tip 会自动降低 —— 建议定期轮询(例如每小时一次)以实时掌握当前最低值。