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
Jun 13, 2025

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
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free