余额与充值

余额

GET /v1/balance：

{
  "balance_usdt": "464.00",
  "daily_spend_limit_usdt": "1000.00",
  "available_today_usdt": "464.00",
  "low_balance_alert_usdt": "50.00"
}

• available_today_usdt — 在 UTC 00:00（莫斯科时间 03:00）之前还能花费的金额：取余额与当日消费限额剩余部分中的较小值。
• low_balance_alert_usdt — 余额低于该金额时发出提醒：向合作伙伴账户的所有者发送 Telegram 消息（未绑定 Telegram 时发送邮件），并推送 balance.low 事件。只在余额跌破阈值时提醒一次，而不是每笔订单都提醒。设置：调用 PATCH /v1/balance，传入 {"low_balance_alert_usdt": "50.00"}；取消：传入 null。

余额流水

GET /v1/balance/history?date=2026-09-28 — 返回 UTC 当日的操作记录，最新的在前（不带 date 即为当天）。操作类型 type：top_up 为充值（附带网络和 tx_hash），order 为订单付款，refund 为退款，correction 为调整，withdrawal 为提取余额。每笔操作也会以 balance.updated 事件推送。

充值地址

GET /v1/balance/top-up-addresses — 每个网络一个地址；token_contract 是下表中的 USDT 合约：

{
  "addresses": [
    {"network": "bsc", "address": "0x5c1d…a93e", "token": "USDT", "token_contract": "0x55d3…7955"},
    {"network": "ton", "address": "UQD2…r8Kq", "token": "USDT", "token_contract": "EQCx…_sDs"},
    {"network": "tron", "address": "TWk3…9fUe", "token": "USDT", "token_contract": "TR7N…Lj6t"}
  ]
}

在 TON 中转账无需填写备注（memo）：该地址为您专属。

充值规则

• 地址只能从 GET /v1/balance/top-up-addresses 或账户中的「集成」页面获取。 不要从聊天记录中复制地址：聊天中的地址可能被人调包。只会提供当前可用的地址。
• 地址在接入时签发，每个网络一个，签发后立即可用。 如果我们更换地址，会通过 Telegram 或邮件通知您；转到旧地址的款项不会丢失，核对后会人工入账。
• 请在地址所属的网络中转账。 BSC 地址只接收 BSC 网络的 USDT，TON 地址只接收 TON 网络的 USDT，TRON 地址只接收 TRON 网络的 USDT。在其他 EVM 网络（Ethereum、Arbitrum、Polygon…）中转到 BSC 地址的款项不会自动入账，但资金并未丢失：请联系我们，核对后会人工入账。
• 只认下表中的合约。 名称相似的代币（「USDT0」「USDT.e」、其他合约上的「Tether」）不是 USDT：此类转账既不入账，也不退回。
• 网络手续费和交易所手续费由转出方承担：入账金额以实际到达地址的金额为准。款项到账之后由我们负责：跨网络调拨的手续费由我们承担。
• 经网络确认后入账（BSC：大约 1 分钟后、TON：2–3 分钟后、TRON：3–4 分钟后），随后生成 top_up 操作并推送 balance.updated 事件。

网络与合约