Docs
API文档
  • 简体中文
  • English
API文档
  • 简体中文
  • English
  • API文档

    • 统一约定
    • 入账/收款
    • 出账/代付
    • 账户余额
    • 交易查询
    • 异步通知(入账/出账)
    • 参数签名
    • 账户(Acct)说明
    • 特别说明/精度对账

账户余额

余额说明

  • 每个账户都默认会有USDT账户,加对应市场的货币。共2个账户
  • 可以下发/提现的金额 = 账户余额 - 锁定金额
  • 为了更清晰的表示数据格式。金额在这里返回的类型是字符串

余额查询

接口地址
https://{$api_host}/api/balance
请求参数
字段名变量名必填类型示例值描述
商户号merid是string10086创建分配给商户的数字号。非登录账号
资金币种cur否stringPKR货币类型。大写。如果不传递,默认返回所有货币的余额。具体类型参考自己账户信息以及“统一约定”
签名sign是stringc380bec2bfd727a4.....签名,详见签名生成算法
请求参数示例
{
  "merid": "10086",
  "cur": "USDT", 
  "sign":"c8bbeab3ffb1f0f16f4...."
}

为了更好的表示以及避免各种转换导致0.0000被“吃”掉的情况。金额返回使用的是字符串类型

返回参数说明
字段名变量名类型示例值描述
商户号meridstring10086创建分配给商户的数字号。非登录账号
货币curstringUSDT国际货币代码
账户余额balstring100.9900账户余额,保留四位。注意数据类型是字符串
锁定金额lockstring1.0000锁定金额,保留四位。注意数据类型是字符串
异常金额excptstring2.0000异常金额,保留四位 。注意数据类型是字符串

返回示例(传递cur参数)

{
  "data":{
    "merid": "10086",
    "cur": "USDT",
    "bal": "100.2000",//账户余额(不是可提现金额)
    "lock": "0.0000",
    "excpt": "0.0000"
  }
}

返回示例(没传递cur参数)

{
  "list":[
    {
      "merid": "10086",
      "cur": "USDT",
      "bal": "100.2000",//账户余额(不是可提现金额)
      "lock": "0.0000",
      "excpt": "0.0000"
    },
    {
      "merid": "10086",
      "cur": "PKR",
      "bal": "100.2000",//账户余额(不是可提现金额)
      "lock": "0.0000",
      "excpt": "0.0000"
    }
  ]
}
Prev
出账/代付
Next
交易查询