UTxOs containing assets of specific policy
curl --request GET \
--url https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos \
--header 'api-key: <api-key>'import requests
url = "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos"
headers = {"api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>'}};
fetch('https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
}Asset Policy
UTxOs containing assets of specific policy
Get unspent transaction outputs containing assets from a specific Cardano minting policy with asset details.
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>'import requests
url = "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos"
headers = {"api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'api-key': '<api-key>'}};
fetch('https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos")
.header("api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://mainnet.gomaestro-api.org/v1/policy/{policy}/utxos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
Project API Key
Headers
Large numbers returned as strings if set to true
Path Parameters
Hex encoded policy ID
Query Parameters
The max number of results per page
Required range:
x >= 0The order in which the results are sorted (by slot at which UTxO was produced)
Available options:
asc, desc Return only UTxOs created on or after a specific slot
Required range:
x >= 0Return only UTxOs created before a specific slot
Required range:
x >= 0Pagination 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.
Was this page helpful?

