账户
账户模块提供持有人信息（资料、权限、限额、费率规则）和余额。可用于验证 token、提现前确认余额，以及读取操作限额。
何时使用各 endpoint
| 问题 | Endpoint |
|---|---|
| Token 是否有效？ | GET /user |
| 账户的名称、证件、套餐和限额是什么？ | GET /user |
| 当前可用余额是多少？ | GET /user/balance |
| 我是否有足够余额完成本次提现？ | GET /user/balance |
| 有多少金额被待处理交易冻结？ | GET /user/balance |
示例
最佳实践
- 不要循环轮询余额：余额会在 callback 中变化。应响应 webhook，而不是反复调用
GET /user/balance。 - 短时缓存：对于 UI，将余额缓存 5 到 10 秒已经足够。在收到交易完成或退款 callback 时立即失效。
- 可用余额 ≠ 总余额：
available是当前可动用的金额；blocked是被进行中交易或 MED 争议冻结的金额。 /user极少变化：缓存 1 小时或更长是合理的。当客服调整限额时失效。