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

Path Parameters

principal

string

REQUIRED

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

Query Parameters

limit

integer

max number of account assets to fetch.

offset

integer

index of first account assets to fetch.

unanchored

boolean

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

until_block

string

returned data representing the state at that point in time, rather than the current block. Note - Use either of the query parameters but not both at a time.

Returns

object

GET request that returns address assets

limit

integer

The maximum number of assets to be returned in the response

offset

integer

It is used for pagination purposes

total

integer

The total count of assets associated with the specified principal

results

array

An array of assets associated with the principal

event_index

integer

The index or position of the asset in the list of assets for the principal

event_type

string

The type of event associated with the asset

tx_id

string

The unique transaction ID associated with the asset event

contract_log

object

An array that contains contains additional information or data related to the asset event

contract_id

string

The identifier of the smart contract associated with the asset event

topic

string

A specific topic associated with the asset event

value

object

The value associated with the asset event

hex

string

The value of the asset event in hexadecimal format

repr

string

The description of the asset event

Request

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