Cregis Developer Docs
POST/openapi/v1/wallet_address_balance

查询地址余额

查询钱包地址余额，支持按地址、区块链 ID、代币编号、余额范围和分页参数筛选。

频率限制： 1000 次/分钟

请求

请求头

  • Access-Keystringrequired

    API Key 标识，用于标识调用方身份

  • Access-Timestampinteger<int64>required

    Unix 毫秒时间戳

  • Access-Noncestringrequired

    随机字符串，用于防止请求重放

  • Access-Signaturestringrequired

    使用 Access Secret 计算得到的请求签名

请求体

required

application/json
  • wallet_idinteger<int64>required

    你要查询的钱包 ID，请前往「Cregis 客户端 > 钱包 > 设置」查看

  • page_numinteger<int32>

    分页页数，如果不填，默认为 1

  • page_sizeinteger<int32>

    分页每页数量，如果不填默认为 10，限制最大值为 100

  • addressstring

    查询的钱包地址。

  • chain_idstring

    区块链 ID。不传则查询地址中所有有余额的网络代币。

  • token_idstring

    代币编号。不传则查询地址中所有有余额的网络代币。

  • maximum_balancestring

    查询地址最大可用余额，包含该值。

  • minimum_balancestring

    查询地址最小可用余额，包含该值。

响应

200成功
application/json
  • codestring

    返回码

  • msgstring

    返回信息

  • dataobject

    返回数据

    • totalinteger<int64>

      总记录数

    • page_numinteger<int32>

      当前页码

    • page_sizeinteger<int32>

      每页条数

    • rowsarray

      地址余额列表

      数组元素

      • addressstring

        查询的地址

      • chain_idstring

        区块链 ID

      • token_idstring

        代币编号

      • totalstring

        总余额（可用 + 处理中）

      • availablestring

        可用余额

      • processingstring

        处理中余额