Blocks
Get the most recent block number
Returns number of the most recent block.
Sample request
https://api.thespectre.io/api
?module=block
&action=getlatestblockno
&apikey=YourApiKeyToken
Sample response
{
"status": "1",
"message": "OK",
"result": "0x26a8c"
}
Get block header by block number
Returns block header (including hashes of the transactions) by block number.
Sample request
https://api.thespectre.io/api
?module=block
&action=getblockbyno
&blockno=18280000
&apikey=YourApiKeyToken
Request query parameters
blockno*
a nonnegative integer that represents the block number
Sample response
{
"status": "1",
"message": "OK",
"result": {
"baseFeePerGas":"10411041105",
"burntFees":"176619293684458470",
"transactionFees":"218996841561193633",
"difficulty":"0x00",
"extraData":"0x546974616e2028746974616e6275696c6465722e78797a29",
"gasLimit":"0x1c9c380",
"gasTargetPercentage":"13.097429",
"gasUsed":"0x102dc06",
"gasUsedPercentage":"56.548714",
"hash":"0xc7ad1ebaffefaf80fd0684ba17e6f37053ccd3297313ee8ad29bea1d8a1cdc20",
"internalTransactionCount":"597",
"logsBloom":"0x3faf195ce3a1726d9c19e06ba145c8091fce5b0156896845036b8491e832512b0d2001ce8118631bd6161be4823503aa2af1ec6bdb062f1c9e14d72f38683928e30f451c3c250c696a83419ed51260fd268146c74c755a8a87c555518de4407b1f3de802865a8381136e9a95d9c42fd1072a62f1c11896041650971a19ce9ab40b02e2d62e0d11701ecc01c19596909764f705937155714c75ebd07708d10c2393e21163ab81e5642a0549ec10065c9666d8156c253ee39845998e7ad2d257464136490275c5bc722456bd7a3cfeb3d56cb15dcb672c261e2018ba47ac2634f4083df81c9d1c468a116445a6eda83a10a8e6bb00cbd83cc59a84c9a1c0177cb1",
"miner":"0xe688b84b23f322a994a53dbf8e15fa82cdb71127",
"mixHash":"0xe1fd24f0c4984b222d2c9c0b506331750e3e5c0a7ff6318fde30f5adf7f0aaa5",
"nonce":"0x",
"number":"0x116ee40",
"parentHash":"0x37f722468bfe8719d9fbc1b49ed970382c54479ea06ce717493b9ddc3f4bd532",
"receiptsRoot":"0xe1543f318efde33fb32ab7caab3e6d73a59873c17be9de3b75f04301b5fc6091",
"reward":"59436772338192347",
"size":"0x23962",
"stateRoot":"0xcdee4a0c27bd0770d65c42bdfa59dc7c69136ee768431a5cb8a3a2a4693205ea",
"timestamp":"0x651de0a7",
"totalDifficulty":"0x0c70d815d562d3cfa955",
"transactionCount":"189",
"transactionsRoot":"0x46e33cedcedaa4de6747488e50444a779e0327e9f698224c29aeeda724c925a3",
"withdrawalCount":"16",
"confirmations":"2356362"
}
}
Get block header by block hash
Returns block header (including hashes of the transactions) by block hash.
Sample request
https://api.thespectre.io/api
?module=block
&action=getblockbyhash
&blockhash=0xc7ad1ebaffefaf80fd0684ba17e6f37053ccd3297313ee8ad29bea1d8a1cdc20
&apikey=YourApiKeyToken
Request query parameters
blockhash*
hash of contents of the block
Sample response
{
"status": "1",
"message": "OK",
"result": {
"baseFeePerGas":"10411041105",
"burntFees":"176619293684458470",
"transactionFees":"218996841561193633",
"difficulty":"0x00",
"extraData":"0x546974616e2028746974616e6275696c6465722e78797a29",
"gasLimit":"0x1c9c380",
"gasTargetPercentage":"13.097429",
"gasUsed":"0x102dc06",
"gasUsedPercentage":"56.548714",
"hash":"0xc7ad1ebaffefaf80fd0684ba17e6f37053ccd3297313ee8ad29bea1d8a1cdc20",
"internalTransactionCount":"597",
"logsBloom":"0x3faf195ce3a1726d9c19e06ba145c8091fce5b0156896845036b8491e832512b0d2001ce8118631bd6161be4823503aa2af1ec6bdb062f1c9e14d72f38683928e30f451c3c250c696a83419ed51260fd268146c74c755a8a87c555518de4407b1f3de802865a8381136e9a95d9c42fd1072a62f1c11896041650971a19ce9ab40b02e2d62e0d11701ecc01c19596909764f705937155714c75ebd07708d10c2393e21163ab81e5642a0549ec10065c9666d8156c253ee39845998e7ad2d257464136490275c5bc722456bd7a3cfeb3d56cb15dcb672c261e2018ba47ac2634f4083df81c9d1c468a116445a6eda83a10a8e6bb00cbd83cc59a84c9a1c0177cb1",
"miner":"0xe688b84b23f322a994a53dbf8e15fa82cdb71127",
"mixHash":"0xe1fd24f0c4984b222d2c9c0b506331750e3e5c0a7ff6318fde30f5adf7f0aaa5",
"nonce":"0x",
"number":"0x116ee40",
"parentHash":"0x37f722468bfe8719d9fbc1b49ed970382c54479ea06ce717493b9ddc3f4bd532",
"receiptsRoot":"0xe1543f318efde33fb32ab7caab3e6d73a59873c17be9de3b75f04301b5fc6091",
"reward":"59436772338192347",
"size":"0x23962",
"stateRoot":"0xcdee4a0c27bd0770d65c42bdfa59dc7c69136ee768431a5cb8a3a2a4693205ea",
"timestamp":"0x651de0a7",
"totalDifficulty":"0x0c70d815d562d3cfa955",
"transactionCount":"189",
"transactionsRoot":"0x46e33cedcedaa4de6747488e50444a779e0327e9f698224c29aeeda724c925a3",
"withdrawalCount":"16",
"confirmations":"2356362"
}
}
Get an array of block headers by block number range
Returns an array of block headers by block number range (maximum of 20 blocks per call).
Sample request
https://api.thespectre.io/api
?module=block
&action=getblockrange
&startblock=32
&endblock=33
&sort=asc
&apikey=YourApiKeyToken
Request query parameters
startblock*
the integer block number that represents the first number of range
endblock*
the integer block number that represents the last number of range
sort*
the sorting preference, use asc
to sort by ascending and desc
to sort by descending
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"transactionFees":"218996841561193633",
"difficulty": "0x01",
"extraData": "0xd883010101846765746888676f312e31382e32856c696e757800000000000000000000000000000001002817cc25419648d1e49c753138ef6d4e67db506d4626accfb83a14a929f529161158182dbe1209c8aba1e7929e09c08c594eb273ad4d4212cb1ecace66292f9501",
"gasLimit": "0x21ad8ff",
"gasUsed": "0x1b228",
"hash": "0xe12c3f908d1745c383c3f70ba87bdf5c17ac9942818d2d7978b73226de4409dd",
"logsBloom": "0x00000004000000001000000000400000000000000000000000000000000000000000000002000000000000000000000000080000400080000008000000000000000000400000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000100000000000004000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xeba8ddf0ab5dc9320c8ce4a14750293ee4f9b7b9",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x",
"number": "0x20",
"parentHash": "0x548a6e00111ac0695739c664da6b40b7d448901626019749835443cad57bd3ca",
"receiptsRoot": "0x87b2712fcff4c8fdb04ad800a4e9687e21773350bf7045938314f64a431b805c",
"size": "0x31b",
"stateRoot": "0xebdd7d4ee81fd4850aaf0e7012095324857985e066238595312ff00ee1d030f7",
"timestamp": "0x62d047b5",
"totalDifficulty": "0x21",
"transactionsRoot": "0x821fad531e0735fe9bd2829d4b848b49017fbbbd798923ee9c199e46f48f9a95",
"reward": "12000000000000",
"transactionCount": "1",
"internalTransactionCount": "0",
"confirmations":"2356362"
},
{
"transactionFees":"218996841561193633",
"difficulty": "0x01",
"extraData": "0xd883010101846765746888676f312e31382e32856c696e757800000000000000000000000000000001083f3f2f20e1ae171dfea4a4d0c0b94c88d150d09d95380dd23e5b9f7d5a873d8e5f17dbf6da2169abf4b054cd86145ebc41f21fa3d535ea37ab9b3fc8d67f1c9500",
"gasLimit": "0x218c0b3",
"gasUsed": "0x6079",
"hash": "0xdef139f93c797aa55da19e754b705b21b21df3f3f57812028ad1c35d8bb8f1ec",
"logsBloom": "0x00000000000000001000000000400000000000000000000000000000000000000000000002000000000000000000000000280000400080000008000000000000000000400000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000040010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xeba8ddf0ab5dc9320c8ce4a14750293ee4f9b7b9",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x",
"number": "0x21",
"parentHash": "0xe12c3f908d1745c383c3f70ba87bdf5c17ac9942818d2d7978b73226de4409dd",
"receiptsRoot": "0xb4bbc360704afa56678d4d25e4280cd448bd166242c0722e79dd80de843acad4",
"size": "0x31a",
"stateRoot": "0xf326e7a19a4fa308c5394b1dd1a06431b04ccb4e758f5ac593ab6671a0fe83fd",
"timestamp": "0x62d047bb",
"totalDifficulty": "0x22",
"transactionsRoot": "0x747ce12f2c5292cc82580477ec543caf4ee4d3155c44b5c8300f0ff4ac348112",
"reward": "12000000000000",
"transactionCount": "1",
"internalTransactionCount": "0",
"confirmations":"2356362"
}
]
}
Get an array of block headers by number list
Returns an array of block headers by number list (maximum of 20 blocks per call).
Sample request
https://api.thespectre.io/api
?module=block
&action=getblocklist
&blockno=32,33
&sort=asc
&apikey=YourApiKeyToken
Request query parameters
blockno*
the numbers separated by ,
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending, desc
is default
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"transactionFees":"218996841561193633",
"difficulty": "0x01",
"extraData": "0xd883010101846765746888676f312e31382e32856c696e757800000000000000000000000000000001002817cc25419648d1e49c753138ef6d4e67db506d4626accfb83a14a929f529161158182dbe1209c8aba1e7929e09c08c594eb273ad4d4212cb1ecace66292f9501",
"gasLimit": "0x21ad8ff",
"gasUsed": "0x1b228",
"hash": "0xe12c3f908d1745c383c3f70ba87bdf5c17ac9942818d2d7978b73226de4409dd",
"logsBloom": "0x00000004000000001000000000400000000000000000000000000000000000000000000002000000000000000000000000080000400080000008000000000000000000400000000000001000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000100000000000004000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xeba8ddf0ab5dc9320c8ce4a14750293ee4f9b7b9",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x",
"number": "0x20",
"parentHash": "0x548a6e00111ac0695739c664da6b40b7d448901626019749835443cad57bd3ca",
"receiptsRoot": "0x87b2712fcff4c8fdb04ad800a4e9687e21773350bf7045938314f64a431b805c",
"size": "0x31b",
"stateRoot": "0xebdd7d4ee81fd4850aaf0e7012095324857985e066238595312ff00ee1d030f7",
"timestamp": "0x62d047b5",
"totalDifficulty": "0x21",
"transactionsRoot": "0x821fad531e0735fe9bd2829d4b848b49017fbbbd798923ee9c199e46f48f9a95",
"reward": "12000000000000",
"transactionCount": "1",
"internalTransactionCount": "0",
"confirmations":"2356362"
},
{
"transactionFees":"218996841561193633",
"difficulty": "0x01",
"extraData": "0xd883010101846765746888676f312e31382e32856c696e757800000000000000000000000000000001083f3f2f20e1ae171dfea4a4d0c0b94c88d150d09d95380dd23e5b9f7d5a873d8e5f17dbf6da2169abf4b054cd86145ebc41f21fa3d535ea37ab9b3fc8d67f1c9500",
"gasLimit": "0x218c0b3",
"gasUsed": "0x6079",
"hash": "0xdef139f93c797aa55da19e754b705b21b21df3f3f57812028ad1c35d8bb8f1ec",
"logsBloom": "0x00000000000000001000000000400000000000000000000000000000000000000000000002000000000000000000000000280000400080000008000000000000000000400000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000040010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
"miner": "0xeba8ddf0ab5dc9320c8ce4a14750293ee4f9b7b9",
"mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x",
"number": "0x21",
"parentHash": "0xe12c3f908d1745c383c3f70ba87bdf5c17ac9942818d2d7978b73226de4409dd",
"receiptsRoot": "0xb4bbc360704afa56678d4d25e4280cd448bd166242c0722e79dd80de843acad4",
"size": "0x31a",
"stateRoot": "0xf326e7a19a4fa308c5394b1dd1a06431b04ccb4e758f5ac593ab6671a0fe83fd",
"timestamp": "0x62d047bb",
"totalDifficulty": "0x22",
"transactionsRoot": "0x747ce12f2c5292cc82580477ec543caf4ee4d3155c44b5c8300f0ff4ac348112",
"reward": "12000000000000",
"transactionCount": "1",
"internalTransactionCount": "0",
"confirmations":"2356362"
}
]
}
Get block number by block timestamp
Returns block number by the closest timestamp.
Sample request
https://api.thespectre.io/api
?module=block
&action=getblocknobytimestamp
×tamp=1658293068
&closest=after
&apikey=YourApiKeyToken
Request query parameters
timestamp*
a nonnegative integer that represents the block timestamp (Unix timestamp in seconds)
closest*
direction to find the closest block number to given timestamp. Available values: before
and after
Sample response
{
"status": "1",
"message": "OK",
"result": "0x26a8c"
}
Get block account balances changes by block number
Returns all account balances changes in a block by block number.
Sample request
https://api.thespectre.io/api
?module=block
&action=getblockbalancechanges
&blockno=18274635
&apikey=YourApiKeyToken
Request query parameters
blockno*
a nonnegative integer that represents the block number
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"address":"0x4bfa9092250d3f43001d06bc643c3f4d16a52046",
"balance":"0",
"balanceChange":"-2179183350000000000",
"prevChangeBlockNumber": "18271896",
"prevChangeTimeStamp": "1696359011"
},
{
"address":"0x0878968154a84ca6665f2df1cebb0d3ceb5ec04a",
"balance":"19055000000000000",
"balanceChange":"19055000000000000"
}
]
}
Get beacon chain withdrawals by block range
Returns the beacon chain withdrawals.
Sample request
https://api.thespectre.io/api
?module=block
&action=txsBeaconWithdrawal
&startblock=17034877
&endblock=17034877
&sort=desc
&offset=0
&limit=10
&apikey=YourApiKeyToken
Request query parameters
startblock
the integer block number to start searching for transactions, default value is 0
endblock
the integer block number to stop searching for transactions, default value is 1000000000
offset
skips the offset
records before beginning to return the records, default value is 0
limit
the number of records displayed per page, default value is 10000
sort
the sorting preference, use asc
to sort by ascending and desc
to sort by descending, default value is asc
Sample response
{
"status": "1",
"message": "OK",
"result": [
{
"withdrawalIndex": "13",
"validatorIndex": "117823",
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"amount": "3402931175",
"blockNumber": "17034877",
"timestamp": "1681338599"
},
{
"withdrawalIndex": "14",
"validatorIndex": "119023",
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"amount": "3244098967",
"blockNumber": "17034877",
"timestamp": "1681338599"
}
]
}
Last updated