Skip to main content

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

Retrieves a list of all assets events associated with an account or a Contract Identifier. This includes Transfers, Mints.

Updated on
Oct 4, 2023

/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