Skip to main content
Version: v1.7.0

Blockchain Indexer

The Maestro Blockchain Indexer API enables Cardano Dapp developers to retrieve on-chain data and submit transactions to the network. Learn more about how the REST API works or checkout out the API Reference for a complete list of supported endpoints.

This page will deep dive into a couple of API examples from each endpoint category.

info

General

Chain tip details

GET /chain-tip

This endpoint can be used to retrieve details about the latest block of the network.

Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/chain-tip
Response
{
"data": {
"block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a",
"slot": 32284578,
"height": 1102039
},
"last_updated": {
"block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a",
"block_slot": 32284578
}
}
info

Response details

  • block_hash: block hash of the most recent block
  • slot: absolute slot of the most recent block
  • height: height (number) of the most recent block

Accounts

Accounts endpoints retrieve details about stake addresses and their corresponding addresses, transactions, UTxOs and assets.

Stake account updates

GET /accounts/{stake_address}/updates

This endpoint returns a list of updates relating to the specified stake_address. The update types can be one of the following: registration, deregistration, delegation, withdrawal.

ParametersDescriptionExample
stake_addressBech32 encoded stake addressstake1u9w504hwl7sv6ewe72kxx45pzs37zq4qr4tvfqj3n2rqzvseuxpcf
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/accounts/stake1u9w504hwl7sv6ewe72kxx45pzs37zq4qr4tvfqj3n2rqzvseuxpcf/updates?count=20&page=3
Response
{
"data": [
{
"action": "registration",
"tx_hash": "742027b81f397f3d65fb550b6848374ade42eaced7cb44267d49c91b718356f0",
"epoch_no": 28,
"abs_slot": 10634504
},
{
"action": "delegation",
"tx_hash": "34c6ff27230dd58c0e647e8b21855b8e022d2cd18c71ea54f2252ee2a39a8eac",
"epoch_no": 28,
"abs_slot": 10634943
}
],
"last_updated": {
"block_hash": "749cc29f4a0fcf852246505782bd895ef5b736f2ef24f7425e54593a6df7c1cb",
"block_slot": 32265440
},
"next_cursor": null
}
info

Response details

  • action: action taken to update the state of the stake pool
  • tx_hash: transaction action of the stake pool
  • epoch_no: epoch of the stake pool update
  • abs_slot: absolute slot of the stake pool update

Addresses

Addresses endpoints retrieve details about addresses and their corresponding transactions, UTxOs and assets.

Decoded receiving address information

POST /addresses/{address}/decode

This endpoint can be used to retrieve the attributes of a decoded receiving address.

ParametersDescriptionExample
addressBech32 encoded addressaddr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm
Request
curl -X 'GET' \
'https://mainnet.gomaestro-api.org/v1/addresses/addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm/decode' \
-H 'accept: application/json'
Response
{
"bech32": "addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm",
"hex": "119068a7a3f008803edac87af1619860f2cdcde40c26987325ace138ad81728e7ed4cf324e1323135e7e6d931f01e30792d9cdf17129cb806d",
"network": "mainnet",
"payment_cred": {
"kind": "script",
"bech32": "addr_shared_vkh1jp520glspzqrakkg0tckrxrq7txumeqvy6v8xfdvuyu26qqv5qn",
"hex": "9068a7a3f008803edac87af1619860f2cdcde40c26987325ace138ad"
},
"staking_cred": {
"kind": "key",
"bech32": "stake_vkh1s9egulk5eueyuyerzd08umvnruq7xpujm8xlzuffewqx6s0mg9v",
"reward_address": "stake1uxqh9rn76n8nynsnyvf4ulndjv0srcc8jtvumut3989cqmgjt49h6",
"hex": "81728e7ed4cf324e1323135e7e6d931f01e30792d9cdf17129cb806d",
"pointer": null
}
}
info

Response details

  • bech32: queried address
  • hex: hex encoded queried address
  • network: network for this address
  • payment_cred: payment credentials for this address
  • staking_cred: staking credentials for this address

UTxOs at multiple addresses

POST /addresses/utxos

This endpoint can be used to retrieve all UTxOs controlled by each address in a list of addresses.

ParametersDescriptionExample
resolve_datumsinclude the corresponding datums of the datum hash, if it existsfalse (default)
with_cborinclude the CBOR encoding of the transaction outputfalse (default)
Request body parameterExample
List of addresses["addr1wxgg25t3tk30jqzl2elqz94lzgmr8a9c9m5z902ds5sjh0g7uaj8z", "addr1vxmn8puzz09g7scp7gy0kwsg06eh4kep9padw9xmgnx88hqncydl5"]
Request
curl -X POST \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/addresses/utxos?count=5&page=2 \
-H "Content-Type: application/json" \
-d '["addr1wxgg25t3tk30jqzl2elqz94lzgmr8a9c9m5z902ds5sjh0g7uaj8z", "addr1vxmn8puzz09g7scp7gy0kwsg06eh4kep9padw9xmgnx88hqncydl5"]'
Response
{
"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": {
"constructor": 0,
"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
},
{
"tx_hash": "9190de516954b76c0959f4de9eaf15e0ddb2da863cdc31467db9d34c6eed7c8d",
"index": 0,
"slot": 23297880,
"assets": [
{
"unit": "lovelace",
"amount": 2000000
},
{
"unit": "436941ead56c61dbf9b92b5f566f7d5b9cac08f8c957f28f0bd60d4b5041594d454e54544f4b454e",
"amount": 29820
},
{
"unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4e6f646546656564",
"amount": 1
}
],
"address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
"datum": {
"type": "inline",
"hash": "205cfcf89a3bf34ad79e191dfb772ac0a4e655d3130571b452fef0e011f89d18",
"bytes": "d87a9fd8799fd8799f581cf6f69e5af37c2978cb2124c12202f2185fd5c14ee93bb832911daf8effd8799fd8799f1a0004fc901b00000186eb11e3aaffffffff",
"json": {
"constructor": 1,
"fields": [
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"bytes": "f6f69e5af37c2978cb2124c12202f2185fd5c14ee93bb832911daf8e"
}
]
},
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"int": 326800
},
{
"int": 1678981063594
}
]
}
]
}
]
}
]
}
},
"reference_script": null,
"txout_cbor": null
},
{
"tx_hash": "258d12f3b0f9e6e07f85c21a4fd6c9cacddb9111daf7ae3763d1b12933834bd8",
"index": 0,
"slot": 24459668,
"assets": [
{
"unit": "lovelace",
"amount": 2000000
},
{
"unit": "436941ead56c61dbf9b92b5f566f7d5b9cac08f8c957f28f0bd60d4b5041594d454e54544f4b454e",
"amount": 30060
},
{
"unit": "c00c2ee78495d1cc21010b354c56975ca3f0202e2ea9e16ebab0acfa4e6f646546656564",
"amount": 1
}
],
"address": "addr_test1wr2x24tlcpr37sjrscaqsh6z4tue3k7zx8qt8n0kscen2jct0wkz7",
"datum": {
"type": "inline",
"hash": "cc5801c2f29140145b6c5f1ff003e85fad8e34a69cdda105bd08788499327a01",
"bytes": "d87a9fd8799fd8799f581c007df380aef26e44739db3f4fe67d8137446e630dab3df16d9fbddc5ffd8799fd8799f1a00065b611b0000018730503bd7ffffffff",
"json": {
"constructor": 1,
"fields": [
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"bytes": "007df380aef26e44739db3f4fe67d8137446e630dab3df16d9fbddc5"
}
]
},
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"int": 416609
},
{
"int": 1680142777303
}
]
}
]
}
]
}
]
}
},
"reference_script": null,
"txout_cbor": null
}
],
"last_updated": {
"block_hash": "2d6b15048692aca81cc6dbd9234360ed6163e838fcf9d9f1a9e8dc67e0779f82",
"block_slot": 32266164
},
"next_cursor": null
}
info

Response details

  • tx_hash: UTxO transaction hash
  • index: UTxO transaction index
  • assets: assets held by the UTxO
  • address: address which controls the UTxO
  • datum: datum (inline or hash) of the UTxO
  • reference_script: Native or Plutus script

Assets

Assets endpoints retrieve information about native assets and their corresponding transactions, owners and UTxOs.

Native asset information

GET /assets/{asset}

This endpoint retrieves a summary of information about an asset.

ParametersDescriptionExample
assetConcatenated policy ID and asset name18ed282beda4bec13226c427d4744d2642ba2cef404470b62ae184d8546f6b656e2d34322d313635343837333935373230332d36363538
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/18ed282beda4bec13226c427d4744d2642ba2cef404470b62ae184d8546f6b656e2d34322d313635343837333935373230332d36363538
Response - CIP-68 Metadata example
{
"data": {
"asset_name": "0014df104152494741544f6b656e",
"asset_name_ascii":"ARIGATOken",
"fingerprint": "asset1jwvdcx0r4c45n2lah2yydx9z2y0k2e3rdtlzyw",
"first_mint_tx": "cbb242170d540d59f3904d26aa4d849e321b554c2e14084bcc1786ea7be81564",
"first_mint_time": 1668470400,
"mint_tx_count": 1,
"burn_tx_count": 1,
"total_supply": 0,
"asset_standards": {
"cip25_metadata": null,
"cip68_metadata": {
"purpose": "user_ft",
"version": 1,
"metadata": {
"decimals": "0",
"description": "A token for Cardano_Waifus project",
"logo": "ipfs://QmcxbFm56ymFSHoq2UDm2d7NkGRj7ueMMoZBnUorWWoWTF",
"name": "ARIGATOken",
"ticker": "ARIGATO",
"url": "https://cardanowaifus.digital"
},
"extra": null
}
},
"latest_mint_tx_metadata": null,
"token_registry_metadata": null
},
"last_updated": {
"block_hash": "c3635273a652d733b08e8252485bdd899882627dc6cdf00b35b9c0bed7f3fb01",
"block_slot": 96388440
}
}
Response - CIP-25 Metadata example
{
"data": {
"asset_name": "50a400c2fad65ca37ddd99ab47346845d5292dcd10d7c483d4dd85f0b828aea3",
"asset_name_ascii":"P\\244\\000\\302\\372\\326\\\\\\243}\\335\\231\\253G4hE\\325)-\\315\\327\\304\\203\\324\\335\\205\\360\\270(\\256\\243",
"fingerprint": "asset17ha95t2g0zvtq65g5tmpvnks646pmcl4h75tzn",
"first_mint_tx": "58c6fc796580e7db3491aa8fce74b77c49f45039c92c1f2219f005424ff5df2f",
"first_mint_time": 1673395200,
"mint_tx_count": 1,
"burn_tx_count": 1,
"total_supply": 0,
"asset_standards": {
"cip25_metadata": {
"BondId": "50a400c2fad65ca37ddd99ab47346845d5292dcd10d7c483d4dd85f0b828aea3",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": "image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogICAgPHJlY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MCIgc3Ryb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz4KICAgIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtNDAgOTAgLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwIDAgMzAiIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLTEwIDMwIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNTAgNjAgNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZWU2Ii8+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9IjAiIGZvbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogICAgICA8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZGVyPC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaWQ6PC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2l6ZT0iMjAiPjUwYTQwMGMyZmFkNjVjYTM3ZGRkOTlhYjQ3MzQ2ODQ1ZDUyOTJkY2QxMGQ3YzQ4M2Q0ZGQ4NWYwYjgyOGFlYTM8L3RzcGFuPgogICAgPC90ZXh0PgogIDwvc3ZnPgoKCiAg",
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
},
"cip68_metadata": null
},
"latest_mint_tx_metadata": {
"7": {
"AMOUNT": "500000000",
"CURRENCYASSET": "",
"CURRENCYID": "",
"HOURS": "504",
"ICURRENCYASSET": "",
"ICURRENCYID": "",
"INTEREST": "50000000",
"LENDER": "e972f26e900c8756840b5ab4c2006f8e1ea7417931cadbd488542deb"
},
"721": {
"0x4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091": {
"0x50a400c2fad65ca37ddd99ab47346845d5292dcd10d7c483d4dd85f0b828aea3": {
"BondId": "50a400c2fad65ca37ddd99ab47346845d5292dcd10d7c483d4dd85f0b828aea3",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": [
"image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudzMub3J",
"nLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogICAgPHJ",
"lY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MCIgc3R",
"yb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz4KICA",
"gIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtNDAgOTA",
"gLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwIDAgMzA",
"iIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLTEwIDM",
"wIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNTAgNjA",
"gNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZWU2Ii8",
"+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9IjAiIGZ",
"vbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgICAgPHR",
"zcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGU",
"iIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogICAgICA",
"8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im1pZGR",
"sZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZGVyPC9",
"0c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW50LWJ",
"hc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaWQ6PC9",
"0c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW50LWJ",
"hc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2l6ZT0",
"iMjAiPjUwYTQwMGMyZmFkNjVjYTM3ZGRkOTlhYjQ3MzQ2ODQ1ZDUyOTJkY2QxMGQ",
"3YzQ4M2Q0ZGQ4NWYwYjgyOGFlYTM8L3RzcGFuPgogICAgPC90ZXh0PgogIDwvc3Z",
"nPgoKCiAg"
],
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
}
},
"version": 2
}
},
"token_registry_metadata": null
},
"last_updated": {
"block_hash": "1f9e22dc1e3385246a2ddbaa442908a0af4e812165fc769be11f59cc38739010",
"block_slot": 96390877
}
}
info

Response details

  • asset_name: Hex encoding of the asset name
  • asset_name_ascii: ASCII representation of the asset name
  • fingerprint: CIP-14 fingerprint of the asset
  • first_mint_tx: Transaction hash of the first transaction which minted the asset
  • first_mint_time: UNIX timestamp of the first mint transaction
  • mint_tx_count: Number of transactions that minted some of the asset
  • burn_tx_count: Number of transactions that burned some of the asset
  • asset_standards: Asset information corresponding to popular standards
  • latest_mint_tx_metadata: Transaction metadata used to mint asset
  • token_registry_metadata: Token registry metadata

Minting policy information (including assets)

GET /assets/policy/{policy}

This endpoint retrieves information about a minting policy, including all its assets details.

ParametersDescriptionExample
policyHex encoded policy ID4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/policy/4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091
Response - CIP-68 Metadata example
{
"data": [
{
"asset_name": "000643b04152494741544f6b656e",
"asset_name_ascii":"ARIGATOken",
"fingerprint": "asset17f870p97trn9zsmge0drs0vnln0hjyalf59qvf",
"first_mint_tx": "21936a5c6ad45d548ecd510323d17dad611f06daaa17c369e207ce547679eb8f",
"first_mint_time": 1668470400,
"mint_tx_count": 1,
"burn_tx_count": 0,
"total_supply": 1,
"asset_standards": {
"cip25_metadata": null,
"cip68_metadata": {
"purpose": "reference_nft",
"version": 1,
"metadata": {
"decimals": "0",
"description": "A token for Cardano_Waifus project",
"logo": "ipfs://QmcxbFm56ymFSHoq2UDm2d7NkGRj7ueMMoZBnUorWWoWTF",
"name": "ARIGATOken",
"ticker": "ARIGATO",
"url": "https://cardanowaifus.digital"
},
"extra": null
}
},
"latest_mint_tx_metadata": null,
"token_registry_metadata": null
},
{
"asset_name": "0014df104152494741544f6b656e",
"asset_name_ascii":"ARIGATOken",
"fingerprint": "asset1jwvdcx0r4c45n2lah2yydx9z2y0k2e3rdtlzyw",
"first_mint_tx": "cbb242170d540d59f3904d26aa4d849e321b554c2e14084bcc1786ea7be81564",
"first_mint_time": 1668470400,
"mint_tx_count": 1,
"burn_tx_count": 1,
"total_supply": 0,
"asset_standards": {
"cip25_metadata": null,
"cip68_metadata": {
"purpose": "user_ft",
"version": 1,
"metadata": {
"decimals": "0",
"description": "A token for Cardano_Waifus project",
"logo": "ipfs://QmcxbFm56ymFSHoq2UDm2d7NkGRj7ueMMoZBnUorWWoWTF",
"name": "ARIGATOken",
"ticker": "ARIGATO",
"url": "https://cardanowaifus.digital"
},
"extra": null
}
},
"latest_mint_tx_metadata": null,
"token_registry_metadata": null
}
],
"last_updated": {
"block_hash": "6415959000223cf2cce7467b45369c20f36acc5c5f43aac1764ab8899a428b7d",
"block_slot": 96399271
},
"next_cursor": null
}
Response - CIP-25 Metadata example
{
"data": [
{
"asset_name": "ff951d504f2b635f91e0bb83441ec1b128ad30f022b354041fa3362c6fd25eac",
"asset_name_ascii":"\\377\\225PO+c_\\221\\340\\273\\203D\\301\\261(\\2550\\360\"\\263T\\2436,o\\322^\\254",
"fingerprint": "asset1yexpv5fstcmj7smmrf9dyern5zsx3rps5sm4j5",
"first_mint_tx": "97c7c21f9f9f31c30cac4b42fc2b7b586cb783984e6ff9c55a5e8934d1d1915c",
"first_mint_time": 1679270400,
"mint_tx_count": 1,
"burn_tx_count": 1,
"total_supply": 0,
"asset_standards": {
"cip25_metadata": {
"BondId": "ff951d504f2b635f91e0bb83441ec1b128ad30f022b354041fa3362c6fd25eac",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": "data:image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogICAgPHJlY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MCIgc3Ryb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz4KICAgIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtNDAgOTAgLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwIDAgMzAiIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLTEwIDMwIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNTAgNjAgNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZWU2Ii8+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9IjAiIGZvbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogICAgICA8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZGVyPC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaWQ6PC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2l6ZT0iMjAiPmZmOTUxZDUwNGYyYjYzNWY5MWUwYmI4MzQ0MWVjMWIxMjhhZDMwZjAyMmIzNTQwNDFmYTMzNjJjNmZkMjVlYWM8L3RzcGFuPgogICAgPC90ZXh0PgogIDwvc3ZnPgoKCiAg",
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
},
"cip68_metadata": null
},
"latest_mint_tx_metadata": {
"7": {
"AMOUNT": "200000000",
"CURRENCYASSET": "",
"CURRENCYID": "",
"HOURS": "912",
"ICURRENCYASSET": "",
"ICURRENCYID": "",
"INTEREST": "30000000",
"LENDER": "012691fb8eb0863aea3191001ed6458ca9d4f276e140c58f4c6b89f8"
},
"721": {
"0x4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091": {
"0xff951d504f2b635f91e0bb83441ec1b128ad30f022b354041fa3362c6fd25eac": {
"BondId": "ff951d504f2b635f91e0bb83441ec1b128ad30f022b354041fa3362c6fd25eac",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": [
"data:image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudz",
"Mub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogIC",
"AgPHJlY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MC",
"Igc3Ryb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz",
"4KICAgIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtND",
"AgOTAgLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwID",
"AgMzAiIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLT",
"EwIDMwIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNT",
"AgNjAgNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZW",
"U2Ii8+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9Ij",
"AiIGZvbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgIC",
"AgPHRzcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaW",
"RkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogIC",
"AgICA8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im",
"1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZG",
"VyPC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW",
"50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaW",
"Q6PC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW",
"50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2",
"l6ZT0iMjAiPmZmOTUxZDUwNGYyYjYzNWY5MWUwYmI4MzQ0MWVjMWIxMjhhZDMwZj",
"AyMmIzNTQwNDFmYTMzNjJjNmZkMjVlYWM8L3RzcGFuPgogICAgPC90ZXh0PgogID",
"wvc3ZnPgoKCiAg"
],
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
}
},
"version": 2
}
},
"token_registry_metadata": null
},
{
"asset_name": "f01b3a955da6b0ebf68c8e54689a505e263a4ae5fb891d70a2704308dc799283",
"asset_name_ascii":"\\360:\\225]\\246\\260\\353\\366\\214\\216Th\\232P^&:J\\345\\373\\211p\\242pC\b\\334y\\222\\203",
"fingerprint": "asset1ljwhnr5ef45j6ssjv4f7xswdl4axt290knna5g",
"first_mint_tx": "5e0df99ba0003b00d604029af33adfa14bd99184fe70381dd4df5720fc061fbb",
"first_mint_time": 1679270400,
"mint_tx_count": 1,
"burn_tx_count": 0,
"total_supply": 1,
"asset_standards": {
"cip25_metadata": {
"BondId": "f01b3a955da6b0ebf68c8e54689a505e263a4ae5fb891d70a2704308dc799283",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": "data:image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogICAgPHJlY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MCIgc3Ryb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz4KICAgIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtNDAgOTAgLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwIDAgMzAiIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLTEwIDMwIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNTAgNjAgNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZWU2Ii8+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9IjAiIGZvbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogICAgICA8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZGVyPC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaWQ6PC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2l6ZT0iMjAiPmYwMWIzYTk1NWRhNmIwZWJmNjhjOGU1NDY4OWE1MDVlMjYzYTRhZTVmYjg5MWQ3MGEyNzA0MzA4ZGM3OTkyODM8L3RzcGFuPgogICAgPC90ZXh0PgogIDwvc3ZnPgoKCiAg",
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
},
"cip68_metadata": null
},
"latest_mint_tx_metadata": {
"7": {
"AMOUNT": "2500000000",
"CURRENCYASSET": "",
"CURRENCYID": "",
"HOURS": "2160",
"ICURRENCYASSET": "",
"ICURRENCYID": "",
"INTEREST": "150000000",
"LENDER": "453f155fd1e609d80f4b38f58fee9745f965d35b1135ed7098d5841a"
},
"721": {
"0x4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091": {
"0xf01b3a955da6b0ebf68c8e54689a505e263a4ae5fb891d70a2704308dc799283": {
"BondId": "f01b3a955da6b0ebf68c8e54689a505e263a4ae5fb891d70a2704308dc799283",
"Policy": "4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091",
"image": [
"data:image/svg+xml;base64,CgogIDxzdmcgeG1sbnM9Imh0dHA6Ly93d3cudz",
"Mub3JnLzIwMDAvc3ZnIiB2aWV3Qm94PSItMzAwIC0xMDAgNzAwIDEwMDAiPgogIC",
"AgPHJlY3QgeD0iLTI5MCIgeT0iLTkwIiB3aWR0aD0iNjkwIiBoZWlnaHQ9Ijk5MC",
"Igc3Ryb2tlPSJibHVlIiBzdHJva2Utd2lkdGg9IjJweCIgZmlsbD0id2hpdGUiLz",
"4KICAgIDxwYXRoIGQ9Ik0gMCAwIEMgMCAwIDAgMCAwIDAgQyAwIC01MCA1MCAtND",
"AgOTAgLTQwIEMgMTIwIC00MCAxMjAgMCA5MCAwIEwgMzAgMCBDIDEwIDAgMCAwID",
"AgMzAiIGZpbGw9IiM1MGQxYjMiLz4KICAgIDxwYXRoIGQ9Ik0gMjAgMTAwIEMgLT",
"EwIDMwIC0xMCAwIDEwMCAxMCBDIDYwIDEwIDUwIDIwIDUwIDMwIEMgNTAgNDAgNT",
"AgNjAgNjAgOTAgQyA3MCAxMjAgMzAgMTMwIDIwIDEwMCBaIiBmaWxsPSIjMWI5ZW",
"U2Ii8+CiAgICA8dGV4dCB4PSIwIiB5PSI1MCIgZm9udC1zaXplPSI2MCIgZHk9Ij",
"AiIGZvbnQtZmFtaWx5PSJTYW5zIFNlcmlmIiBmaWxsPSIjMDAwMDAwIj4KICAgIC",
"AgPHRzcGFuIHg9IjUlIiBkeT0iMS44ZW0iIGRvbWluYW50LWJhc2VsaW5lPSJtaW",
"RkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkZMVUlEIEJPTkQ8L3RzcGFuPgogIC",
"AgICA8dHNwYW4geD0iNSUiIGR5PSIxLjJlbSIgZG9taW5hbnQtYmFzZWxpbmU9Im",
"1pZGRsZSIgdGV4dC1hbmNob3I9Im1pZGRsZSIgZm9udC1zaXplPSI0OCI+TGVuZG",
"VyPC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMS4yZW0iIGRvbWluYW",
"50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiPkJvbmQgaW",
"Q6PC90c3Bhbj4KICAgICAgPHRzcGFuIHg9IjUlIiBkeT0iMi40ZW0iIGRvbWluYW",
"50LWJhc2VsaW5lPSJtaWRkbGUiIHRleHQtYW5jaG9yPSJtaWRkbGUiIGZvbnQtc2",
"l6ZT0iMjAiPmYwMWIzYTk1NWRhNmIwZWJmNjhjOGU1NDY4OWE1MDVlMjYzYTRhZT",
"VmYjg5MWQ3MGEyNzA0MzA4ZGM3OTkyODM8L3RzcGFuPgogICAgPC90ZXh0PgogID",
"wvc3ZnPgoKCiAg"
],
"mediaType": "image/svg+xml",
"name": "Fluid tokens bond",
"twitter": "https://twitter.com/fluidtokens"
}
},
"version": 2
}
},
"token_registry_metadata": null
}
],
"last_updated": {
"block_hash": "6bd71894a56513ce3fc8a9ffd323ac805996dc7d635c4fccbd79a58fa9e1f557",
"block_slot": 96398643
},
"next_cursor": "AAAAAAAAAAY"
}
info

Response details

  • asset_name: Hex encoding of the asset name
  • asset_name_ascii: ASCII representation of the asset name
  • fingerprint: CIP-14 fingerprint of the asset
  • first_mint_tx: Transaction hash of the first transaction which minted the asset
  • first_mint_time: UNIX timestamp of the first mint transaction
  • mint_tx_count: Number of transactions that minted some of the asset
  • burn_tx_count: Number of transactions that burned some of the asset
  • total_supply: Total number of asset units minted
  • asset_standards: Asset information corresponding to popular standards
  • latest_mint_tx_metadata: Transaction metadata used to mint asset
  • token_registry_metadata: Token registry metadata

Minting policy UTxOs

GET /assets/policy/{policy}/utxos

This endpoint retrieves UTxOs which contain assets of a policy ID, along with the asset names and amounts.

ParametersDescriptionExample
policyHex encoded policy ID025146866af908340247fe4e9672d5ac7059f1e8534696b5f920c9e6
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/policy/025146866af908340247fe4e9672d5ac7059f1e8534696b5f920c9e6/utxos
Response
{
"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": {
"block_hash": "0e0cb28820d245261e693d950c19f782fd90c63d03df5cdfde4efbfd2ac1365a",
"block_slot": 32283585
},
"next_cursor": null
}
info

Response details

  • tx_hash: UTxO transaction hash
  • index: UTxO transaction index
  • address: address which controls the UTxO
  • assets: asset of a specific policy

Datum

Datum endpoints allow retrieving information about transaction datums.

Datum of a datum hash

GET /datums/{datum_hash}

This endpoint retrieves the datum corresponding to the specified datum hash, if the datum has been seen on-chain.

ParametersDescriptionExample
datum_hashHex encoded datum hash26ca227dda7a59991c11c530c664ce95cf8c879f010c82834152d2eb778330ea
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/datum/26ca227dda7a59991c11c530c664ce95cf8c879f010c82834152d2eb778330ea
Response
{
"data": {
"json": {
"constructor": 0,
"fields": [
{
"bytes": "76140b3e82b58a9439ce10473d0d7c40ec9165fb03662c499a9162f95b9ec34641adbb83203c5276eaa35fc95c3776e00779ca412777cdc5201b53184d365306"
},
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"int": 100000
},
{
"int": 36069
}
]
},
{
"constructor": 0,
"fields": [
{
"constructor": 0,
"fields": [
{
"constructor": 1,
"fields": [
{
"int": 1676063825000
}
]
},
{
"constructor": 1,
"fields": []
}
]
},
{
"constructor": 0,
"fields": [
{
"constructor": 1,
"fields": [
{
"int": 1676065625000
}
]
},
{
"constructor": 1,
"fields": []
}
]
}
]
},
{
"bytes": "555344"
}
]
},
{
"bytes": "0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2"
}
]
},
"bytes": "d8799f584076140b3e82b58a9439ce10473d0d7c40ec9165fb03662c499a9162f95b9ec34641adbb83203c5276eaa35fc95c3776e00779ca412777cdc5201b53184d365306d8799fd8799f1a000186a0198ce5ffd8799fd8799fd87a9f1b000001863d305c68ffd87a80ffd8799fd87a9f1b000001863d4bd3a8ffd87a80ffff43555344ff581c0c64d6d0371d11185aae649cf3a169040e94214137137b531ebb16c2ff"
},
"last_updated": {
"block_hash": "391e8974a46a05addd54593722380fdea42f29d7de4acc5729a6ec0663955293",
"block_slot": 32284048
}
}
info

Response details

  • json: JSON representation of the datum
  • bytes: Hex encoded datum CBOR bytes

Epochs

Epoch endpoints allow retrieving details about epochs.

Epoch details

GET /epochs/{epoch_no}/info

This endpoint retrieves information about a specific epoch.

ParametersDescriptionExample
epoch_noEpoch height (number)50
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/epochs/60/info
Response
{
"data": {
"epoch_no": 60,
"fees": "3586202648",
"tx_count": 12335,
"blk_count": 17299,
"start_time": 1679961605,
"end_time": 1680393504
},
"last_updated": {
"block_hash": "bb35643eb0da04a3965b15db86edfaa8b4b9eba0f2dad77edf8e0250f41f2de1",
"block_slot": 32284313
}
}
info

Response details

  • epoch_no: epoch number
  • fees: total fees collected in the epoch
  • tx_count: total transactions in the epoch
  • blk_count: total blocks in the epoch
  • start_time: UNIX timestamp when the epoch began
  • end_time: UNIX timestamp when the epoch ended

Pools

Pools endpoints allow retrieving information about stake pools**.

Stake pool delegators

GET /pools/{pool_id}/delegators

This endpoint is used to retrieve a list of delegators of a specified stake pool.

ParametersDescriptionExample
pool_idBech32 encoded pool IDpool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/pools/pool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8/delegators
Response
{
"data": [
{
"stake_address": "stake_test17rj4qqxk8knlenwchvfdedd78f2j3mzdvkz248qj3kxv6uq34s3ee",
"amount": 9490177466,
"active_epoch_no": 51,
"latest_delegation_tx_hash": "33026c248f505b3ef7e24e91695c4c8b24410ee2b553b2838b1a7031347bfea9"
},
{
"stake_address": "stake_test1uply0jchjsuutv8xtynj8pcd53fdc52ck09xapx3sl4p2gsqu3qj5",
"amount": 8860890871,
"active_epoch_no": 62,
"latest_delegation_tx_hash": "bca5147743ff7526345887fd41feeca0b1a6b020dcf729c48168d35f04de173d"
},
{
"stake_address": "stake_test1urqyujhrevd6u6fw8fc47wt9an6k05knt909jzjy62cqhtsyapk45",
"amount": 1739362,
"active_epoch_no": 68,
"latest_delegation_tx_hash": "d548cd34dd81ae577e8b574dc9c791229d987a6e74e0a589e55fc514b594e80d"
},
{
"stake_address": "stake_test1uruymljt8tnzddw73tfd5s6u7yhjtsuu3rgunfudlvazskg6j69x4",
"amount": 179818527,
"active_epoch_no": 64,
"latest_delegation_tx_hash": "24aed6ac23ce806585aeff3f9acc9d911dcec77fad8b5ae2a8cce5b2c40ec5e5"
},
{
"stake_address": "stake_test1urwv4zffnmgk4f3fw2pwsakzt4s7qywg3fpjtfnnpzfftvscmeyjc",
"amount": 42142647,
"active_epoch_no": 41,
"latest_delegation_tx_hash": "3185a05a2fb218e8b16de6d6070a48d464a95873176251924a8b097a93d7be81"
},
{
"stake_address": "stake_test1uzwzumcjwl0q0h3rsvjm5nnhpwlkv7qaxykdmlqyf2xy49g3f305d",
"amount": 97665126,
"active_epoch_no": 72,
"latest_delegation_tx_hash": "46b6b6f5d09b1f069e20a2d6070b4a36bd6168307dc4ec323fd14bbdb3d80521"
}
],
"last_updated": {
"block_hash": "16faeb7b2a208081a9fe5688574d86998a8e5ace73c37d5655ba3252ffb681f6",
"block_slot": 32454979
},
"next_cursor": null
}
info

Response details

  • stake_address: Bech32 encoded stake address (reward address)
  • amount: Delegator live stake in lovelace
  • active_epoch_no: epoch at which the delegation becomes active
  • latest_delegation_tx_hash: transaction hash relating to the most recent delegation

Scripts

Scripts endpoints allow retrieving information about Native scripts or Plutus smart contracts.

Script of a script hash

GET /scripts/{script_hash}

The endpoint retrieves the script corresponding to the specified script hash, if seen on-chain.

ParametersDescriptionExample
script_hashHex encoded script hash791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1
Request
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/scripts/791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1
Response
{
"data": {
"hash": "791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1",
"type": "plutusv2",
"bytes": "5910630100003323322....112212330010030021120011",
"json": null
},
"last_updated": {
"block_hash": "e7ccaa73e333fcef5020449f573350bc175107664a2511a91a7f5f627d99b6d4",
"block_slot": 32289099
}
}
info

Response details

  • hash: script hash
  • type: script type and version: native, plutusV1, plutusV2
  • bytes: byte representation of the script
  • json: JSON representation of the script

Transactions

Transaction endpoints allow retrieving information about transactions and allow you to submit transactions to the network.

Submit transaction (without Transaction Manager)

POST /submit/tx

This endpoint submits a signed and serialized transaction to the network.

caution

All transactions submitted with this endpoint will NOT be recorded or tracked by Maestro's Transaction Manager.

tip

Learn how to monitor onchain transaction states in the Transaction Dashboard, get real-time notifications via Transaction Manager Webhooks, or query the Transaction Manager Endpoints.

Request
curl -X POST \
-H "api-key: <your_project_api_key>" \
-H "Content-Type: application/cbor" \
--data @tx.signed \
https://mainnet.gomaestro-api.org/v1/submit/tx

Where, tx.signed is a signed, CBOR-encoded binary representation of the transaction.

Response
"bc14ee113224f818edc1dc87db034ca3a610dca03ecffa9603fb1b0de98677ac"
info

Reponse details

  • The transaction hash of the submitted transaction.