Block
Get by Hash
This endpoint retrieves the block details of a given hash.
GET https://api.whatsonchain.com/v1/bsv/<network>/block/hash/<hash>
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb"
{
"hash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
"confirmations": 89,
"size": 14421,
"height": 575045,
"version": 536928256,
"versionHex": "2000e000",
"merkleroot": "4ebcba09addd720991d03473f39dce4b9a72cc164e505cd446687a54df9b1585",
"txcount": 5,
"tx": [
"bb146889d71357667c58a37258f40b0521a6ba7a259fbfa721b747d55567551a",
"c7e8317b48e72644e2b83c87c54f61bcda82326392f969a097fb801aed69b500",
"fd39debc631cf1a97702052fa60303d53062d6f2c1b624ab1f5fc0d20233736f",
"65cb37947ccb7c5b7cc4ac36a200613bfc39a7f7c6c0314a23dbcc5b3908b5b8",
"0f9d562702259822778193ff46f0c6d5e4aa744a433982770d3134e2bf454d10"
],
"time": 1553416668,
"mediantime": 1553414858,
"nonce": 87914848,
"bits": "180997ee",
"difficulty": 114608607557.4425,
"chainwork": "000000000000000000000000000000000000000000ddf5d385546872bab7dc01",
"previousblockhash": "00000000000000000988156c7075dc9147a5b62922f1310862e8b9000d46dd9b",
"nextblockhash": "00000000000000000112b36a37c10235fa0c991f680bc5482ba9692e0ae697db",
"coinbaseTx": {
"hex": "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff220345c6082f626d67706f6f6c2e636f6d2f473173717918707a8aae4a936f101e0000ffffffff018ed9814a000000001976a91485770ad0ee64a4f3ee4027e199c32f876e03a2d988ac00000000",
"txid": "bb146889d71357667c58a37258f40b0521a6ba7a259fbfa721b747d55567551a",
"hash": "bb146889d71357667c58a37258f40b0521a6ba7a259fbfa721b747d55567551a",
"size": 119,
"version": 1,
"locktime": 0,
"vin": [
{
"txid": "",
"vout": 0,
"scriptSig": {
"asm": "",
"hex": ""
},
"sequence": 4294967295,
"coinbase": "0345c6082f626d67706f6f6c2e636f6d2f473173717918707a8aae4a936f101e0000"
}
],
"vout": [
{
"value": 12.50023822,
"n": 0,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 85770ad0ee64a4f3ee4027e199c32f876e03a2d9 OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a91485770ad0ee64a4f3ee4027e199c32f876e03a2d988ac",
"reqSigs": 1,
"type": 0,
"addresses": ["1DAhUiQxHzL1oAusoUDdUM89spXuAG1sqy"],
"opReturn": null
}
}
],
"blockhash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
"confirmations": 89,
"time": 1553416668,
"blocktime": 1553416668
},
"totalFees": 0.0002382199999999557,
"miner": "Bmgpool",
"pages": null
}
URL Parameters
network
Selected network: main or test.
hash
The hash of the block to retrieve
Get by Height
This endpoint retrieves the block details of a given block height.
GET https://api.whatsonchain.com/v1/bsv/<network>/block/height/<height>
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/height/575191"
{
"hash": "0000000000000000091216c46973d82db057a6f9911352892b7769ed517681c3",
"confirmations": 1,
"size": 611,
"height": 575191,
"version": 536870912,
"versionHex": "20000000",
"merkleroot": "95a920b1002bed05379a0d2650bb13eb216138f28ee80172f4cf21048528dc60",
"txcount": 3,
"tx": [
"c1d32f28baa27a376ba977f6a8de6ce0a87041157cef0274b20bfda2b0d8df96",
"7e0ba1980522125f1f40d19a249ab3ae036001b991776813d25aebe08e8b8a50",
"5c4d44b9b8d2ec6e0835ac90f206cecb26bf51033f31d4c659975b7534853409"
],
"time": 1553501874,
"mediantime": 1553499038,
"nonce": 2482491775,
"bits": "180978d5",
"difficulty": 116078424449.9863,
"chainwork": "000000000000000000000000000000000000000000de04fc280ef3a599fbadde",
"previousblockhash": "00000000000000000012ce7f4bbce3346ac438ab7fdcb6fa5440db9857856a7f",
"nextblockhash": "",
"coinbaseTx": {
"hex": "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff1c03d7c6082f7376706f6f6c2e636f6d2f3edff034600055b8467f0040ffffffff01247e814a000000001976a914492558fb8ca71a3591316d095afc0f20ef7d42f788ac00000000",
"txid": "c1d32f28baa27a376ba977f6a8de6ce0a87041157cef0274b20bfda2b0d8df96",
"hash": "c1d32f28baa27a376ba977f6a8de6ce0a87041157cef0274b20bfda2b0d8df96",
"size": 113,
"version": 1,
"locktime": 0,
"vin": [
{
"txid": "",
"vout": 0,
"scriptSig": {
"asm": "",
"hex": ""
},
"sequence": 4294967295,
"coinbase": "03d7c6082f7376706f6f6c2e636f6d2f3edff034600055b8467f0040"
}
],
"vout": [
{
"value": 12.5000042,
"n": 0,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 492558fb8ca71a3591316d095afc0f20ef7d42f7 OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a914492558fb8ca71a3591316d095afc0f20ef7d42f788ac",
"reqSigs": 1,
"type": 0,
"addresses": ["17fm4xevwDh3XRHv9UoqYrVgPMbwcGHsUs"],
"opReturn": null
}
}
],
"blockhash": "0000000000000000091216c46973d82db057a6f9911352892b7769ed517681c3",
"confirmations": 1,
"time": 1553501874,
"blocktime": 1553501874
},
"totalFees": 0.000004199999999343618,
"miner": "SVpool",
"pages": null
}
URL Parameters
network
The selected network: main or test.
height
The height of the block to retrieve.
Get Block Pages
If a block has more than 1000 transactions, the page URLs will be provided in the pages element when getting a block by hash or height.
GET https://api.whatsonchain.com/v1/bsv/<network>/block/hash/<hash>/page/<number>
{
"hash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
...
"pages": {
"uri": [
"/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/1",
"/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/2",
...
],
"size": 50000
}
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/1"
[
"89b4e01ea1ab27edb6ea66899637b526faebeb42ca0302ff9ed916670f1330fe",
"1097bfc9b1f586352a1ab29afd27c1f89e0a5d9790ea08a2b2a7d988ea6f2cfe",
....
]
URL Parameters
network
The selected network: main or test.
hash
The hash of the block to retrieve.
number
The page number.
Get Header by Hash or Height
This endpoint retrieves the block header details of a given hash or height.
Use '?format=block-headers-client' as a query parameter for the block-headers-client response format.
Possible values for the status when the block-headers-client format is requested:
active: Block is a part of the current active chain.
orphaned: Block is not a part of the current active chain.
GET https://api.whatsonchain.com/v1/bsv/<network>/block/<hashOrHeight>/header
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb/header"
{
"hash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
"confirmations": 68461,
"height": 575045,
"version": 536928256,
"versionHex": "2000e000",
"merkleroot": "4ebcba09addd720991d03473f39dce4b9a72cc164e505cd446687a54df9b1585",
"time": 1553416668,
"mediantime": 1553414858,
"nonce": 87914848,
"bits": "180997ee",
"difficulty": 114608607557.4425,
"chainwork": "000000000000000000000000000000000000000000ddf5d385546872bab7dc01",
"previousblockhash": "00000000000000000988156c7075dc9147a5b62922f1310862e8b9000d46dd9b",
"nextblockhash": "00000000000000000112b36a37c10235fa0c991f680bc5482ba9692e0ae697db"
}
URL Parameters
network
The selected network: main or test.
hash
The hash of the block to retrieve.
Get Headers
This endpoint retrieves the last 10 block headers.
GET https://api.whatsonchain.com/v1/bsv/<network>/block/headers
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/headers"
[
{
"hash": "00000000000000000091302d4e60d7f795891ed6355da673bf48179b5d6bb8bf",
"confirmations": 1,
"height": 643505,
"version": 536870912,
"versionHex": "20000000",
"merkleroot": "c842e7a774687c83b801c6e7c00344e9c6691f5ed9512c9b21c752821cb6e11e",
"time": 1594656963,
"mediantime": 1594632849,
"nonce": 1235689794,
"bits": "180322f4",
"difficulty": 350544350572.5941,
"chainwork": "000000000000000000000000000000000000000001115d6ba65662692dd816d6",
"previousblockhash": "000000000000000001a49ccb1c689f0cb2d1a29942ca0631027f9cef221cc5a8",
"nextblockhash": ""
},
{
"hash": "000000000000000001a49ccb1c689f0cb2d1a29942ca0631027f9cef221cc5a8",
"confirmations": 2,
"height": 643504,
"version": 545259520,
"versionHex": "20800000",
"merkleroot": "4b4336460f3f61bfec51608a986f765a9dbd5f9662159cba91a8e7725116cf1d",
"time": 1594653910,
"mediantime": 1594629833,
"nonce": 701438478,
"bits": "1802d84a",
"difficulty": 386482093768.0359,
"chainwork": "000000000000000000000000000000000000000001115d1a07f27698a9ee58d8",
"previousblockhash": "0000000000000000014ad36062380b1d86a84c98fc97eee672f96e3f5f8c2528",
"nextblockhash": "00000000000000000091302d4e60d7f795891ed6355da673bf48179b5d6bb8bf"
},
...
]
URL Parameters
network
The selected network: main or test.
Get Header Bytes File Links
This endpoint retrieves a list of block header binary file links and each file only contains 80-byte block headers. These contain 10,000 block headers per file up to height 760,000.
Then 2,000 blocks per file after height 760,001. New files are automatically created after every 2,000 blocks and added to the list.
GET https://api.whatsonchain.com/v1/bsv/main/block/headers/resources
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/headers/resources"
{"files":[
"https://api.whatsonchain.com/v1/bsv/main/block/headers/0_10000_headers.bin",
"https://api.whatsonchain.com/v1/bsv/main/block/headers/100001_110000_headers.bin",
"https://api.whatsonchain.com/v1/bsv/main/block/headers/110001_120000_headers.bin"
...
]}
Get Latest Header Bytes
This endpoint retrieves the latest specified number of block headers (up to 100) as a binary file. If "count" parameter is not provided, returns the latest header file, with up to 2000 block headers.
GET https://api.whatsonchain.com/v1/bsv/main/block/headers/latest?count=<count>
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/headers/latest?count=10"
URL Parameter
network
The selected network: main.
count (optional)
Number of headers requested, between 1 and 100.
Last updated
Was this helpful?