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.
- Read more about Authorization and api-key usage here.
- The queries on this page are made to the Pre-Production test network.
- Endpoints that return lists of objects utilize cursor-based-pagination.
General
Chain tip details
GET /chain-tip
This endpoint can be used to retrieve details about the latest block of the network.
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/chain-tip
{
"data": {
"block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a",
"slot": 32284578,
"height": 1102039
},
"last_updated": {
"block_hash": "4c0916eea22254efc2a35f72b4fa8ec5caaf3cd0b193a4df8efb4c0f5ff2be4a",
"block_slot": 32284578
}
}
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.
Parameters | Description | Example |
---|---|---|
stake_address | Bech32 encoded stake address | stake1u9w504hwl7sv6ewe72kxx45pzs37zq4qr4tvfqj3n2rqzvseuxpcf |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/accounts/stake1u9w504hwl7sv6ewe72kxx45pzs37zq4qr4tvfqj3n2rqzvseuxpcf/updates?count=20&page=3
{
"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
}
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.
Parameters | Description | Example |
---|---|---|
address | Bech32 encoded address | addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm |
curl -X 'GET' \
'https://mainnet.gomaestro-api.org/v1/addresses/addr1zxgx3far7qygq0k6epa0zcvcvrevmn0ypsnfsue94nsn3tvpw288a4x0xf8pxgcntelxmyclq83s0ykeehchz2wtspks905plm/decode' \
-H 'accept: application/json'
{
"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
}
}
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.
Parameters | Description | Example |
---|---|---|
resolve_datums | include the corresponding datums of the datum hash, if it exists | false (default) |
with_cbor | include the CBOR encoding of the transaction output | false (default) |
Request body parameter | Example |
---|---|
List of addresses | ["addr1wxgg25t3tk30jqzl2elqz94lzgmr8a9c9m5z902ds5sjh0g7uaj8z", "addr1vxmn8puzz09g7scp7gy0kwsg06eh4kep9padw9xmgnx88hqncydl5"] |
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"]'
{
"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
}
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.
Parameters | Description | Example |
---|---|---|
asset | Concatenated policy ID and asset name | 18ed282beda4bec13226c427d4744d2642ba2cef404470b62ae184d8546f6b656e2d34322d313635343837333935373230332d36363538 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/18ed282beda4bec13226c427d4744d2642ba2cef404470b62ae184d8546f6b656e2d34322d313635343837333935373230332d36363538
{
"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
}
}
{
"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
}
}
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)
This endpoint retrieves information about a minting policy, including all its assets details.
Parameters | Description | Example |
---|---|---|
policy | Hex encoded policy ID | 4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/policy/4aef6e0795e1f8241eb19ade6221a85d610523714e4d59d4e9095091
{
"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
}
{
"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"
}
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.
Parameters | Description | Example |
---|---|---|
policy | Hex encoded policy ID | 025146866af908340247fe4e9672d5ac7059f1e8534696b5f920c9e6 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/assets/policy/025146866af908340247fe4e9672d5ac7059f1e8534696b5f920c9e6/utxos
{
"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
}
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
This endpoint retrieves the datum corresponding to the specified datum hash, if the datum has been seen on-chain.
Parameters | Description | Example |
---|---|---|
datum_hash | Hex encoded datum hash | 26ca227dda7a59991c11c530c664ce95cf8c879f010c82834152d2eb778330ea |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/datum/26ca227dda7a59991c11c530c664ce95cf8c879f010c82834152d2eb778330ea
{
"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
}
}
Response details
- json: JSON representation of the datum
- bytes: Hex encoded datum CBOR bytes
Epochs
Epoch endpoints allow retrieving details about epochs.
Epoch details
This endpoint retrieves information about a specific epoch.
Parameters | Description | Example |
---|---|---|
epoch_no | Epoch height (number) | 50 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/epochs/60/info
{
"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
}
}
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.
Parameters | Description | Example |
---|---|---|
pool_id | Bech32 encoded pool ID | pool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/pools/pool174mw7e20768e8vj4fn8y6p536n8rkzswsapwtwn354dckpjqzr8/delegators
{
"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
}
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
The endpoint retrieves the script corresponding to the specified script hash, if seen on-chain.
Parameters | Description | Example |
---|---|---|
script_hash | Hex encoded script hash | 791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1 |
curl -X GET \
-H "api-key: <your_project_api_key>" \
https://preprod.gomaestro-api.org/v1/scripts/791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1
{
"data": {
"hash": "791d504ef072be11979a3c722bf1a46a8af77be7326fb7949da497c1",
"type": "plutusv2",
"bytes": "5910630100003323322....112212330010030021120011",
"json": null
},
"last_updated": {
"block_hash": "e7ccaa73e333fcef5020449f573350bc175107664a2511a91a7f5f627d99b6d4",
"block_slot": 32289099
}
}
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.
All transactions submitted with this endpoint will NOT be recorded or tracked by Maestro's Transaction Manager.
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.
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.
"bc14ee113224f818edc1dc87db034ca3a610dca03ecffa9603fb1b0de98677ac"
Reponse details
- The transaction hash of the submitted transaction.