Asset Holdings

• getGetBalancesByAddress
• getGetHoldersByDenom

API docs by Redocly

Blockchain Integration Data Provenance Apis Enhanced Provenance Apis Asset Holdings (v1.0.0)

Download OpenAPI specification:Download

NUVA Labs: inbound@nuvalabs.com URL: https://nuvalabs.com/ License: Apache 2.0 Terms of Service

API Documentation for Blockchain Integration Data Provenance Apis Enhanced Provenance Apis Asset Holdings

GetBalancesByAddress

Returns all token balances for a specific address.

Authorizations:

bearerAuth

path Parameters

address required

string (address) The address to retrieve balances for.

query Parameters

showZeroBalance	boolean (show_zero_balance) If true, includes denoms that currently have a balance of zero. This is useful for determining which tokens an address previously held but no longer holds.
pagination.cursor	string (cursor) A base64-encoded string representing the position in the dataset from which to start fetching results. This is typically the 'next_cursor' value returned from a previous response.
pagination.pageSize	integer <int32> (page_size) The number of records to return in this page. If not specified, a default will be used.

Responses

NUVA Labs API Server

https://api.provlabs.com/v1/asset/balances/{address}

Response samples

• 200

Content type

application/json

{

• "balances": [

  • {

    • "denom": "string",
    • "amount": "string",
    • "lastestBlockHeight": 0,
    • "lastestBlockTime": "2023-01-15T01:30:15.01Z",
    • "lastestTxHash": "string",
    • "firstBlockHeight": 0,
    • "firstBlockTime": "2023-01-15T01:30:15.01Z",
    • "firstTxHash": "string"

    }

  ],
• "queryBlockHeight": 0,
• "queryBlockTime": "2023-01-15T01:30:15.01Z",
• "pagination": {

  • "nextCursor": "string",
  • "hasMore": true,
  • "dataAccessInfo": {

    • "tier": "string",
    • "isLimited": true,
    • "info": "string"

    }

  }

}

GetHoldersByDenom

Lists addresses holding a specific token denom.

Authorizations:

bearerAuth

path Parameters

denom required

string (denom) The denomination to list holders for (e.g., nhash).

query Parameters

showZeroBalance	boolean (show_zero_balance) If true, includes addresses that currently have a balance of zero for the specified denom. This indicates the address held the denom at a previous block but no longer holds it.
pagination.cursor	string (cursor) A base64-encoded string representing the position in the dataset from which to start fetching results. This is typically the 'next_cursor' value returned from a previous response.
pagination.pageSize	integer <int32> (page_size) The number of records to return in this page. If not specified, a default will be used.

Responses

NUVA Labs API Server

https://api.provlabs.com/v1/asset/holders/{denom}

Response samples

• 200

Content type

application/json

{

• "holders": [

  • {

    • "address": "string",
    • "amount": "string",
    • "lastestBlockHeight": 0,
    • "lastestBlockTime": "2023-01-15T01:30:15.01Z",
    • "lastestTxHash": "string",
    • "firstBlockHeight": 0,
    • "firstBlockTime": "2023-01-15T01:30:15.01Z",
    • "firstTxHash": "string"

    }

  ],
• "queryBlockHeight": 0,
• "queryBlockTime": "2023-01-15T01:30:15.01Z",
• "pagination": {

  • "nextCursor": "string",
  • "hasMore": true,
  • "dataAccessInfo": {

    • "tier": "string",
    • "isLimited": true,
    • "info": "string"

    }

  }

}