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
    }
  }
}

响应字段

字段类型描述
planstring当前档位:starter / growth / pro / whale
limits.max_tpsnumber当前套餐的每秒最大交易数
limits.min_tip_bpnumber单笔交易最低 Tip(单位:Bolt Points)
usage.bolt_pointsnumber通过 Tip 累计获得的 Bolt Points 总量
next_tierobject | null下一档位信息;若已是最高档位(巨鲸),则为 null
next_tier.threshold_bpnumber升级到下一档位所需的 Bolt Points
next_tier.progress_percentnumber升级进度(0 - 100)

在机器人中自动调整 Tip 金额

通过该端点读取套餐的最低 Tip 要求,并据此设置交易 Tip。档位升级后最低 Tip 会自动降低 —— 建议定期轮询(例如每小时一次)以实时掌握当前最低值。