Eticascan API

General

This is an open api to get Etica blockchain data through Eticascan. We recommend to set your own node to get data directly from the blockchain.
Follow this guide to query data from your own Etica node.

Address

Get address balance

Get /apiv1/balance/address/{address}

Example:
https://www.eticascan.org/apiv1/balance/address/0x2a674CC92dE583590f96135F6259553EaAABeD28

response:
{"querysuccess":true,"result":{"eticas":"85000000000000000000","bosoms":"0","egaz":"3000000000000000000"}}

Get last transactions from address

Get /apiv1/etransactions/address/{address}/{nb}

Example: (get address last 25 transactions) | max nb: 1000
https://www.eticascan.org/apiv1/etransactions/address/0x2a674CC92dE583590f96135F6259553EaAABeD28/25

response:
{"querysuccess":true, "result":[{"id":58195,"block_id":791553,"hash":"0x348c04bd44af38d324ef4c120e43e0518b461ab24bfda4c5145affc40973c696", "nonce":"1","blockHash":"0xd420110a818c8569f94985c8a8f3cf6a943018fbcc3a06d173efe7b78663261e", "blockNumber":790442,"transactionIndex":"0","from":"0xC26C921339913E736758054BAdDd568aa5ce1b3B", "to":"0x2a674CC92dE583590f96135F6259553EaAABeD28", "value":"3000000000000000000","gas":21000,"gasPrice":"10000000000","input":"0x","created_at":"2022-08-11T08:05:16.000000Z","updated_at":"2022-08-11T08:05:16.000000Z", "eventtype":1,"eticatransf":null,"status":1,"eticaworth":null,"slashtime":null,"block":{"id":791553,"timestamp":1660205091},"transfers":[]}]}

Get last ETI transfers from address

Get /apiv1/transfers/address/{address}/{nb}

Example: (get address last 25 ETI transfers) | max nb: 1000
https://www.eticascan.org/apiv1/transfers/address/0x2a674CC92dE583590f96135F6259553EaAABeD28/25

response:
{"querysuccess":true, "result":[{"id":96244,"transactionhash":"0xdc768090037ac8b54860953f753cbe19b5d1fcd846265143404485691c53b4da", "from":"0xC26C921339913E736758054BAdDd568aa5ce1b3B","to":"0x2a674CC92dE583590f96135F6259553EaAABeD28", "amount":"85000000000000000000","timestamp":1660205045}]}

Count transactions from address

Get /apiv1/count/etransactions/address/{address}

Example:
https://www.eticascan.org/apiv1/count/etransactions/address/0x2a674CC92dE583590f96135F6259553EaAABeD28

response:
{"querysuccess":true,"result":1}

Blocks

Get last N blocks

Get /apiv1/lastblocks/{nb}

Example: (get last 50 blocks) | max nb: 1000
https://www.eticascan.org/apiv1/lastblocks/50

response:
{"querysuccess":true,"result":[{"id":1063786,"number":1062378,"hash":"0x1025f923dbe4556b5c144539dae7a50d4121b962f86cd02436463684eeeb320b", "parenthash":"0x708eeb7f9c4f42d2ecd45cb7c7b8384f8a31eeeaf33e7082b3007dca715c3aa9", "nonce":"0xbea5bb6f18117f92","sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", "transactionsRoot":"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "stateRoot":"0x47cccdcdb19671635000c412c479b727ce0ea4adbf856c8e964b65d1ecd14071","miner":"0xfDb13a9f6E47Bd964e7Ba09b881733FE430710C2", "difficulty":"50874231085","totalDifficulty":"519374156008350","extraData":"0xdc83010c0288436f72654765746888676f312e31332e38856c696e7578", "size":545,"gasLimit":8000000,"gasUsed":0,"timestamp":1663460363,"created_at":"2022-09-18T00:19:25.000000Z","updated_at":"2022-09-18T00:19:25.000000Z", "nbtxs":null,"etransactions_count":0}]}

Get last block

Get /apiv1/lastblock

Example:
https://www.eticascan.org/apiv1/lastblock

response:
{"querysuccess":true,"result":{"id":1067063,"number":1065655,"hash":"0x561a0e0dfb5444d3ec2594f82a72763e9aac9fd49ea1a38201f1ca5b0c194cf3", "parenthash":"0x3f5c3f23ca2b306475749b9ea26e33e4db2f2cf277de0c469e5153f07fdaa582","nonce":"0xbf00fc396afdda12", "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347","logsBloom":"0x0000000000000000", "transactionsRoot":"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421", "stateRoot":"0xbb5e4ee305770f42262bdd251b41c1f068377697117bb53035f357906d89e3e4", "miner":"0xfDb13a9f6E47Bd964e7Ba09b881733FE430710C2","difficulty":"73439718188", "totalDifficulty":"717875923494998","extraData":"0xdc83010c0288436f72654765746888676f312e31332e38856c696e7578","size":545, "gasLimit":8000000,"gasUsed":0,"timestamp":1663495726,"created_at":"2022-09-18T10:08:56.000000Z","updated_at":"2022-09-18T10:08:56.000000Z","nbtxs":null}}

Get Block by block number

Get /apiv1/block/{blocknumber}

Example: (get Block number 300 000)
https://www.eticascan.org/apiv1/block/300000

response:
{"querysuccess":true,"result":{"id":300169,"number":300000,"hash":"0xf8223ecaecbccb6d5c26f5503aa947e7fc6d0038d3c10404285d3509535633c6", "parenthash":"0x7ba0ffee438fb4e695a7702c6f6ceebefe3e2d7b918ba93fd7c038d9e3a43d10","nonce":"0x62658a06e1283608", "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "logsBloom":"0x0400000...","transactionsRoot":"0x3c8958cd260488683841120e3f6d55c87cb2fab70cdf9ebb02f84c780b7a440e", "stateRoot":"0xf0c9e8f731f4735aa6c3e5dfd4650ad66e90f768872c725aa19f7f926ff96bea","miner":"0x97fCCdAfAD44395ed4f6c4Ca0F8719013FA1C74b", "difficulty":"8180159","totalDifficulty":"3011888984249","extraData":"0xd683010a11846765746886676f312e3138856c696e7578","size":1041, "gasLimit":8023409,"gasUsed":98407,"timestamp":1653986856,"created_at":"2022-05-31T08:47:42.000000Z","updated_at":"2022-05-31T08:47:42.000000Z", "nbtxs":null,"etransactions_count":1}}

Get Block with Transactions

Get /apiv1/blockwithtxs/{blocknumber}

Example: (get Block number 1 100 000)
https://www.eticascan.org/apiv1/blockwithtxs/1100000

response:
{"data":{"id":1101408,"number":1100000,"hash":"0x9a6fe2654388d37d8f655543181cb3df04bb998259e0d10945eef93d5829bca1", "parenthash":"0x9656de027d89cdc8237dd6f8803ca7d014a339d15b6bd99309c4c01830604588","nonce":"0xc36a384d4b62be82", "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "logsBloom":"0x00000000000000000000","transactionsRoot":"0x2ac5909e1593e808237f699a3f028fb664271e2586a664c2922b413e37c8fe4a", "stateRoot":"0xff4b330bb9b65f0d22842309911041faf1b3f10b70d19ccb66333bae01c80b3b","miner":"0xfDb13a9f6E47Bd964e7Ba09b881733FE430710C2", "difficulty":"91271111378","totalDifficulty":"4198690361873766","extraData":"0xdc83010c0288436f72654765746888676f312e31332e38856c696e7578", "size":723,"gasLimit":8000000,"gasUsed":36485,"timestamp":1663934091,"created_at":"2022-09-23T11:55:37.000000Z","updated_at":"2022-09-23T11:55:37.000000Z", "nbtxs":null,"etransactions":[{"id":92496,"block_id":1101408,"hash":"0xd2a4e7d5709768be046b8ba6265ed3f1ff9c0741dec3f38b18f714fb7befaafc","nonce":"45918", "blockHash":"0x9a6fe2654388d37d8f655543181cb3df04bb998259e0d10945eef93d5829bca1","blockNumber":1100000,"transactionIndex":"0", "from":"0x3e457C7F819B7f340A58A3A98b950B61c05B105F","to":"0x34c61EA91bAcdA647269d4e310A86b875c09946f","value":"0","gas":36485,"gasPrice":"1000000000", "input":"0xa9059cbb000000000000000000000000c4d3eab6cb085882f85363e606daaf15bcdfc6f8000000000000000000000000000000000000000000000001f30795e38ed87acc", "created_at":"2022-09-23T11:55:37.000000Z", "updated_at":"2022-09-23T11:55:37.000000Z","eventtype":null,"eticatransf":null,"status":1}]}}

Get Block with Transactions and their ETI transfers

Get /apiv1/blockwithtxs/withetitransfers/{blocknumber}

Example: (get Block number 1 100 000)
https://www.eticascan.org/apiv1/blockwithtxs/withetitransfers/1100000

response:
{"data":{"id":1101408,"number":1100000,"hash":"0x9a6fe2654388d37d8f655543181cb3df04bb998259e0d10945eef93d5829bca1", "parenthash":"0x9656de027d89cdc8237dd6f8803ca7d014a339d15b6bd99309c4c01830604588","nonce":"0xc36a384d4b62be82", "sha3Uncles":"0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347", "logsBloom":"0x00000000000000000000000", "transactionsRoot":"0x2ac5909e1593e808237f699a3f028fb664271e2586a664c2922b413e37c8fe4a", "stateRoot":"0xff4b330bb9b65f0d22842309911041faf1b3f10b70d19ccb66333bae01c80b3b", "miner":"0xfDb13a9f6E47Bd964e7Ba09b881733FE430710C2","difficulty":"91271111378", "totalDifficulty":"4198690361873766","extraData":"0xdc83010c0288436f72654765746888676f312e31332e38856c696e7578", "size":723,"gasLimit":8000000,"gasUsed":36485,"timestamp":1663934091,"created_at":"2022-09-23T11:55:37.000000Z", "updated_at":"2022-09-23T11:55:37.000000Z","nbtxs":null,"etransactions":[{"id":92496,"block_id":1101408, "hash":"0xd2a4e7d5709768be046b8ba6265ed3f1ff9c0741dec3f38b18f714fb7befaafc","nonce":"45918", "blockHash":"0x9a6fe2654388d37d8f655543181cb3df04bb998259e0d10945eef93d5829bca1","blockNumber":1100000, "transactionIndex":"0","from":"0x3e457C7F819B7f340A58A3A98b950B61c05B105F","to":"0x34c61EA91bAcdA647269d4e310A86b875c09946f", "value":"0","gas":36485,"gasPrice":"1000000000","input":"0xa9059cbb000000000000000000000000c4d3eab6cb085882f85363e606daaf15bcdfc6f8000001f30795e38ed87acc", "created_at":"2022-09-23T11:55:37.000000Z","updated_at":"2022-09-23T11:55:37.000000Z","eventtype":null,"eticatransf":"35958874554349681356","status":1, "eticaworth":null,"slashtime":null,"transfers":[{"id":164127,"transactionhash":"0xd2a4e7d5709768be046b8ba6265ed3f1ff9c0741dec3f38b18f714fb7befaafc", "from":"0x3e457C7F819B7f340A58A3A98b950B61c05B105F","to":"0xC4d3Eab6CB085882f85363e606daAF15bcdfC6f8","amount":"35958874554349681356","timestamp":1663934091}]}]}}

Get Blockchain Block height (number blocks)

Get /apiv1/count/blocks

Example:
https://www.eticascan.org/apiv1/count/blocks

response:
{"querysuccess":true,"result":1066474}

Transactions

Get last N transactions

Get /apiv1/lastetransactions/{nb}

Example: (get last 50 transactions) | max nb: 1000
https://www.eticascan.org/apiv1/lastetransactions/50

response:
{"querysuccess":true,"result":[{"id":83211,"block_id":1066681, "hash":"0xa1d3fe31d14ca463a2c45c4e30b70c16464e240a211a66ab60dff01ea1b5f3e9", "nonce":"1484","blockHash":"0x7125594cca70ac902fb8d63bf6e50d7163b43f95b8e15fcaf469daba61a6ee8c", "blockNumber":1065273,"transactionIndex":"0", "from":"0xfDb13a9f6E47Bd964e7Ba09b881733FE430710C2", "to":"0xB5168dE9A8e21eA4326Ac511FA9d3BAc7A021446","value":"15522608349000000000","gas":21000, "gasPrice":"1000000000","input":"0x","created_at":"2022-09-18T09:01:26.000000Z", "updated_at":"2022-09-18T09:01:26.000000Z","eventtype":1, "eticatransf":null,"status":1,"eticaworth":null,"slashtime":null, "block":{"id":1066681,"timestamp":1663491662},"transfers":[]}]}

Get transaction

Get /apiv1/tx/{hash}

Example:
https://www.eticascan.org/apiv1/tx/0xd6682744c0b4be1fb94f779ef63435bbc4780ad3684a0f7c8b377a53836ad5e3

response:
{"querysuccess":true,"result":{"id":80866,"block_id":1049937, "hash":"0xd6682744c0b4be1fb94f779ef63435bbc4780ad3684a0f7c8b377a53836ad5e3","nonce":"53", "blockHash":"0xaf604f5345d5353fdca9fe62258463866102d8242e18afe46aa335d703ad2e89", "blockNumber":1048530, "transactionIndex":"0","from":"0x2232a2bEa41459817aD471a46910ACeCD17Cb19a", "to":"0x34c61EA91bAcdA647269d4e310A86b875c09946f", "value":"0","gas":54535,"gasPrice":"10000000000", "input":"0xa9059cbb0000000000000000000000004ef101828052e3b1340145926be230bda53e112b0000000000000000000000000000000000000000000000056bc75e2d63100000", "created_at":"2022-09-16T07:16:06.000000Z","updated_at":"2022-09-16T07:16:06.000000Z", "eventtype":null,"eticatransf":"100000000000000000000","status":1, "eticaworth":null,"slashtime":null,"block":{"id":1049937,"timestamp":1663312514}, "transfers":[{"id":138917,"transactionhash":"0xd6682744c0b4be1fb94f779ef63435bbc4780ad3684a0f7c8b377a53836ad5e3", "from":"0x2232a2bEa41459817aD471a46910ACeCD17Cb19a","to":"0x4eF101828052E3b1340145926bE230Bda53E112B", "amount":"100000000000000000000","timestamp":1663312514}]}}

Get number transactions

Get /apiv1/count/etransactions

Example:
https://www.eticascan.org/apiv1/count/etransactions

response:
{"querysuccess":true,"result":83210}

Etica (ETI)

Get ETI Supply (raw ETI unit format)

Get /apiv1/etica/rawformat/supply/unit/eti

Example:
https://www.eticascan.org/apiv1/etica/rawformat/supply/unit/eti

response:
"1197638.399283507438198924"

Get ETI Supply (raw format)

Get /apiv1/etica/rawformat/supply

Example:
https://www.eticascan.org/apiv1/etica/rawformat/supply

response:
"1197638399283507438198924"

Get ETI Supply (JSON response)

Get /apiv1/etica/supply

Example:
https://www.eticascan.org/apiv1/etica/supply

response:
{"querysuccess":true,"result":"1197638399283507438198924"}

Get ETI Block reward

Get /apiv1/etica/blockreward

Example:
https://www.eticascan.org/apiv1/etica/blockreward

response:
{"querysuccess":true,"result":"35958874554349681356"}

Get weekly ETI research reward

Get /apiv1/etica/periodrewardtemp

Example:
https://www.eticascan.org/apiv1/etica/periodrewardtemp

response:
{"querysuccess":true,"result":"4027393950087164311900"}

Get total ETI ever mined

Get /apiv1/etica/tokensminted

Example:
https://www.eticascan.org/apiv1/etica/tokensminted

response:
{"querysuccess":true,"result":"1189735323505213557344616"}

Get current Approval threshold

Get /apiv1/etica/threshold

Example:
https://www.eticascan.org/apiv1/etica/threshold

response:
{"querysuccess":true,"result":"5000"}

Mining (ETI)

Get ETI current block number (EpochCount)

Get /apiv1/etica/epochcount

Example:
https://www.eticascan.org/apiv1/etica/epochcount

response:
{"querysuccess": true, "result": "79746"}

Get ETI mining difficulty

Get /apiv1/etica/miningdifficulty

Example:
https://www.eticascan.org/apiv1/etica/miningdifficulty

response:
{"querysuccess": true, "result": "767533"}

Get current ETI challenge number

Get /apiv1/etica/challengenumber

Example:
https://www.eticascan.org/apiv1/etica/challengenumber

response:
{"querysuccess": true, "result": "0x0f12ed715c0557e147c1d8656e6fbf1d40ac039d9ffdb7a252a9c3fba38c736f"}

Get ETI mining target

Get /apiv1/etica/miningtarget

Example:
https://www.eticascan.org/apiv1/etica/miningtarget

response:
{"querysuccess": true, "result": "35125436766431768100035179716530485189326480145050705875027322"}

Get ETI maximum target

Get /apiv1/etica/maximumtarget

Example:
https://www.eticascan.org/apiv1/etica/maximumtarget

response:
{"querysuccess": true, "result": "26959946667150639794667015087019630673637144422540572481103610249216"}

Get ETI minimum target

Get /apiv1/etica/minimumtarget

Example:
https://www.eticascan.org/apiv1/etica/minimumtarget

response:
{"querysuccess": true, "result": "4"}

Get ETI previous difficulty

Get /apiv1/etica/latestdifficultyperiodstarted

Example:
https://www.eticascan.org/apiv1/etica/latestdifficultyperiodstarted

response:
{"querysuccess": true, "result": "1699712779"}

Get last ETI miner address

Get /apiv1/etica/lastrewardto

Example:
https://www.eticascan.org/apiv1/etica/lastrewardto

response:
{"querysuccess": true, "result": "0x3e457C7F819B7f340A58A3A98b950B61c05B105F"}

Get last ETI mint's EGAZ block number

Get /apiv1/etica/lastrewardethblocknumber

Example:
https://www.eticascan.org/apiv1/etica/lastrewardethblocknumber

response:
{"querysuccess": true, "result": "3872859"}

Egaz (EGAZ)

Get EGAZ Supply (raw EGAZ unit format)

Get /apiv1/egaz/rawformat/supply/unit/egaz

Example:
https://www.eticascan.org/apiv1/egaz/rawformat/supply/unit/egaz

response:
"6575331.312416"