Get non-fungible token holdings

Retrieves a list of non-fungible tokens owned by the given principal (STX address or smart contract ID).

GET

Parameters

Query Parameters

principal
REQUIRED
string
asset_identifiers
array
limit
integer max number of tokens to fetch
offset
integer index of first tokens to fetch
tx_metadata
REQUIRED
boolean whether or not to include the complete transaction metadata instead of just `tx_id`. Enabling this option can affect performance and response times.
Status codeDescription
200List of Non-Fungible Token holdings
4XXDefault Response
cURL
curl -L \

  "https://api.hiro.so/extended/v1/tokens/nft/holdings?principal={principal}&asset_identifiers={asset_identifiers}&limit={limit}&offset={offset}&tx_metadata={tx_metadata}" \

  -H 'Accept: application/json'
Response
{

  "limit": 20,

  "offset": 0,

  "total": 1,

  "results": [

    {

      "asset_identifier": "string",

      "value": {

        "hex": "0x1234",

        "repr": "value representation"

      },

      "block_height": 144000,

      "tx_id": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"

    }

  ]

}

How is this guide?