Get account assets

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

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

Get account assets

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

Path Parameters

principal
Required
string

Stacks address or a Contract identifier

Example: "SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0"

Query Parameters

limitinteger

max number of account assets to fetch

Example: 20

offsetinteger

index of first account assets to fetch

Example: 42000

unanchoredboolean

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

Example: trueDefault: false

until_blockstring

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.

Example: 60000
Status codeDescription
200Success
/extended/v1/address/{principal}/assets

curl -X GET "https://api.hiro.so/extended/v1/address/SP31DA6FTSJX2WGTZ69SFY11BH51NZMB0ZW97B5P0/assets?limit=20&offset=42000&unanchored=true&until_block=60000"

GET request that returns address assets

{
  "limit": 30,
  "offset": 0,
  "total": 0,
  "results": [
    {
      "event_index": 0,
      "event_type": "smart_contract_log",
      "tx_id": "string",
      "contract_log": {
        "contract_id": "string",
        "topic": "string",
        "value": {
          "hex": "string",
          "repr": "string"
        }
      }
    }
  ]
}