Cregis Developer Docs
POST/api/v2/sub_address_balance

Query Sub-address Balances (v2)

Query sub-address balances for a WaaS project. Supports filtering by address, currency, balance range, and pagination parameters.

Rate limit: 1000 requests/minute

Request

Request Body

required

application/json
  • noncestringrequired

    6-character random string.

  • timestampinteger<int64>required

    Timestamp, in milliseconds.

  • signstringrequired

    Signature.

  • pidinteger<int64>required

    WaaS project ID. You can find it in Cregis portal > WaaS Project > Settings.

  • addressstringrequired

    Queried address.

  • currencystring

    Token information in chain_id@token_id format.

  • maximum_balancestring

    Maximum address balance to query, inclusive.

  • minimum_balancestring

    Minimum address balance to query, inclusive.

  • page_numinteger<int32>

    Page number. Defaults to 1 if omitted.

  • page_sizeinteger<int32>
    default: 10

    Number of records per page. Defaults to 10 if omitted. Maximum value is 100.

Responses

200Success
application/json
  • codestring

    Response code.

  • msgstring

    Response message.

  • dataobject

    Response data.

    • totalinteger<int64>

      Total number of records.

    • rowsarray<object>

      Address balance list.

      Array items · object

      • addressstring

        Queried address.

      • chain_idstring

        Blockchain ID.

      • token_idstring

        Token ID.

      • totalstring

        Total balance (available + processing).

      • availablestring

        Available balance.

      • processingstring

        Processing balance.

    • page_numinteger<int32>

      Current page number.

    • page_sizeinteger<int32>

      Number of records per page.