/extended/v1/tokens/nft/holdings REST API Endpoint

Query Parameters

principal

string

REQUIRED

token owner's STX address or Smart Contract ID.

asset_identifiers

array

identifiers of the token asset classes to filter for.

limit

integer

max number of tokens to fetch.

offset

integer

index of first tokens to fetch.

unanchored

boolean

whether or not to include tokens from unconfirmed transactions.

tx_metadata

boolean

whether or not to include the complete transaction metadata instead of just tx_id. Enabling this option can affect performance and response times..

Returns

object

List of Non-Fungible Token holdings

limit

integer

The number of Non-Fungible Token holdings to return.

offset

integer

The number to Non-Fungible Token holdings to skip (starting at 0).

total

integer

The number of Non-Fungible Token holdings available.

results

array

An array of Non-Fungible Token holding objects.

asset_identifier

string

The identifier of the Non-Fungible Token asset.

value

object

The value object representing the Non-Fungible Token identifier.

hex

string

Hex string representing the identifier of the Non-Fungible Token.

repr

string

Readable string of the Non-Fungible Token identifier.

block_height

integer

The block height associated with the Non-Fungible Token holding.

tx_id

string

The transaction ID associated with the Non-Fungible Token holding.

Request

1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/tokens/nft/holdings?principal=SPNWZ5V2TPWGQGVDR6T7B6RQ4XMGZ4PXTEE0VQ0S.marketplace-v3' \
3
    -H 'Content-Type: application/json'

Don't have an account yet?

Create your QuickNode endpoint in seconds and start building

Get started for free