explorer-api¶
The following requests are made on the Cardano TestNet. It is also important to note that many GraphQL queries below are in reality much more flexible and capable than the queries given in the examples.
Tip
Any GraphQL query can be run interactively in the Cardano GraphQL playground, which is accessible here online.
Info
cURL Examples below refers to a $BASEURL environment variable. Replace this to point to the host and port of the right services. If you're using the default local setup with the
default configuration, it should correspond to:
| Service | Protocol | Hostname | Port |
|---|---|---|---|
| cardano-rest | http | localhost | 8090 |
| cardano-graphql | http | localhost | 3100 |
| cardano-rosetta | http | localhost | 8080 |
Blocks¶
/api/blocks/pages¶
Get the list of blocks, contained in pages.
$ curl "$BASEURL/api/blocks/pages?page=221038"
see JSON response
{
"Right": [
222550,
[
{
"cbeEpoch": 106,
"cbeSlot": 307143,
"cbeBlkHeight": 2210380,
"cbeBlkHash": "42c7121010f7eede53e07ef0bea954f1704155567ac4b29bcc106ab9d70bdd44",
"cbeTimeIssued": 1610098759,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "43cc785cf7817a8c79ca7b569fefec98ca22323b0f1051d3bb8bf9b9",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 307120,
"cbeBlkHeight": 2210379,
"cbeBlkHash": "59d98df243ee10436f8946f7d9fa3463ad32648f454f661dbf0ac1681e0414d3",
"cbeTimeIssued": 1610098736,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "bf07107c6f632de95e34af7e009d2aafa19916c7ba89b944fbedcd72",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 307040,
"cbeBlkHeight": 2210378,
"cbeBlkHash": "7afbe86ba5447d81fba9ca94526fe3d89addaca5164bcde1de39f8853e601a33",
"cbeTimeIssued": 1610098656,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "de665a71064706f946030505eae950583f08c316f0f58997961092b1",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 307030,
"cbeBlkHeight": 2210377,
"cbeBlkHash": "be7cd8f8b5ae388b612f9a2f944f1b25836b5dd451cdac83bbbd7567997ce403",
"cbeTimeIssued": 1610098646,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "9f36c4c67b76a8cea05a1684f8feaa64711f4c0053fe039978b203af",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306963,
"cbeBlkHeight": 2210376,
"cbeBlkHash": "82785f52a832d11352bdbbea6e39807488cc0b20560aab2235003085d8909ad2",
"cbeTimeIssued": 1610098579,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "1ce0eaa92a03f854e22a5acc42fde7a4fd1d48c27fbec77162d45c12",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306960,
"cbeBlkHeight": 2210375,
"cbeBlkHash": "f88e1b71f9e710a9b630e57283271decf4410794af2205c04576db7958c84d2e",
"cbeTimeIssued": 1610098576,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "bd5933d3c5417f17a64c7214711a26abc3bc03e2c90dc1bb38e0c39f",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306958,
"cbeBlkHeight": 2210374,
"cbeBlkHash": "a835446a0eeb40d437b03964ab5907e7c4145bdd034b549a8b05a2e740090301",
"cbeTimeIssued": 1610098574,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "8f49108228169c7c766d5db245ed834ac8c32b0ec7f06c7a3e70e50d",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306911,
"cbeBlkHeight": 2210373,
"cbeBlkHash": "852e54e98e7e498a1edf767faaea4cfdcea714b2931297f7adad1d5a55040d5b",
"cbeTimeIssued": 1610098527,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "d0c94502e24095349ccc813e0e9ff304b4680a9b347006095960fb51",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306880,
"cbeBlkHeight": 2210372,
"cbeBlkHash": "904f180c9271d96b6086623daa402e9f033a05ecf1bf35f9f5508b4584b6fed8",
"cbeTimeIssued": 1610098496,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "6df3e1b4b8a84c63c805076a85e5aa00924997a4eae85fddf0aee3ca",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 106,
"cbeSlot": 306800,
"cbeBlkHeight": 2210371,
"cbeBlkHash": "8c262185505782726c09d68cb0b84aab12f84117cb554b25ab2212d69eaed083",
"cbeTimeIssued": 1610098416,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3,
"cbeBlockLead": "b3873a254459f506e47b9a252ee7912e538b364447f31576a170db65",
"cbeFees": {
"getCoin": "0"
}
}
]
]
}
query.graphql
query getBlocks($limit: Int!, $epoch: Int!) {
blocks(limit: $limit, where: { epoch: { number: { _eq: $epoch } } }) {
slotNo # cbeSlot
slotInEpoch # cbeEpoch
number # cbeBlkHeight
hash # cbeBlkHash
forgedAt # cbeTimeIssued
transactionsCount # cbeTxNum
transactions_aggregate {
aggregate {
sum {
totalOutput # cbeTotalSent
}
}
}
slotLeader {
hash # cbeBlockLead
}
size # cbeSize
fees # cbeFees
}
}
{
"limit": 2,
"epoch": 86
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"limit":2,"epoch":86},{ "query":"query getBlocks($limit: Int!, $epoch: Int!) { blocks(limit: $limit, where: { epoch: { number: { _eq: $epoch } } }) { slotNo slotInEpoch number hash forgedAt transactionsCount transactions_aggregate { aggregate { sum { totalOutput } } } slotLeader { hash } size fees } }"}'
see JSON response
{
"data": {
"blocks": [
{
"slotNo": 7214371,
"slotInEpoch": 431971,
"number": 1871955,
"hash": "1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6",
"forgedAt": "2020-10-01T20:19:47Z",
"transactionsCount": "1",
"transactions_aggregate": {
"aggregate": {
"sum": {
"totalOutput": "9825611"
}
}
},
"slotLeader": {
"hash": "b3873a254459f506e47b9a252ee7912e538b364447f31576a170db65"
},
"size": 290,
"fees": 174389
},
{
"slotNo": 7214363,
"slotInEpoch": 431963,
"number": 1871954,
"hash": "94453b8518843387c02921906bac68f70da6f3604eb9f920daa7a758ce2f018e",
"forgedAt": "2020-10-01T20:19:39Z",
"transactionsCount": "1",
"transactions_aggregate": {
"aggregate": {
"sum": {
"totalOutput": "9825611"
}
}
},
"slotLeader": {
"hash": "dc27de163b122622dc64176236656c6b9622f96f3d2eea74f89414ae"
},
"size": 290,
"fees": 174389
}
]
}
}
Info
Neither GraphQL, nor Rosetta are paged, but instead allow to set a limit and an offset to queries.
/api/blocks/pages/total¶
Get the list of total pages.
Info
Neither GraphQL, nor Rosetta are paged, but instead allow to set a limit and an offset to queries.
/api/blocks/summary/{blockHash}¶
Get block's summary information.
$ curl $BASEURL/api/blocks/summary/1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6
see JSON response
{
"Right": {
"cbsEntry": {
"cbeEpoch": 86,
"cbeSlot": 431971,
"cbeBlkHeight": 1871955,
"cbeBlkHash": "1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6",
"cbeTimeIssued": 1601583587,
"cbeTxNum": 1,
"cbeTotalSent": {
"getCoin": "9825611"
},
"cbeSize": 290,
"cbeBlockLead": "b3873a254459f506e47b9a252ee7912e538b364447f31576a170db65",
"cbeFees": {
"getCoin": "174389"
}
},
"cbsPrevHash": "94453b8518843387c02921906bac68f70da6f3604eb9f920daa7a758ce2f018e",
"cbsNextHash": "d5535fc0fb15875445a9565009aa9b99cd141f47f4ad7bf5e282c6361f6e7ddb",
"cbsMerkleRoot": ""
}
}
query.graphql
query getBlock($hash: Hash32Hex!) {
blocks(limit: 1, where: { hash: { _eq: $hash } }) {
slotInEpoch # cbeEpoch
slotNo # cbeSlot
number # cbeBlkHeight
hash # cbeBlkHash
forgedAt # cbeTimeIssued
transactionsCount # cbeTxNum
transactions_aggregate {
aggregate {
sum {
totalOutput # cbeTotalSent
}
}
}
size # cbeSize
slotLeader {
hash # cbeBlockLead
}
fees # cbeFees
previousBlock {
hash # cbsPrevHash
}
nextBlock {
hash # cbsNextHash
}
merkelRoot # cbsMerkleRoot
}
}
{
"hash": "1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6"
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"hash":"1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6"},"query":"query getBlock($hash: Hash32Hex!) { blocks(limit: 1, where: { hash: { _eq: $hash } }) { slotInEpoch slotNo number hash forgedAt transactionsCount transactions_aggregate { aggregate { sum { totalOutput } } } size slotLeader { hash } fees previousBlock { hash } nextBlock { hash } merkelRoot }}"}'
see JSON response
{
"data": {
"blocks": [
{
"slotInEpoch": 431971,
"slotNo": 7214371,
"number": 1871955,
"hash": "1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6",
"forgedAt": "2020-10-01T20:19:47Z",
"transactionsCount": "1",
"transactions_aggregate": {
"aggregate": {
"sum": {
"totalOutput": "9825611"
}
}
},
"size": 290,
"slotLeader": {
"hash": "b3873a254459f506e47b9a252ee7912e538b364447f31576a170db65"
},
"fees": 174389,
"previousBlock": {
"hash": "94453b8518843387c02921906bac68f70da6f3604eb9f920daa7a758ce2f018e"
},
"nextBlock": {
"hash": "d5535fc0fb15875445a9565009aa9b99cd141f47f4ad7bf5e282c6361f6e7ddb"
},
"merkelRoot": null
}
]
}
}
$ curl -X POST '$BASEURL/block' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": {"blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "block_identifier": {"index": "5264122" }}'
see JSON response
{
"block": {
"block_identifier": {
"index": 5264122,
"hash": "b5426334221805b3c161ec07b02722728ced7b5c38a9cc60962e819620ecbf9a"
},
"parent_block_identifier": {
"index": 5264121,
"hash": "ff677921d61672d2fb14025f6d8d8b1f93d89266986f045d48ddc674459134ea"
},
"timestamp": 1611751783000,
"transactions": [
{
"transaction_identifier": {
"hash": "2d3d33d26c87d3e8ef0bc6cb25be3fb34f4db43bf23d7c624955a82cd8815772"
},
"operations": [
{
"operation_identifier": {
"index": 0
},
"type": "input",
"status": "success",
"account": {
"address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E"
},
"amount": {
"value": "-4998821898",
"currency": {
"symbol": "ADA",
"decimals": 6
}
},
"coin_change": {
"coin_identifier": {
"identifier": "002da5ef961fd9d826332db916fe7de5e198b8a5f00f9c535f9c329bb14f01e8:0"
},
"coin_action": "coin_spent"
}
}
],
"metadata": {
"transactionsCount": 6,
"createdBy": "ShelleyGenesis-1d4f2e1fda43070d",
"size": 9559,
"epochNo": 244,
"slotNo": 20185492
}
}
]
}
}
/api/blocks/txs/{blockHash}¶
Get brief information about transactions.
$ curl $BASEURL/api/blocks/txs/1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6
see JSON response
{
"Right": [
{
"ctbId": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31",
"ctbTimeIssued": 1601583587,
"ctbInputs": [
{
"ctaAddress": "addr_test1qpdmel32d5hcqlna8fdpsypmfn8ggfcarmlurzaa6yxflcywsfrv2aayw5akn8pstwxxdrpnr27yact8t7kvpg9ggtjqpkqf2t",
"ctaAmount": {
"getCoin": "10000000"
},
"ctaTxHash": "bd122e2a7440c6710e2bd3350cce18621acb1c0d58d4c066878a60341761f71c",
"ctaTxIndex": 0
}
],
"ctbOutputs": [
{
"ctaAddress": "addr_test1qpw39hnntn0ls8vckussxz39zh8ev8ne29h3965dhd5txzg0ld2hh665wg0vpy9u0v9fkp5pqmfk5703n7sr4srtvzas7932tv",
"ctaAmount": {
"getCoin": "2000000"
},
"ctaTxHash": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31",
"ctaTxIndex": 0
},
{
"ctaAddress": "addr_test1qpdmel32d5hcqlna8fdpsypmfn8ggfcarmlurzaa6yxflcywsfrv2aayw5akn8pstwxxdrpnr27yact8t7kvpg9ggtjqpkqf2t",
"ctaAmount": {
"getCoin": "7825611"
},
"ctaTxHash": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31",
"ctaTxIndex": 1
}
],
"ctbInputSum": {
"getCoin": "10000000"
},
"ctbOutputSum": {
"getCoin": "9825611"
},
"ctbFees": {
"getCoin": "174389"
}
}
]
}
query.graphql
query getBlockTxs($hash: Hash32Hex!) {
blocks(limit: 1, where: { hash: { _eq: $hash } }) {
transactions {
hash # ctbId
includedAt # ctbTimeIssued
fee # ctbFees
inputs {
# ctbInputs
address # ctaAddress
value # ctaAmount
sourceTxHash # ctaTxHash
sourceTxIndex # ctaTxIndex
}
inputs_aggregate {
aggregate {
sum {
value # ctbInputSum
}
}
}
outputs { # ctbOutputs
address # ctaAddress
index # ctaTxIndex
value # ctaAmount
transaction {
hash # ctaTxHash
}
}
outputs_aggregate {
aggregate {
sum {
value # ctbOutputSum
}
}
}
}
}
}
{
"hash": "1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6"
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"hash":"1fd784ef1814fd3e1bdf35c9cd9966ed3d92ba36b68e91504cf414493a657da6"}, "query":"query getBlockTxs($hash: Hash32Hex!) { blocks(limit: 1, where: { hash: { _eq: $hash } }) { transactions { hash includedAt fee inputs { address value sourceTxHash sourceTxIndex } inputs_aggregate { aggregate { sum { value } } } outputs { address index value transaction { hash } } outputs_aggregate { aggregate { sum { value } } } } }}"}'
see JSON response
{
"data": {
"blocks": [
{
"transactions": [
{
"hash": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31",
"includedAt": "2020-10-01T20:19:47Z",
"fee": 174389,
"inputs": [
{
"address": "addr_test1qpdmel32d5hcqlna8fdpsypmfn8ggfcarmlurzaa6yxflcywsfrv2aayw5akn8pstwxxdrpnr27yact8t7kvpg9ggtjqpkqf2t",
"value": "10000000",
"sourceTxHash": "bd122e2a7440c6710e2bd3350cce18621acb1c0d58d4c066878a60341761f71c",
"sourceTxIndex": 0
}
],
"inputs_aggregate": {
"aggregate": {
"sum": {
"value": "10000000"
}
}
},
"outputs": [
{
"address": "addr_test1qpw39hnntn0ls8vckussxz39zh8ev8ne29h3965dhd5txzg0ld2hh665wg0vpy9u0v9fkp5pqmfk5703n7sr4srtvzas7932tv",
"index": 0,
"value": "2000000",
"transaction": {
"hash": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31"
}
},
{
"address": "addr_test1qpdmel32d5hcqlna8fdpsypmfn8ggfcarmlurzaa6yxflcywsfrv2aayw5akn8pstwxxdrpnr27yact8t7kvpg9ggtjqpkqf2t",
"index": 1,
"value": "7825611",
"transaction": {
"hash": "db5d4cce4b87434fd142409f1fd1680769ee2669989883c763c292952793da31"
}
}
],
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "9825611"
}
}
}
}
]
}
]
}
}
$ curl -X POST '$BASEURL/block' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": {"blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "block_identifier": {"index": "5264122" }}'
see JSON response
{
"block": {
"block_identifier": {
"index": 5264122,
"hash": "b5426334221805b3c161ec07b02722728ced7b5c38a9cc60962e819620ecbf9a"
},
"parent_block_identifier": {
"index": 5264121,
"hash": "ff677921d61672d2fb14025f6d8d8b1f93d89266986f045d48ddc674459134ea"
},
"timestamp": 1611751783000,
"transactions": [
{
"transaction_identifier": {
"hash": "2d3d33d26c87d3e8ef0bc6cb25be3fb34f4db43bf23d7c624955a82cd8815772"
},
"operations": [
{
"operation_identifier": {
"index": 0
},
"type": "input",
"status": "success",
"account": {
"address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E"
},
"amount": {
"value": "-4998821898",
"currency": {
"symbol": "ADA",
"decimals": 6
}
},
"coin_change": {
"coin_identifier": {
"identifier": "002da5ef961fd9d826332db916fe7de5e198b8a5f00f9c535f9c329bb14f01e8:0"
},
"coin_action": "coin_spent"
}
}
],
"metadata": {
"transactionsCount": 6,
"createdBy": "ShelleyGenesis-1d4f2e1fda43070d",
"size": 9559,
"epochNo": 244,
"slotNo": 20185492
}
}
]
}
}
Transactions¶
/api/txs/last¶
Get information about the N latest transactions.
$ curl $BASEURL/api/txs/last
see JSON response
{
"Right": [
{
"cteId": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"cteTimeIssued": 1610595750,
"cteAmount": {
"getCoin": "979116175"
}
},
{
"cteId": "99ab43fb82ce38864e29af00cd2806d2abc7d72a99ecc1d1e3a3b52ecc43c31f",
"cteTimeIssued": 1610595536,
"cteAmount": {
"getCoin": "989292940"
}
},
{
"cteId": "1e98525288b1330e6e873f1e595b2d090e1f74e78898d9284a8c3aced426d5f9",
"cteTimeIssued": 1610595376,
"cteAmount": {
"getCoin": "994469705"
}
},
{
"cteId": "6268dc17740befdeffb9d9d952afa01b831c605bc418903c7595f20fdad01dd6",
"cteTimeIssued": 1610594096,
"cteAmount": {
"getCoin": "997646470"
}
},
{
"cteId": "1dcdd2827be7eb45e884b093a783b05de8f0b578ecc9e9eb4d636a76e824def7",
"cteTimeIssued": 1610593638,
"cteAmount": {
"getCoin": "999823235"
}
},
{
"cteId": "f7c08043890ef4fbd425764fb5263eb29dffe0f4f3e3cce2ec18b856c41598e8",
"cteTimeIssued": 1610591247,
"cteAmount": {
"getCoin": "3969639296"
}
},
{
"cteId": "ace78170121cca8f5e54b8f011743c03b17cb3d4af36868e6186342cc7920a16",
"cteTimeIssued": 1610590736,
"cteAmount": {
"getCoin": "9983997133111"
}
},
{
"cteId": "e50623e7923bf8b796828a4f303516d0f9b46e3c50e91db07fa5e45e3e409fea",
"cteTimeIssued": 1610583856,
"cteAmount": {
"getCoin": "1000000"
}
},
{
"cteId": "924f31ae1b54b62bda19474c317bd62cb1f9b847cd7b836ce5e2c0d9b7adec1e",
"cteTimeIssued": 1610583241,
"cteAmount": {
"getCoin": "9988997980724"
}
},
{
"cteId": "f94095802cb727457bf61cbb619c329a1c06b608b47eadc844cb095342867738",
"cteTimeIssued": 1610581581,
"cteAmount": {
"getCoin": "4820683"
}
},
{
"cteId": "d0eb47df3a808b8629ba8d57d606e1ea6e724c23911421eea5ce998a04712a93",
"cteTimeIssued": 1610581535,
"cteAmount": {
"getCoin": "200128611870982"
}
},
{
"cteId": "233c7ac393e6edacef112ddc45ebd326d060aca31a6b538f114889072c0f119e",
"cteTimeIssued": 1610581429,
"cteAmount": {
"getCoin": "100056607520356"
}
},
{
"cteId": "0a6c576975e53a1839e4094f6d4cc84cc81e86b7d1ad2ca203bb37210bef7208",
"cteTimeIssued": 1610581215,
"cteAmount": {
"getCoin": "670178176"
}
},
{
"cteId": "10f0f282fa12ec88a19b442ae03525508b1b6eca66cdcb6cece8e153910c3160",
"cteTimeIssued": 1610581136,
"cteAmount": {
"getCoin": "100072004528183"
}
},
{
"cteId": "53bf7f7cf10d4a165a7daa5708cde84ab005b50071b3535d0ce2a73d0f693f21",
"cteTimeIssued": 1610580727,
"cteAmount": {
"getCoin": "9926467248113"
}
},
{
"cteId": "754f6604068cb457af7a468b27babcb28714789f0fdc75a78cafa91608acb7b9",
"cteTimeIssued": 1610580096,
"cteAmount": {
"getCoin": "100056607691709"
}
},
{
"cteId": "0c3ada754aabab097627b185e85bc0d579155ab7faca84200b2fed08d687a93e",
"cteTimeIssued": 1610580016,
"cteAmount": {
"getCoin": "1077645766086"
}
},
{
"cteId": "588ddaf2c6a5c1e15f31e282c589d4422e57083f28030da42d62420ab03085b4",
"cteTimeIssued": 1610579536,
"cteAmount": {
"getCoin": "1000000"
}
},
{
"cteId": "58628178082d005faec360421cff55d31f786f22100586fdbda105da9e6ba03b",
"cteTimeIssued": 1610579216,
"cteAmount": {
"getCoin": "1077645949891"
}
},
{
"cteId": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"cteTimeIssued": 1610575838,
"cteAmount": {
"getCoin": "591707773"
}
}
]
}
query.graphql
query getTxs($limit: Int!) {
transactions(limit: $limit, order_by: { includedAt: desc }) {
hash # cteId
includedAt # cteTimeIssued
outputs_aggregate {
aggregate {
sum {
value # cteAmount
}
}
}
}
}
variables.json
{
"limit": 20
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json'
-H 'Accept: application/json'
--data-binary '{"variables":{"limit":20},"query":"query getTxs($limit: Int!) { transactions(limit: $limit, order_by: { includedAt: desc }) { hash includedAt outputs_aggregate { aggregate { sum { value } } } }}"}'
see JSON response
{
"data": {
"transactions": [
{
"hash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"includedAt": "2021-01-14T03:42:30Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "979116175"
}
}
}
},
{
"hash": "99ab43fb82ce38864e29af00cd2806d2abc7d72a99ecc1d1e3a3b52ecc43c31f",
"includedAt": "2021-01-14T03:38:56Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "989292940"
}
}
}
},
{
"hash": "1e98525288b1330e6e873f1e595b2d090e1f74e78898d9284a8c3aced426d5f9",
"includedAt": "2021-01-14T03:36:16Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "994469705"
}
}
}
},
{
"hash": "6268dc17740befdeffb9d9d952afa01b831c605bc418903c7595f20fdad01dd6",
"includedAt": "2021-01-14T03:14:56Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "997646470"
}
}
}
},
{
"hash": "1dcdd2827be7eb45e884b093a783b05de8f0b578ecc9e9eb4d636a76e824def7",
"includedAt": "2021-01-14T03:07:18Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "999823235"
}
}
}
},
{
"hash": "f7c08043890ef4fbd425764fb5263eb29dffe0f4f3e3cce2ec18b856c41598e8",
"includedAt": "2021-01-14T02:27:27Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "3969639296"
}
}
}
},
{
"hash": "ace78170121cca8f5e54b8f011743c03b17cb3d4af36868e6186342cc7920a16",
"includedAt": "2021-01-14T02:18:56Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "9983997133111"
}
}
}
},
{
"hash": "e50623e7923bf8b796828a4f303516d0f9b46e3c50e91db07fa5e45e3e409fea",
"includedAt": "2021-01-14T00:24:16Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "1000000"
}
}
}
},
{
"hash": "924f31ae1b54b62bda19474c317bd62cb1f9b847cd7b836ce5e2c0d9b7adec1e",
"includedAt": "2021-01-14T00:14:01Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "9988997980724"
}
}
}
},
{
"hash": "f94095802cb727457bf61cbb619c329a1c06b608b47eadc844cb095342867738",
"includedAt": "2021-01-13T23:46:21Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "4820683"
}
}
}
},
{
"hash": "d0eb47df3a808b8629ba8d57d606e1ea6e724c23911421eea5ce998a04712a93",
"includedAt": "2021-01-13T23:45:35Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "200128611870982"
}
}
}
},
{
"hash": "233c7ac393e6edacef112ddc45ebd326d060aca31a6b538f114889072c0f119e",
"includedAt": "2021-01-13T23:43:49Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "100056607520356"
}
}
}
},
{
"hash": "0a6c576975e53a1839e4094f6d4cc84cc81e86b7d1ad2ca203bb37210bef7208",
"includedAt": "2021-01-13T23:40:15Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "670178176"
}
}
}
},
{
"hash": "10f0f282fa12ec88a19b442ae03525508b1b6eca66cdcb6cece8e153910c3160",
"includedAt": "2021-01-13T23:38:56Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "100072004528183"
}
}
}
},
{
"hash": "53bf7f7cf10d4a165a7daa5708cde84ab005b50071b3535d0ce2a73d0f693f21",
"includedAt": "2021-01-13T23:32:07Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "9926467248113"
}
}
}
},
{
"hash": "754f6604068cb457af7a468b27babcb28714789f0fdc75a78cafa91608acb7b9",
"includedAt": "2021-01-13T23:21:36Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "100056607691709"
}
}
}
},
{
"hash": "0c3ada754aabab097627b185e85bc0d579155ab7faca84200b2fed08d687a93e",
"includedAt": "2021-01-13T23:20:16Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "1077645766086"
}
}
}
},
{
"hash": "588ddaf2c6a5c1e15f31e282c589d4422e57083f28030da42d62420ab03085b4",
"includedAt": "2021-01-13T23:12:16Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "1000000"
}
}
}
},
{
"hash": "58628178082d005faec360421cff55d31f786f22100586fdbda105da9e6ba03b",
"includedAt": "2021-01-13T23:06:56Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "1077645949891"
}
}
}
},
{
"hash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"includedAt": "2021-01-13T22:10:38Z",
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "591707773"
}
}
}
}
]
}
}
# Get the current block identifier
$ curl -X POST '$BASEURL/network/status' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": { "blockchain": "cardano", "network": "mainnet" }, "metadata": {} }' | jq .current_block_identifier.index
5264122
# Fetch information from it
$ curl -X POST '$BASEURL/block' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": {"blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "block_identifier": {"index": "5264122" }}'
see JSON response
{
"block": {
"block_identifier": {
"index": 5264122,
"hash": "b5426334221805b3c161ec07b02722728ced7b5c38a9cc60962e819620ecbf9a"
},
"parent_block_identifier": {
"index": 5264121,
"hash": "ff677921d61672d2fb14025f6d8d8b1f93d89266986f045d48ddc674459134ea"
},
"timestamp": 1611751783000,
"transactions": [
{
"transaction_identifier": {
"hash": "2d3d33d26c87d3e8ef0bc6cb25be3fb34f4db43bf23d7c624955a82cd8815772"
},
"operations": [
{
"operation_identifier": {
"index": 0
},
"type": "input",
"status": "success",
"account": {
"address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E"
},
"amount": {
"value": "-4998821898",
"currency": {
"symbol": "ADA",
"decimals": 6
}
},
"coin_change": {
"coin_identifier": {
"identifier": "002da5ef961fd9d826332db916fe7de5e198b8a5f00f9c535f9c329bb14f01e8:0"
},
"coin_action": "coin_spent"
}
}
],
"metadata": {
"transactionsCount": 6,
"createdBy": "ShelleyGenesis-1d4f2e1fda43070d",
"size": 9559,
"epochNo": 244,
"slotNo": 20185492
}
}
]
}
}
/api/txs/summary/{txId}¶
Get summary information about a transaction.
$ curl $BASEURL/api/txs/summary/382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5
see JSON response
{
"Right": {
"ctsId": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"ctsTxTimeIssued": 1610595750,
"ctsBlockTimeIssued": 1610595750,
"ctsBlockHeight": 2225547,
"ctsBlockEpoch": 107,
"ctsBlockSlot": 372134,
"ctsBlockHash": "0b8eac7fc7551cb4a2a4381e12e64997921a751ca9bafaa134092ef396b0c124",
"ctsRelayedBy": null,
"ctsTotalInput": {
"getCoin": "979292940"
},
"ctsTotalOutput": {
"getCoin": "979116175"
},
"ctsFees": {
"getCoin": "176765"
},
"ctsInputs": [
{
"ctaAddress": "addr_test1qq6e9s3ac28mu888k2t5ur0vdntf6s5v5sn28rxwf2agt66h7kkw890p8nmaqpnueyhvdrvvx48auu6wl8c7nctf7x5qpnntdn",
"ctaAmount": {
"getCoin": "979292940"
},
"ctaTxHash": "99ab43fb82ce38864e29af00cd2806d2abc7d72a99ecc1d1e3a3b52ecc43c31f",
"ctaTxIndex": 1
}
],
"ctsOutputs": [
{
"ctaAddress": "addr_test1qqle2e7lluxdhxd7cq2zzrtstgs4kxm0pvy7xa6hr48zyu3s85npa69rf0hqja83fhrw3vjcal3ywtnv7q9pu8hc6nrqw6dy2c",
"ctaAmount": {
"getCoin": "20000000"
},
"ctaTxHash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"ctaTxIndex": 0
},
{
"ctaAddress": "addr_test1qq6e9s3ac28mu888k2t5ur0vdntf6s5v5sn28rxwf2agt66h7kkw890p8nmaqpnueyhvdrvvx48auu6wl8c7nctf7x5qpnntdn",
"ctaAmount": {
"getCoin": "959116175"
},
"ctaTxHash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"ctaTxIndex": 1
}
]
}
}
query.graphql
query getTxSummary($hash: Hash32Hex!) {
transactions(where: { hash: { _eq: $hash } }) {
hash # ctsId
includedAt # ctsTxTimeIssued
fee # ctsFees
block {
epochNo # ctsBlockEpoch
slotNo # ctsBlockSlot
slotInEpoch
number # ctsBlockHeight
hash # ctsBlockHash
}
inputs { # ctsInputs
address # ctaAddress
value # ctaAmount
sourceTxHash # ctaTxHash
sourceTxIndex # ctaTxIndex
}
inputs_aggregate {
aggregate {
sum {
value # ctsTotalInput
}
}
}
outputs { # ctsOutputs
address # ctaAddress
value # ctaAmount
index # ctaTxIndex
txHash # ctaTxHash
}
outputs_aggregate {
aggregate {
sum {
value # ctsTotalOutput
}
}
}
}
}
variables.json
{
"hash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5"
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"hash":"382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5"}, "query":"query getTxSummary($hash: Hash32Hex!) { transactions(where: { hash: { _eq: $hash } }) { hash includedAt fee block { epochNo slotNo slotInEpoch number hash } inputs { address value sourceTxHash sourceTxIndex } inputs_aggregate { aggregate { sum { value } } } outputs { address value index txHash } outputs_aggregate { aggregate { sum { value } } } }}"}'
see JSON response
{
"data": {
"transactions": [
{
"hash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5",
"includedAt": "2021-01-14T03:42:30Z",
"fee": 176765,
"block": {
"epochNo": 107,
"slotNo": 16226534,
"slotInEpoch": 372134,
"number": 2225547,
"hash": "0b8eac7fc7551cb4a2a4381e12e64997921a751ca9bafaa134092ef396b0c124"
},
"inputs": [
{
"address": "addr_test1qq6e9s3ac28mu888k2t5ur0vdntf6s5v5sn28rxwf2agt66h7kkw890p8nmaqpnueyhvdrvvx48auu6wl8c7nctf7x5qpnntdn",
"value": "979292940",
"sourceTxHash": "99ab43fb82ce38864e29af00cd2806d2abc7d72a99ecc1d1e3a3b52ecc43c31f",
"sourceTxIndex": 1
}
],
"inputs_aggregate": {
"aggregate": {
"sum": {
"value": "979292940"
}
}
},
"outputs": [
{
"address": "addr_test1qq6e9s3ac28mu888k2t5ur0vdntf6s5v5sn28rxwf2agt66h7kkw890p8nmaqpnueyhvdrvvx48auu6wl8c7nctf7x5qpnntdn",
"value": "959116175",
"index": 1,
"txHash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5"
},
{
"address": "addr_test1qqle2e7lluxdhxd7cq2zzrtstgs4kxm0pvy7xa6hr48zyu3s85npa69rf0hqja83fhrw3vjcal3ywtnv7q9pu8hc6nrqw6dy2c",
"value": "20000000",
"index": 0,
"txHash": "382a5274ebf102910c6c923a8b11f108e79ecedb5d7433cd0dd15a8a443f0fa5"
}
],
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "979116175"
}
}
}
}
]
}
}
$ curl -X POST '$BASEURL/block/transaction' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": { "blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "block_identifier": { "index": "5264122", "hash": "b5426334221805b3c161ec07b02722728ced7b5c38a9cc60962e819620ecbf9a" }, "transaction_identifier": { "hash": "2d3d33d26c87d3e8ef0bc6cb25be3fb34f4db43bf23d7c624955a82cd8815772"}}'
see JSON response
{
"transaction": {
"transaction_identifier": {
"hash": "2d3d33d26c87d3e8ef0bc6cb25be3fb34f4db43bf23d7c624955a82cd8815772"
},
"operations": [
{
"operation_identifier": {
"index": 0
},
"type": "input",
"status": "success",
"account": {
"address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E"
},
"amount": {
"value": "-4998821898",
"currency": {
"symbol": "ADA",
"decimals": 6
}
},
"coin_change": {
"coin_identifier": {
"identifier": "002da5ef961fd9d826332db916fe7de5e198b8a5f00f9c535f9c329bb14f01e8:0"
},
"coin_action": "coin_spent"
}
},
{
"operation_identifier": {
"index": 1
},
"type": "input",
"status": "success",
"account": {
"address": "DdzFFzCqrhspNxbM9rETXrrW3XL4WcuGgajfxzH3j3R7UQr4AgicTVCMbybX6naYn8ngYAgpGvRyyGecsx26fHgS43a71yUJRmjcdvJE"
},
"amount": {
"value": "-4000000000",
"currency": {
"symbol": "ADA",
"decimals": 6
}
},
"coin_change": {
"coin_identifier": {
"identifier": "0151758ddf6525b9c4fb5dc00a10abb519bff36894716bc1377ba400ae995f28:0"
},
"coin_action": "coin_spent"
}
}
]
}
}
/api/stats/txs¶
Get statistics about transactions.
$ curl $BASEURL/api/stats/txs?page=221444
see JSON response
{
"Right": [
222563,
[
[
"c62c7f356bae7c1397ce5af171c7f884bd5b11eebc62e35f78ff60862004b6a5",
233
]
]
]
}
GraphQL doesn't have pagination. Instead we can specify start and end of block height and achieve the same result.
query.graphql
query getTxsStats($start: Int!, $end: Int!) {
blocks(
order_by: { forgedAt: desc }
where: {
number: { _gte: $start, _lte: $end }
transactionsCount: { _gt: "0" }
}
) {
transactions {
hash
size
}
}
}
variables.json
{
"start": 2214430,
"end": 2214440
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"query":"query getTxsStats($start: Int!, $end: Int!) { blocks( order_by: { forgedAt: desc } where: { number: { _gte: $start, _lte: $end } transactionsCount: { _gt: \"0\" } } ) { transactions { hash size } }}","variables":{"start":2214430,"end":2214440}}'
see JSON response
{
"data": {
"blocks": [
{
"transactions": [
{
"hash": "c62c7f356bae7c1397ce5af171c7f884bd5b11eebc62e35f78ff60862004b6a5",
"size": 233
}
]
}
]
}
}
Warning
No equivalent in Rosetta!
Addresses¶
/api/addresses/summary/{address}¶
Get summary information about an address.
$ curl $BASEURL/api/addresses/summary/addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5
see JSON response
{
"Right": {
"caAddress": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"caType": "CPubKeyAddress",
"caChainTip": {
"ctBlockNo": 2225942,
"ctSlotNo": 16238640,
"ctBlockHash": "8c892cd82dcb7265e0714346961afddc6d2334a8cd46e0607bd512046ac1db0e"
},
"caTxNum": 1,
"caBalance": {
"getCoin": "590707773"
},
"caTotalInput": {
"getCoin": "590707773"
},
"caTotalOutput": {
"getCoin": "0"
},
"caTotalFee": {
"getCoin": "172101"
},
"caTxList": [
{
"ctbId": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctbTimeIssued": 1610575838,
"ctbInputs": [
{
"ctaAddress": "addr_test1qp6dnz3gs84zn7cjx3mrhquj99zfd0acqh9qjldeec9rp4zkvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqs553m2",
"ctaAmount": {
"getCoin": "591879874"
},
"ctaTxHash": "984bf469edee7bcd19ddcf9b7c5cc7e107e10df5061d58dff99d81bb29466094",
"ctaTxIndex": 1
}
],
"ctbOutputs": [
{
"ctaAddress": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"ctaAmount": {
"getCoin": "590707773"
},
"ctaTxHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctaTxIndex": 0
},
{
"ctaAddress": "addr_test1qrlh7p9th5c9ps938ry05vq96j92lzuhqr29v46caydf2wzkvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqt48df3",
"ctaAmount": {
"getCoin": "1000000"
},
"ctaTxHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctaTxIndex": 1
}
],
"ctbInputSum": {
"getCoin": "591879874"
},
"ctbOutputSum": {
"getCoin": "591707773"
},
"ctbFees": {
"getCoin": "172101"
}
}
]
}
}
Warning
The following fields from the REST endpoint have no equivalent: caType, caChainTip.
query.graphql
query getAddressSummary($address: String!) {
caTxNum: transactions_aggregate(
where: {
_or: [
{ inputs: { address: { _eq: $address } } }
{ outputs: { address: { _eq: $address } } }
]
}
) {
aggregate {
count # caTxNum
}
}
caTotalInput: transactions_aggregate(
where: { inputs: { address: { _eq: $address } } }
) {
aggregate {
sum {
totalOutput # caTotalInput
}
}
}
caTotalOutput: transactions_aggregate(
where: { outputs: { address: { _eq: $address } } }
) {
aggregate {
sum {
totalOutput # caTotalOutput
}
}
}
caBalance: utxos_aggregate(where: { address: { _eq: $address } }) {
aggregate {
sum {
value # caBalance
}
}
}
caTxList: transactions(
where: {
_or: [
{ inputs: { address: { _eq: $address } } }
{ outputs: { address: { _eq: $address } } }
]
}
) {
hash # ctbId
includedAt # ctbTimeIssued
fee # ctbFees
inputs(where: { address: { _eq: $address } }) {
# ctbInputs
address # ctaAddress
value # ctaAmount
txHash # ctaTxHash
sourceTxIndex # ctaTxIndex
}
outputs(where: { address: { _eq: $address } }) {
address # ctaAddress
value # ctaAmount
txHash # ctaTxHash
}
inputs_aggregate(where: { address: { _eq: $address } }) {
aggregate {
sum {
value # ctbInputSum
}
}
}
outputs_aggregate(where: { address: { _eq: $address } }) {
aggregate {
sum {
value # ctbOutputSum
}
}
}
}
}
variables.json
{
"address": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5"
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"address":"addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5"},"query":"query getAddressSummary($address: String!) { caTxNum: transactions_aggregate( where: { _or: [ { inputs: { address: { _eq: $address } } } { outputs: { address: { _eq: $address } } } ] } ) { aggregate { count } } transactions_aggregate( where: { inputs: { address: { _eq: $address } } } ) { aggregate { sum { totalOutput } } } caTotalOutput: transactions_aggregate( where: { outputs: { address: { _eq: $address } } } ) { aggregate { sum { totalOutput } } } caBalance: utxos_aggregate(where: { address: { _eq: $address } }) { aggregate { sum { value } } } caTxList: transactions( where: { _or: [ { inputs: { address: { _eq: $address } } } { outputs: { address: { _eq: $address } } } ] } ) { hash includedAt fee inputs(where: { address: { _eq: $address } }) { address value txHash sourceTxIndex } outputs(where: { address: { _eq: $address } }) { address value txHash } inputs_aggregate(where: { address: { _eq: $address } }) { aggregate { sum { value } } } outputs_aggregate(where: { address: { _eq: $address } }) { aggregate { sum { value } } } }}"}'
see JSON response
{
"data": {
"caTxNum": {
"aggregate": {
"count": "1"
}
},
"caTotalInput": {
"aggregate": {
"sum": {
"totalOutput": null
}
}
},
"caTotalOutput": {
"aggregate": {
"sum": {
"totalOutput": "591707773"
}
}
},
"caBalance": {
"aggregate": {
"sum": {
"value": "590707773"
}
}
},
"caTxList": [
{
"hash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"includedAt": "2021-01-13T22:10:38Z",
"fee": 172101,
"inputs": [],
"outputs": [
{
"address": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"value": "590707773",
"txHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196"
}
],
"inputs_aggregate": {
"aggregate": {
"sum": {
"value": null
}
}
},
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "590707773"
}
}
}
}
]
}
}
$ curl -X POST '$BASEURL/account/balance' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": { "blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "account_identifier": { "address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E" }, "metadata": {}}'
see JSON response
{
"block_identifier": {
"index": 5264292,
"hash": "3dc53a1991c70a160666f597c71cb751c2910ef3e14581e699e8011de9fc6839"
},
"balances": [
{
"value": "0",
"currency": {
"symbol": "ADA",
"decimals": 6
}
}
],
"coins": []
}
/api/block/{blockHash}/address/{address}¶
Get address information specific to a block.
$ curl $BASEURL/api/block/02788224fb087d9a5ed48a12a3db741ad7bd4429a63e7e5b6bc69d2f2956d205/address/addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5
see JSON response
{
"Right": {
"caAddress": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"caType": "CPubKeyAddress",
"caChainTip": {
"ctBlockNo": 2225979,
"ctSlotNo": 16239920,
"ctBlockHash": "0ad0938aab4a1db979fa84fc38ca742dd3b1d6ff548e50465fbf9b7a42d0b518"
},
"caTxNum": 1,
"caBalance": {
"getCoin": "590707773"
},
"caTotalInput": {
"getCoin": "590707773"
},
"caTotalOutput": {
"getCoin": "0"
},
"caTotalFee": {
"getCoin": "172101"
},
"caTxList": [
{
"ctbId": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctbTimeIssued": 1610575838,
"ctbInputs": [
{
"ctaAddress": "addr_test1qp6dnz3gs84zn7cjx3mrhquj99zfd0acqh9qjldeec9rp4zkvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqs553m2",
"ctaAmount": {
"getCoin": "591879874"
},
"ctaTxHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctaTxIndex": 1
}
],
"ctbOutputs": [
{
"ctaAddress": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"ctaAmount": {
"getCoin": "590707773"
},
"ctaTxHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctaTxIndex": 0
},
{
"ctaAddress": "addr_test1qrlh7p9th5c9ps938ry05vq96j92lzuhqr29v46caydf2wzkvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqt48df3",
"ctaAmount": {
"getCoin": "1000000"
},
"ctaTxHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"ctaTxIndex": 1
}
],
"ctbInputSum": {
"getCoin": "591879874"
},
"ctbOutputSum": {
"getCoin": "591707773"
},
"ctbFees": {
"getCoin": "172101"
}
}
]
}
}
Warning
This example query only covers a subset of the results returned by cardano-rest
query.graphql
query getAddressBlockSummary($address: String!, $block: Hash32Hex!) {
blocks(where: { hash: { _eq: $block } }) {
transactions_aggregate(
where: {
_or: [
{ inputs: { address: { _eq: $address } } }
{ outputs: { address: { _eq: $address } } }
]
}
) {
aggregate {
count # caTxNum
}
}
transactions(
where: {
_or: [
{ inputs: { address: { _eq: $address } } }
{ outputs: { address: { _eq: $address } } }
]
}
) {
# caTxList
hash # ctbId
includedAt # ctbTimeIssued
fee # ctbFees
inputs(where: { address: { _eq: $address } }) {
address # ctaAddress
value # ctaAmount
txHash # ctaTxHash
sourceTxIndex # ctaTxIndex
}
outputs(where: { address: { _eq: $address } }) {
address # ctaAddress
value # ctaAmount
txHash # ctaTxHash
}
inputs_aggregate(where: { address: { _eq: $address } }) {
aggregate {
sum {
value # ctbInputSum
}
}
}
outputs_aggregate(where: { address: { _eq: $address } }) {
aggregate {
sum {
value # ctbOutputSum
}
}
}
}
}
}
variables.json
{
"address": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"block": "02788224fb087d9a5ed48a12a3db741ad7bd4429a63e7e5b6bc69d2f2956d205"
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"address":"addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5","block":"02788224fb087d9a5ed48a12a3db741ad7bd4429a63e7e5b6bc69d2f2956d205"},"query":"query getAddressBlockSummary($address: String!, $block: Hash32Hex!) { blocks(where: { hash: { _eq: $block } }) { transactions_aggregate( where: { _or: [ { inputs: { address: { _eq: $address } } } { outputs: { address: { _eq: $address } } } ] } ) { aggregate { count } } transactions( where: { _or: [ { inputs: { address: { _eq: $address } } } { outputs: { address: { _eq: $address } } } ] } ) { hash includedAt fee inputs(where: { address: { _eq: $address } }) { address value txHash sourceTxIndex } outputs(where: { address: { _eq: $address } }) { address value txHash } inputs_aggregate(where: { address: { _eq: $address } }) { aggregate { sum { value } } } outputs_aggregate(where: { address: { _eq: $address } }) { aggregate { sum { value } } } } }}"}'
see JSON response
{
"data": {
"blocks": [
{
"transactions_aggregate": {
"aggregate": {
"count": "1"
}
},
"transactions": [
{
"hash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196",
"includedAt": "2021-01-13T22:10:38Z",
"fee": 172101,
"inputs": [],
"outputs": [
{
"address": "addr_test1qrvf30r0e6r8zjzmv22a4r3h8kzj2xf3l2ekezvqd66mcj6kvlatzplcfr8afde6wsr6weskqr8k3u80e957ecmkvkhqrfd5g5",
"value": "590707773",
"txHash": "16e73c7f887825152831eaa656c496aa45f69c755bb6e03a3454555e0c790196"
}
],
"inputs_aggregate": {
"aggregate": {
"sum": {
"value": null
}
}
},
"outputs_aggregate": {
"aggregate": {
"sum": {
"value": "590707773"
}
}
}
}
]
}
]
}
}
$ curl -X POST '$BASEURL/account/balance' \
-H "Content-Type: application/json" \
-d '{ "network_identifier": { "blockchain": "cardano", "network": "mainnet" }, "metadata": {}, "account_identifier": { "address": "DdzFFzCqrhsqKd92VGNM9Ts1Ms62J2FaSRmf8t1bQa1VugDmcUJzeU8TRFnGDDUR6f1m9VaJJG1GfnzxVjKGBbBAVGT9sPBseREYzP3E" }, "metadata": {}, "block_identifier": {"index": "5264122","hash": "b5426334221805b3c161ec07b02722728ced7b5c38a9cc60962e819620ecbf9a" },"currencies": {"symbol": "ada", "decimals": 8 }}'
see JSON response
{
"block_identifier": {
"index": 5264292,
"hash": "3dc53a1991c70a160666f597c71cb751c2910ef3e14581e699e8011de9fc6839"
},
"balances": [
{
"value": "0",
"currency": {
"symbol": "ADA",
"decimals": 6
}
}
],
"coins": []
}
Epochs¶
/api/epochs/{epoch}¶
Get epoch pages, all the paged slots in the epoch.
$ curl $BASEURL/api/epochs/1?page=1
see JSON response
{
"Right": [
2161,
[
{
"cbeEpoch": 1,
"cbeSlot": 9,
"cbeBlkHeight": 20579,
"cbeBlkHash": "af3a74f0fb8a651923ee4dec365925460eed9527a0c4ecae2087e005f0d5a007",
"cbeTimeIssued": 1564431796,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 8,
"cbeBlkHeight": 20578,
"cbeBlkHash": "0edb3f4a743744b907a99c51fe75ef233e1fae585c758dcdd5d32c979b52ab67",
"cbeTimeIssued": 1564431776,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 7,
"cbeBlkHeight": 20577,
"cbeBlkHash": "7bca5147f6818c43c05c008adff93703ef5549ad3a82dc41ab0000c7167fc782",
"cbeTimeIssued": 1564431756,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "a08d73c9dd7f34ae2d68e7631cd80338bc2e88b0c64ed8df52099c91",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 6,
"cbeBlkHeight": 20576,
"cbeBlkHash": "324e4810647798305fef632250fe7f5192edd56bde5f9be5fef48ec0cc505c2d",
"cbeTimeIssued": 1564431736,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "d6ff29d80d4007f5d7b883d34e4b73b04bc128fbe15a69eb75800934",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 5,
"cbeBlkHeight": 20575,
"cbeBlkHash": "226916eec8547355fe9b2696cf2fabbee1a1f056ab5267b4acfe863069e16964",
"cbeTimeIssued": 1564431716,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "42186a6a0079ef39ec0414b69d06ae3526e50b4c4c25d043d357abc8",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 4,
"cbeBlkHeight": 20574,
"cbeBlkHash": "b9de6862957ab26062c31e28d21f42c2cfa1105f10e29972d83879bbf697e84f",
"cbeTimeIssued": 1564431696,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3233,
"cbeBlockLead": "2188aa3235aa3912c6ca9c26a1ada76b5aface7efa2b62078a598e23",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 3,
"cbeBlkHeight": 20573,
"cbeBlkHash": "ef3f7fe64c0790631fee167d4271a4665fd87f06e351918b45f09c4033afed55",
"cbeTimeIssued": 1564431676,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3233,
"cbeBlockLead": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 2,
"cbeBlkHeight": 20572,
"cbeBlkHash": "3898f6d5620bc2bd7ed491737472933ec0b94643e69d30dffa83f48b31d2cd23",
"cbeTimeIssued": 1564431656,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 3233,
"cbeBlockLead": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 1,
"cbeBlkHeight": 20571,
"cbeBlkHash": "51a5d5d52d555942b980023fb808ec99ed8702e37f0d0a44c4ef4e43563b5213",
"cbeTimeIssued": 1564431636,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 1950,
"cbeBlockLead": "0df4205606dcb8adf868cb937e4792a4826eb849193755aa29574af9",
"cbeFees": {
"getCoin": "0"
}
},
{
"cbeEpoch": 1,
"cbeSlot": 0,
"cbeBlkHeight": 20570,
"cbeBlkHash": "10380e7e4a8147427e0f0431d38990c4ad0f90599f080039263f6678170563ce",
"cbeTimeIssued": 1564431616,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "d6ff29d80d4007f5d7b883d34e4b73b04bc128fbe15a69eb75800934",
"cbeFees": {
"getCoin": "0"
}
}
]
]
}
query.graphql
query getEpoch($epoch: Int!, $block_limit: Int!) {
epochs(where: { number: { _eq: $epoch } }) {
number # cbeEpoch
blocks(limit: $block_limit, order_by: { slotNo: asc }) {
slotInEpoch # cbeSlot
number # cbeBlkHeight
hash # cbeBlkHash
slotLeader {
hash # cbeBlockLead
}
forgedAt # cbeTimeIssued
}
startedAt
transactionsCount # cbeTxNum
blocks_aggregate {
aggregate {
sum {
size # cbeSize
fees # cbeFees
}
}
}
output # cbeTotalSent
}
}
variables.json
{
"epoch": 1,
"block_limit": 10
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"epoch":1,"block_limit":10},"query":"query getEpoch($epoch: Int!, $block_limit: Int!) { epochs(where: { number: { _eq: $epoch } }) { number blocks(limit: $block_limit, order_by: { slotNo: asc }) { slotInEpoch number hash slotLeader { hash } forgedAt } startedAt transactionsCount blocks_aggregate { aggregate { sum { size fees } } } output }}"}'
see JSON response
{
"data": {
"epochs": [
{
"number": 1,
"blocks": [
{
"slotInEpoch": 0,
"number": 20570,
"hash": "10380e7e4a8147427e0f0431d38990c4ad0f90599f080039263f6678170563ce",
"slotLeader": {
"hash": "d6ff29d80d4007f5d7b883d34e4b73b04bc128fbe15a69eb75800934"
},
"forgedAt": "2019-07-29T20:20:16Z"
},
{
"slotInEpoch": 1,
"number": 20571,
"hash": "51a5d5d52d555942b980023fb808ec99ed8702e37f0d0a44c4ef4e43563b5213",
"slotLeader": {
"hash": "0df4205606dcb8adf868cb937e4792a4826eb849193755aa29574af9"
},
"forgedAt": "2019-07-29T20:20:36Z"
},
{
"slotInEpoch": 2,
"number": 20572,
"hash": "3898f6d5620bc2bd7ed491737472933ec0b94643e69d30dffa83f48b31d2cd23",
"slotLeader": {
"hash": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829"
},
"forgedAt": "2019-07-29T20:20:56Z"
},
{
"slotInEpoch": 3,
"number": 20573,
"hash": "ef3f7fe64c0790631fee167d4271a4665fd87f06e351918b45f09c4033afed55",
"slotLeader": {
"hash": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829"
},
"forgedAt": "2019-07-29T20:21:16Z"
},
{
"slotInEpoch": 4,
"number": 20574,
"hash": "b9de6862957ab26062c31e28d21f42c2cfa1105f10e29972d83879bbf697e84f",
"slotLeader": {
"hash": "2188aa3235aa3912c6ca9c26a1ada76b5aface7efa2b62078a598e23"
},
"forgedAt": "2019-07-29T20:21:36Z"
},
{
"slotInEpoch": 5,
"number": 20575,
"hash": "226916eec8547355fe9b2696cf2fabbee1a1f056ab5267b4acfe863069e16964",
"slotLeader": {
"hash": "42186a6a0079ef39ec0414b69d06ae3526e50b4c4c25d043d357abc8"
},
"forgedAt": "2019-07-29T20:21:56Z"
},
{
"slotInEpoch": 6,
"number": 20576,
"hash": "324e4810647798305fef632250fe7f5192edd56bde5f9be5fef48ec0cc505c2d",
"slotLeader": {
"hash": "d6ff29d80d4007f5d7b883d34e4b73b04bc128fbe15a69eb75800934"
},
"forgedAt": "2019-07-29T20:22:16Z"
},
{
"slotInEpoch": 7,
"number": 20577,
"hash": "7bca5147f6818c43c05c008adff93703ef5549ad3a82dc41ab0000c7167fc782",
"slotLeader": {
"hash": "a08d73c9dd7f34ae2d68e7631cd80338bc2e88b0c64ed8df52099c91"
},
"forgedAt": "2019-07-29T20:22:36Z"
},
{
"slotInEpoch": 8,
"number": 20578,
"hash": "0edb3f4a743744b907a99c51fe75ef233e1fae585c758dcdd5d32c979b52ab67",
"slotLeader": {
"hash": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829"
},
"forgedAt": "2019-07-29T20:22:56Z"
},
{
"slotInEpoch": 9,
"number": 20579,
"hash": "af3a74f0fb8a651923ee4dec365925460eed9527a0c4ecae2087e005f0d5a007",
"slotLeader": {
"hash": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829"
},
"forgedAt": "2019-07-29T20:23:16Z"
}
],
"startedAt": "2019-07-29T20:20:16Z",
"transactionsCount": "305",
"blocks_aggregate": {
"aggregate": {
"sum": {
"size": "14882059",
"fees": "54105620"
}
}
},
"output": "152336265877919"
}
]
}
}
Warning
No equivalent in Rosetta!
/api/epochs/{epoch}/{slot}¶
Get the slot information in an epoch.
$ curl $BASEURL/api/epochs/1/8
see JSON response
{
"Right": [
{
"cbeEpoch": 1,
"cbeSlot": 8,
"cbeBlkHeight": 20578,
"cbeBlkHash": "0edb3f4a743744b907a99c51fe75ef233e1fae585c758dcdd5d32c979b52ab67",
"cbeTimeIssued": 1564431776,
"cbeTxNum": 0,
"cbeTotalSent": {
"getCoin": "0"
},
"cbeSize": 667,
"cbeBlockLead": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829",
"cbeFees": {
"getCoin": "0"
}
}
]
}
query.graphql
query getSlotInEpoch($epoch: Int!, $slot: Int!) {
epochs(where: { number: { _eq: $epoch } }) {
number # cbeEpoch
blocks(where: { slotInEpoch: { _eq: $slot } }) {
slotInEpoch # cbeSlot
number # cbeBlkHeight
hash # cbeBlkHash
slotLeader {
hash # cbeBlockLead
}
forgedAt # cbeTimeIssued
}
startedAt
transactionsCount # cbeTxNum
blocks_aggregate(where: { slotInEpoch: { _eq: $slot } }) {
aggregate {
sum {
size # cbeSize
fees # cbeFees
}
}
}
output # cbeTotalSent
}
}
variables.json
{
"epoch": 1,
"slot": 8
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"variables":{"epoch":1,"slot":8},"query":"query getSlotInEpoch($epoch: Int!, $slot: Int!) { epochs(where: { number: { _eq: $epoch } }) { number blocks(where: { slotInEpoch: { _eq: $slot } }) { slotInEpoch number hash slotLeader { hash } forgedAt } startedAt transactionsCount blocks_aggregate(where: { slotInEpoch: { _eq: $slot } }) { aggregate { sum { size fees } } } output }}"}'
see JSON response
{
"data": {
"epochs": [
{
"number": 1,
"blocks": [
{
"slotInEpoch": 8,
"number": 20578,
"hash": "0edb3f4a743744b907a99c51fe75ef233e1fae585c758dcdd5d32c979b52ab67",
"slotLeader": {
"hash": "44e51b81adce8430a63c985594cc82b8908e3ab96a4d6b2f33259829"
},
"forgedAt": "2019-07-29T20:22:56Z"
}
],
"startedAt": "2019-07-29T20:20:16Z",
"transactionsCount": "305",
"blocks_aggregate": {
"aggregate": {
"sum": {
"size": "667",
"fees": "0"
}
}
},
"output": "152336265877919"
}
]
}
}
Warning
No equivalent in Rosetta!
Genesis¶
/api/genesis/summary¶
Get information about the genesis block.
$ curl $BASEURL/api/genesis/summary
see JSON response
{
"Right": {
"cgsNumTotal": 207,
"cgsNumRedeemed": 10,
"cgsNumNotRedeemed": 197,
"cgsRedeemedAmountTotal": {
"getCoin": "38060000000000003"
},
"cgsNonRedeemedAmountTotal": {
"getCoin": "3939999999999900"
}
}
}
Warning
This currently is only a partial mapping from REST.
query.graphql
query getGenesisSummary {
genesis {
byron {
avvmDistr
nonAvvmBalances
}
}
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"query":" query getGenesisSummary { genesis { byron { avvmDistr nonAvvmBalances } } }"}'
see JSON response
{
"data": {
"genesis": {
"byron": {
"avvmDistr": {
"CWJf8Kl8Gp-DhcWKuhNRUU9P0_CVI2LmpR1MIMxVgGQ=": "20000000000000",
"h48-GEVDKf_0_vGKzmGOuAOhhIm2uc0OEDSNwFayV28=": "20000000000000",
"PO1Kz9bpAowfWD8u9Ial2OkmxDiw6bK_ICDPvuHshJM=": "20000000000000",
"mqJXwreGLRzV9a--egcVvKN4hzIcNUULsXqcPWe3YXI=": "20000000000000",
"ENoYC3dNAtKL-lvjCTZDVhQYmfyWVtI0GNbz4QKqVdY=": "20000000000000",
...
},
"nonAvvmBalances": {
"37btjrVyb4KEg6anTcJ9E4EAvYtNV9xXL6LNpA15YLhgvm9zJ1D2jwme574HikZ36rKdTwaUmpEicCoL1bDw4CtH5PNcFnTRGQNaFd5ai6Wvo6CZsi": "19999999999999",
"37btjrVyb4KCRtni6YrG77RLPosnDqtEYoAD5xLdKYkWgnLqGa8yuXDUQd3psHrfxqaRcvNTsAW4ngUe6bzstbzSUJtwoaKbYaL8zjFAJJsZkQ42ti": "19999999999999",
"37btjrVyb4KGDMix4Uj5opvbMDgjZYUjeARAqTEFEbgLUH3qyju9gkBpcm2fVWgkcNgK3xFsQgWm1w8zxqvm9P6xJj9mHqLeMJPwDMUKUGPcDyUaDS": "19999999999999",
"37btjrVyb4KEkSeCVx985rXc38DCud2AW4LdasNmyoPLbtDGcDCyYVdf8BzxvDnzPehv4kyVBkzThjVEkSpGTv8PGQs4yRUgiCaKa7PTtBY4ohNGqR": "19999999999999",
"37btjrVyb4KFGS7upvgJHtmp7y7EFB67utzaHf7PM8y8U4tNkpmARNwiD7seN4NSAceHmj64KLGgh9qn1BpYF49NyWxocBHn1N533qBUYfhQar9ceu": "19999999999999",
...
}
}
}
}
}
Warning
No equivalent in Rosetta!
/api/genesis/address/pages/total¶
Info
Neither GraphQL, nor Rosetta are paged, but instead allow to set a limit and an offset to queries.
/api/genesis/address¶
$ curl $BASEURL/api/genesis/address?page=1
see JSON response
{
"Right": [
{
"cgaiCardanoAddress": "2cWKMJemoBai9rXSd5wmGzzYktjNffQ6QaHcMUCtPQgzvjJbDtbLYRYzn4PN4wZTthMue",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBahmj4r84YFn4K7jkJU8FJdicDp1S8JMM49PikC3FqheqEAVwrVgGvB3oN9v",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBajYangUhwh3erpxp4rwUXowLmWppr9Ki6SnGLZsWc1RQptQcVqsHS8p9U1U",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBajRGmZJQE4J4o64AMpA1ZeX2x1FQL6tQj2Bk9qv3cNjazq3rGoXir5Qcrpi",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBakAyWD5Qe7aTftJYWUcJntvnWQiKiQ8MhCEaZY4DD3KStXr73SgCiDqYvhG",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBamAw2b4CPMpJTVt2Jog1b3q6DmbLGjXFMus7ZfizYWBMjYePLMmGcrmK1PD",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBajtE9twqWKPUQLtEU8aDDpYiCPFTS9oc8TfD1YNgViGwXUcS7L9MTGcHjo4",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBaksfAxvNzmtzsJ5VeZqUw85FRfCJAwt8tGR5PCoDCxysZTf615JSqZBACRU",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBaiEHjmRy9GfsgkjWRsaoJuFsk9pCZdKDopmpwhv2Lg83FPDg73AMmdmoBrh",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
},
{
"cgaiCardanoAddress": "2cWKMJemoBaiQKewfpuaQbeqjLeRmYdai9Qt7eXUZPbv4VwK594cSLuGK1ErtZoPgwLuN",
"cgaiGenesisAmount": {
"getCoin": "20000000000000"
},
"cgaiIsRedeemed": false
}
]
}
Warning
This currently is only a partial mapping from REST.
query.graphql
query getGenesisSummary {
genesis {
byron {
avvmDistr
nonAvvmBalances
}
}
}
$ curl "$BASEURL" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
--data-binary '{"query":" query getGenesisSummary { genesis { byron { avvmDistr nonAvvmBalances } } }"}'
see JSON response
{
"data": {
"genesis": {
"byron": {
"avvmDistr": {
"CWJf8Kl8Gp-DhcWKuhNRUU9P0_CVI2LmpR1MIMxVgGQ=": "20000000000000",
"h48-GEVDKf_0_vGKzmGOuAOhhIm2uc0OEDSNwFayV28=": "20000000000000",
"PO1Kz9bpAowfWD8u9Ial2OkmxDiw6bK_ICDPvuHshJM=": "20000000000000",
"mqJXwreGLRzV9a--egcVvKN4hzIcNUULsXqcPWe3YXI=": "20000000000000",
...
},
"nonAvvmBalances": {
"37btjrVyb4KEg6anTcJ9E4EAvYtNV9xXL6LNpA15YLhgvm9zJ1D2jwme574HikZ36rKdTwaUmpEicCoL1bDw4CtH5PNcFnTRGQNaFd5ai6Wvo6CZsi": "19999999999999",
"37btjrVyb4KCRtni6YrG77RLPosnDqtEYoAD5xLdKYkWgnLqGa8yuXDUQd3psHrfxqaRcvNTsAW4ngUe6bzstbzSUJtwoaKbYaL8zjFAJJsZkQ42ti": "19999999999999",
"37btjrVyb4KGDMix4Uj5opvbMDgjZYUjeARAqTEFEbgLUH3qyju9gkBpcm2fVWgkcNgK3xFsQgWm1w8zxqvm9P6xJj9mHqLeMJPwDMUKUGPcDyUaDS": "19999999999999",
"37btjrVyb4KEkSeCVx985rXc38DCud2AW4LdasNmyoPLbtDGcDCyYVdf8BzxvDnzPehv4kyVBkzThjVEkSpGTv8PGQs4yRUgiCaKa7PTtBY4ohNGqR": "19999999999999",
...
}
}
}
}
}
Warning
No equivalent in Rosetta!
/api/supply/ada¶
Get the total ADA supply in the blockchain.
$ curl $BASEURL/api/supply/ada
see JSON response
{
"Right": 42001932863.01618
}
query.graphql
query getAdaSupply {
ada {
supply {
total # corresponds to REST output, total = max - reserves
# additional interesting output
circulating
max
}
}
}
Warning
No equivalent in Rosetta!