Skip to main content

Non-Fungible Token holdings

Retrieves the list of Non-Fungible Tokens owned by the given principal (STX address or Smart Contract ID). Results can be filtered by one or more asset identifiers and can include metadata about the transaction that made the principal own each token.

More information on Non-Fungible Tokens on the Stacks blockchain can be found here.

Query Parameters
principal string REQUIRED

token owner's STX address or Smart Contract ID

Example: SPNWZ5V2TPWGQGVDR6T7B6RQ4XMGZ4PXTEE0VQ0S.marketplace-v3
asset_identifiers string[]

identifiers of the token asset classes to filter for

Example: SPQZF23W7SEYBFG5JQ496NMY0G7379SRYEDREMSV.Candy::candy
limit integer

max number of tokens to fetch

offset integer

index of first tokens to fetch

Example: 42000
unanchored boolean

whether or not to include tokens from unconfirmed transactions

Example: true
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.

Responses
200

List of Non-Fungible Token holdings

Schema OPTIONAL
limit integer

Possible values: value ≤ 200

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 object[]