Skip to main content

​
接入 API

POST /api/v1/sub_address_balance

​
请求

​
请求参数

名称类型是否必须描述
pidinteger(int64)是项目编号
currencystring是查询的代币标识，chain_id@token_id
addressstring否查询的子地址，不传则查询项目中所有有余额的地址
maximum_balancestring否查询地址最大余额，包含
minimum_balancestring否查询地址最小余额，包含
page_numinteger(int32)否分页页数，如果不填，默认为1
page_sizeinteger(int32)否分页每页数量，如果不填默认为10，限制最大值为100
noncestring是6位随机字符串
timestampinteger(int64)是时间戳
signstring是签名串
请求示例
{
  "pid": 1382528827416576,
  "address": "",
  "currency": "195@195",
  "minimum_balance":"1"
  "maximum_balance":"10"
  "page_num": 1,
  "page_size": 10,
  "nonce": "hwlkk6",
  "timestamp": 1688004243314,
  "sign": "d6eef2de79e39f434a38efb910213ba6"
}

​
返回

​
返回结果

名称类型描述
codestring返回码
msgstring返回信息
dataobject返回数据

​
返回数据 data 对象

名称类型描述
pidinteger(int64)项目编号
currencystring币种标识, chain_id@token_id
addressstring查询的地址
totalstring总余额（可用+处理中）
availablestring可用余额
processingstring处理中余额
返回示例
{
    "code": "00000",
    "msg": "ok",
    "data": {
        "total": 1,
        "rows": [
            {
              "pid":1395142548643840,
              "address":"TKDxZEycaxNosmH1V9x6hEacKgWF3RRZ7h",
              "currency":"198@TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs",
              "total":"7",
              "available":"7",
              "processing":"0"
            }
        ],
        "pageNum": 1,
        "pageSize": 10
    },
}