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
}

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 | 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

200
application/json

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.