跳到正文

API

本页内容

获取

查询可用代币余额:按币种而非来源网络读取金额,并在创建转出前使用该结果。

GET/v1/balances

API 密钥: Payout

返回商户的可用余额,按币种给出单一总额,跨所有网络求和——每种资产一条记录。余额不绑定网络;只有在创建转出时才选择网络。净额为零的余额会被省略。密钥的环境决定数据集:sandbox 密钥返回 sandbox 余额,live 密钥返回正式余额。

响应(200 OK)

[
  { "currency": "USDT", "available": "1750.50" },
  { "currency": "USDC", "available": "500.00" }
]

响应字段

响应是一个数组,每个币种一条记录——跨所有网络的总额。

字段 类型 说明
currency string 代币符号——如 USDTUSDCDAI
available string 以代币自身单位表示的可用余额,跨所有网络合计,以十进制字符串表示(点分隔符)

错误

余额接口需要 Payout(rk_)密钥——Payment 密钥会以 403 payout_key_required 被拒绝。完整目录见错误码。每个错误响应中的 type URI 会深链到对应的行。