Skip to main content
POST
/
addresses
/
utxos
UTxOs by multiple addresses
curl --request POST \
  --url https://mainnet.gomaestro-api.org/v1/addresses/utxos \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
[
  "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
  "addr_test1wplyjq2gqaufjt6uux6g9ax9s7mcc50rm3f8zgsmquknggce4mde8"
]
'
{
  "data": [
    {
      "tx_hash": "21d0ff7e2b5d8988ff999f404668aff3f72f9e7a7de5eaa3740cb306f3024ca9",
      "index": 0,
      "slot": 20648797,
      "assets": [
        {
          "unit": "lovelace",
          "amount": 20000000
        }
      ],
      "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
      "datum": null,
      "reference_script": {
        "hash": "d465557fc0471f4243863a085f42aaf998dbc231c0b3cdf68633354b",
        "type": "plutusv2",
        "bytes": "5910630100003....10030021120011",
        "json": null
      },
      "txout_cbor": null
    },
    {
      "tx_hash": "b2054dc932454372808972d92e46e6725d57438d9095cb77010a12aa843b5e01",
      "index": 1,
      "slot": 21610369,
      "assets": [
        {
          "unit": "lovelace",
          "amount": 2000000
        },
        {
          "unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4f7261636c6546656564",
          "amount": 1
        }
      ],
      "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
      "datum": {
        "type": "inline",
        "hash": "b908508e84bd37060d4515eb25a43396610a4d6ce363a89ff802f40a7f0a1729",
        "bytes": "d8799fd87b9fa3001a000593e9011b00000186867c6928021b00000186868a24c8ffff",
        "json": {
          "fields": [
            {
              "constructor": 2,
              "fields": [
                {
                  "map": [
                    {
                      "k": {
                        "int": 0
                      },
                      "v": {
                        "int": 365545
                      }
                    },
                    {
                      "k": {
                        "int": 1
                      },
                      "v": {
                        "int": 1677293545768
                      }
                    },
                    {
                      "k": {
                        "int": 2
                      },
                      "v": {
                        "int": 1677294445768
                      }
                    }
                  ]
                }
              ]
            }
          ]
        }
      },
      "reference_script": null,
      "txout_cbor": null
    },
    {
      "tx_hash": "45c205a85aa13b2bb8677675937deac2d19ac6fccf84905d845e1ca9df62bac3",
      "index": 0,
      "slot": 21610637,
      "assets": [
        {
          "unit": "lovelace",
          "amount": 3000000
        },
        {
          "unit": "436941ead56c61dbf9b92b5f566f7d5b9cac08f8c957f28f0bd60d4b5041594d454e54544f4b454e",
          "amount": 850860
        },
        {
          "unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4167675374617465",
          "amount": 1
        }
      ],
      "address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
      "datum": {
        "type": "inline",
        "hash": "83115d854808011060dff35ab238823b693250e7a089386cfbd422ce55f50e76",
        "bytes": "d87b9fd8799fd879....6dffffffff",
        "json": {
          "constructor": 2,
          "fields": [
            {
              "constructor": 0,
              "fields": [
                {
                  "constructor": 0,
                  "fields": [
                    {
                      "list": [
                        {
                          "bytes": "007df380aef26e44739db3f4fe67d8137446e630dab3df16d9fbddc5"
                        },
                        {
                          "bytes": "cef7fb5f89a9c76a65acdd746d9e84104d6f824d7dc44f427fcaa1dd"
                        },
                        {
                          "bytes": "4ad1571e7df63d4d6c49240c8372eb639f57c0ef669338c0d752f29b"
                        },
                        {
                          "bytes": "f6f69e5af37c2978cb2124c12202f2185fd5c14ee93bb832911daf8e"
                        },
                        {
                          "bytes": "2d7103fdaf4beecbbef37edc6d24d311230f2836d0af791e3a6364d2"
                        }
                      ]
                    },
                    {
                      "int": 7500
                    },
                    {
                      "int": 900000
                    },
                    {
                      "int": 900000
                    },
                    {
                      "int": 200
                    },
                    {
                      "constructor": 0,
                      "fields": [
                        {
                          "int": 20
                        }
                      ]
                    },
                    {
                      "int": 20000
                    },
                    {
                      "int": 1500
                    },
                    {
                      "list": [
                        {
                          "bytes": "496e6469676f4f7261636c65446174756d"
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      },
      "reference_script": null,
      "txout_cbor": null
    }
  ],
  "last_updated": {
    "timestamp": "2022-10-10 20:25:28",
    "block_hash": "2d6b15048692aca81cc6dbd9234360ed6163e838fcf9d9f1a9e8dc67e0779f82",
    "block_slot": 32266164
  },
  "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

Query Parameters

​
resolve_datums
boolean | null

Try find and include the corresponding datums for datum hashes

​
with_cbor
boolean | null

Include the CBOR encodings of the transaction outputs in the response

​
count
integer
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

Body

application/json

Response

Get all unspent transaction outputs residing at any address in a list

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