Skip to main content
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

Response samples

Content type
application/json
{
  • "balances": [
    ],
  • "queryBlockHeight": 0,
  • "queryBlockTime": "2023-01-15T01:30:15.01Z",
  • "pagination": {
    }
}

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

Response samples

Content type
application/json
{
  • "holders": [
    ],
  • "queryBlockHeight": 0,
  • "queryBlockTime": "2023-01-15T01:30:15.01Z",
  • "pagination": {
    }
}