Hiro Docs

Retrieves a list of all nft events associated with an account or a contract identifier.

GET
/extended/v1/address/{principal}/nft_events

NOTE: This endpoint is deprecated in favor of Get nft holdings.

Retrieves a list of all NFTs owned by an address and contains the Clarity value of the identifier of the NFT.

Path parameters

`principal`
Required
string

Stacks address or a contract identifier

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query parameters

`limit`integer

Number of items to return

`offset`integer

Number of items to skip

Example: 42000

`unanchored`boolean

Include transaction data from unanchored (i.e. unconfirmed) microblocks

Example: trueDefault: false

`until_block`string

Returned data representing the state up until that point in time, rather than the current block. Note: use either of the query parameters but not both at a time.

Example: 60000

Status code	Description
`200`	Success

Terminal

curl -X GET "https://api.mainnet.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/nft_events"

Example response

{
  "limit": 0,
  "offset": 0,
  "total": 0,
  "nft_events": [
    {
      "sender": "string",
      "recipient": "string",
      "asset_identifier": "string",
      "asset_event_type": "string",
      "value": {
        "hex": "string",
        "repr": "string"
      },
      "tx_id": "string",
      "tx_index": 0,
      "block_height": 0,
      "event_index": 0
    }
  ]
}

Get nft events

GET/extended/v1/address/{principal}/nft_events

Path parameters

principalRequiredstring

Query parameters

limitinteger

offsetinteger

unanchoredboolean

until_blockstring

Schema