/extended/v1/address/{principal}/nft_events REST API Endpoint

Path Parameters

principal

string

REQUIRED

Stacks address or a Contract identifier (e.g. SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0.get-info)

Query Parameters

limit

integer

number of items to return.

offset

integer

number of items to skip.

unanchored

boolean

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

until_block

string

returned data representing the state up until that point in time, rather than the current block..

Returns

object

array

Array of objects (NftEvent)

limit

integer

The maximum number of NFT events to be returned in the response

offset

integer

It is used for pagination purposes

total

integer

The total count of NFT events associated with the specified principal (address)

nft_events

array

An array containing the NFT events associated with the principal:

sender

string

The address of the sender who initiated the NFT event

recipient

string

The address of the recipient who received the NFT

asset_identifier

string

The identifier of the NFT asset

value

object

The additional information about the NFT identifier

hex

string

The hexadecimal value of the NFT

repr

string

The description of the NFT

tx_id

string

The unique transaction ID associated with the NFT event

block_height

integer

The block height when the NFT event occurred

Request

1
curl -X 'GET' \
2
    'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/address/SP3K8BC0PPEVCV7NZ6QSRWPQ2JE9E5B6N3PA0KBR9/nft_events' \
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