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

Documentation Index

Fetch the complete documentation index at: https://docs.gomaestro.org/llms.txt

Use this file to discover all available pages before exploring further.

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

​
policy
string
required

Hex encoded policy ID

Query Parameters

​
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<int64> | null

Return only UTxOs created on or after a specific slot

Required range: x >= 0
​
to
integer<int64> | 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 which contain assets of the given policy ID, with the asset names and amounts

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