Skip to main content
GET
/
assets
/
{asset}
/
utxos
Native asset UTxOs
curl --request GET \
  --url https://mainnet.gomaestro-api.org/v1/assets/{asset}/utxos \
  --header 'api-key: <api-key>'
{
  "data": [
    {
      "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404",
      "index": 0,
      "slot": 12722572,
      "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy",
      "amount": 100000000000000
    },
    {
      "tx_hash": "eeb9fb2af9c6da4a06c27c1021c4f138ec6e02857c6181cee79599dec6c96404",
      "index": 1,
      "slot": 12722572,
      "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8",
      "amount": 320000000000000
    }
  ],
  "last_updated": {
    "timestamp": "2022-10-10 20:25:28",
    "block_hash": "a819c4555f28885e8e9e90039b7dd8375bb88224414536adb2ee2615036d8d4c",
    "block_slot": 32277176
  },
  "next_cursor": null
}

Authorizations

​
api-key
string
header
required

Project API Key

Headers

​
amounts-as-strings
string | null

Large numbers returned as strings if set to true

Path Parameters

​
asset
string
required

Asset, encoded as concatenation of hex of policy ID and asset name

Query Parameters

​
address
string | null

Return only UTxOs controlled by a specific address (bech32 encoding)

​
count
integer
default:100

The max number of results per page

Required range: x >= 0
​
order
enum<string>
default:asc

The order in which the results are sorted (by slot at which UTxO was produced)

Available options:
asc,
desc
​
from
integer | null

Return only UTxOs created on or after a specific slot

Required range: x >= 0
​
to
integer | null

Return only UTxOs created before a specific slot

Required range: x >= 0
​
cursor
string | null

Pagination cursor string, use the cursor included in a page of results to fetch the next page

Response

Returns UTxOs containing the specified asset, each paired with the amount of the asset

A paginated response. Pass in the next_cursor in a subsequent request as the cursor query parameter to fetch the next page of results.

​
data
object[]
required

Endpoint response data

​
last_updated
object
required

Details of the most recent block processed by the indexer (aka chain tip); that is, the data returned is correct as of this block in time.

​
next_cursor
string | null

Pagination cursor