Maestro Docs

Native asset addresses

curl --request GET \
  --url https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses', 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/assets/{asset}/addresses",
  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/assets/{asset}/addresses"

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

}

require 'uri'
require 'net/http'

url = URI("https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses")

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": [
    {
      "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy",
      "amount": 100000000000000
    },
    {
      "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8",
      "amount": 320000000000000
    }
  ],
  "last_updated": {
    "timestamp": "2022-10-10 20:25:28",
    "block_hash": "c0d2cf4d7e0e9dfbfda2e09330a8aa2dd426a0d9c2d927ea28e43aa0b6550f8f",
    "block_slot": 32266746
  },
  "next_cursor": null
}

GET

/

assets

/

{asset}

/

addresses

Native asset addresses

curl --request GET \
  --url https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

fetch('https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses', 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/assets/{asset}/addresses",
  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/assets/{asset}/addresses"

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

}

require 'uri'
require 'net/http'

url = URI("https://mainnet.gomaestro-api.org/v1/assets/{asset}/addresses")

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": [
    {
      "address": "addr_test1vpxa84r650wsmcm887kkwar5y7ek5yyrjvgfqd8a608s2vsdnutyy",
      "amount": 100000000000000
    },
    {
      "address": "addr_test1vrjpwhg7vlhck0ph5q0dpnkqferx3ltf0aqvy4qzn9m5v2gcvqhm8",
      "amount": 320000000000000
    }
  ],
  "last_updated": {
    "timestamp": "2022-10-10 20:25:28",
    "block_hash": "c0d2cf4d7e0e9dfbfda2e09330a8aa2dd426a0d9c2d927ea28e43aa0b6550f8f",
    "block_slot": 32266746
  },
  "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

count

integer | null

default:100

The max number of results per page

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 addresses holding the specified asset, paired with the amounts of the asset owned

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

Show child attributes

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.

Show child attributes

next_cursor

string | null

Pagination cursor