Links

Block

Get by Hash

This endpoint retrieves the block details of a given hash.
For a block with up to 100 transactions, all transaction ids are returned in response to this call. If a block has more than 100 transactions, only the top 100 transaction ids are returned. To get remaining ids see the 'Get block pages' section.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/block/hash/<hash>
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb"
Response JSON structure
{
"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
Parameter
Description
network
Selected network: main , test or stn
hash
The hash of the block to retrieve

Get by Height

This endpoint retrieves the block details of a given block height.
For a block with up to 100 transactions, all transaction ids are returned in response to this call. If a block has more than 100 transactions, only the top 100 transaction ids are returned. To get remaining ids see the 'Get block pages' section.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/block/height/<height>
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/height/575191"
Response JSON structure
{
"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
Parameter
Description
network
The selected network: main, test, or stn.
height
The height of the block to retrieve.

Get Block Pages

If a block has more than 100 transactions, the page URLs will be provided in the pages element when getting a block by hash or height.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/block/hash/<hash>/page/<number>
Example pages element in Get block by height or hash response:
{
"hash": "000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb",
...
"pages": {
"uri": [
"/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/1",
"/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/2",
...
],
"size": 50000
}
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000000885a4d8e9912f085b42288adc58b3ee5830a7da9f4fef4/page/1"
Response JSON structure
[
"89b4e01ea1ab27edb6ea66899637b526faebeb42ca0302ff9ed916670f1330fe",
"1097bfc9b1f586352a1ab29afd27c1f89e0a5d9790ea08a2b2a7d988ea6f2cfe",
....
]
URL Parameters
Parameter
Description
network
The selected network: main, test, or stn.
hash
The hash of the block to retrieve.
number
The page number.

Get Header by Hash

This endpoint retrieves the block header details of a given hash.
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:
  1. 1.
    active: Block is a part of the current active chain.
  2. 2.
    orphaned: Block is not a part of the current active chain.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/block/<hash>/header
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/000000000000000004a288072ebb35e37233f419918f9783d499979cb6ac33eb/header"
Response JSON structure
{
"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
Parameter
Description
network
The selected network: main, test, or stn.
hash
The hash of the block to retrieve.

Get Headers

This endpoint retrieves the last 10 block headers.
HTTP Request
GET https://api.whatsonchain.com/v1/bsv/<network>/block/headers
cURL
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/headers"
Response JSON structure
[
{
"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
Parameter
Description
network
The selected network: main, test, or stn.