BCH Blockbook
Status
Status page returns current status of Blockbook and connected backend.
Method: GET
https://bchbook.nownodes.io/api/Example response: 200
{
"blockbook": {
"coin": "Bcash",
"host": "2dd8c805f3d0",
"version": "devel",
"gitCommit": "0ebbf16f",
"buildTime": "2023-01-31T14:47:08+00:00",
"syncMode": true,
"initialSync": false,
"inSync": true,
"bestHeight": 840800,
"lastBlockTime": "2024-04-11T10:35:34.517213624Z",
"inSyncMempool": true,
"lastMempoolTime": "2024-04-11T10:36:04.754441356Z",
"mempoolSize": 11,
"decimals": 8,
"dbSize": 159271388746,
"about": "Blockbook - blockchain indexer for Trezor wallet https://trezor.io/. Do not use for any other purpose."
},
"backend": {
"chain": "main",
"blocks": 840800,
"headers": 840800,
"bestBlockHash": "0000000000000000021118988454b6bbf97060ed77dd07995479b018e613f283",
"difficulty": "350084510830.994",
"sizeOnDisk": 228168854853,
"version": "27000000",
"subversion": "/Bitcoin Cash Node:27.0.0(EB32.0)/",
"protocolVersion": "70016"
}
}Get block hash
Method: GET
https://bchbook.nownodes.io/api/v2/block-index/<block height>Example response: 200
{
"blockHash": "0000000000000000021118988454b6bbf97060ed77dd07995479b018e613f283"
}Get transaction
Get transaction returns "normalized" data about transaction, which has the same general structure for all supported coins. It does not return coin specific fields (for example information about Zcash shielded addresses).
Method: GET
https://bchbook.nownodes.io/api/v2/tx/<txid>Example response: 200
{
"txid": "000d1de57f44570814c41ede03779c61f539179c773013545012cefb420c24b9",
"version": 1,
"vin": [
{
"txid": "89cae982b3434a8b31b5ab96a12cfe8ceed70c7802f5cc8a8c2856f9dc35f36c",
"sequence": 4294967295,
"n": 0,
"addresses": [
"bitcoincash:qqx8w7tap7u7hs30mczndlmfnfa8l2jykvyyqqy0lt"
],
"isAddress": true,
"value": "19714772",
"hex": "483045022100ff5e0a663f2831a3178c2400bfcb889a002a5410d40269aae8b2e91fd383c0e902202ffc219665dc195f76cf6fc83de99966d6e493c5c81ab96fc0acc94bdbba922441210340b9ff8973614c195feaab1a04abbe7fc793a29070e489945cf9c8629ea04e5b"
}
],
"vout": [
{
"value": "10000000",
"n": 0,
"hex": "76a9140a0e2c484394a7698ac0bab399933d34bc0ff4da88ac",
"addresses": [
"bitcoincash:qq9qutzggw22w6v2czat8xvn856tcrl5mglxgt4c8q"
],
"isAddress": true
},
{
"value": "9714320",
"n": 1,
"hex": "76a9140c77797d0fb9ebc22fde0536ff699a7a7faa44b388ac",
"addresses": [
"bitcoincash:qqx8w7tap7u7hs30mczndlmfnfa8l2jykvyyqqy0lt"
],
"isAddress": true
},
{
"value": "0",
"n": 2,
"hex": "6a403d3a4253432e424e423a3078374233356645316366394341344344663538383863393439343946316164433531313932363931363a302f312f303a74643a3730",
"addresses": [
"OP_RETURN (=:BSC.BNB:0x7B35fE1cf9CA4CDf5888c94949F1adC511926916:0/1/0:td:70)"
],
"isAddress": false
}
],
"blockHash": "0000000000000000021118988454b6bbf97060ed77dd07995479b018e613f283",
"blockHeight": 840800,
"confirmations": 1,
"blockTime": 1712831710,
"value": "19714320",
"valueIn": "19714772",
"fees": "452",
"hex": "01000000016cf335dcf956288c8accf502780cd7ee8cfe2ca196abb5318b4a43b382e9ca89000000006b483045022100ff5e0a663f2831a3178c2400bfcb889a002a5410d40269aae8b2e91fd383c0e902202ffc219665dc195f76cf6fc83de99966d6e493c5c81ab96fc0acc94bdbba922441210340b9ff8973614c195feaab1a04abbe7fc793a29070e489945cf9c8629ea04e5bffffffff0380969800000000001976a9140a0e2c484394a7698ac0bab399933d34bc0ff4da88ac903a9400000000001976a9140c77797d0fb9ebc22fde0536ff699a7a7faa44b388ac0000000000000000426a403d3a4253432e424e423a3078374233356645316366394341344344663538383863393439343946316164433531313932363931363a302f312f303a74643a373000000000"
}Get transaction specific
Returns transaction data in the exact format as returned by backend, including all coin specific fields:
Method: GET
https://bchbook.nownodes.io/api/v2/tx-specific/<txid>Example response: 200
{
"txid": "000d1de57f44570814c41ede03779c61f539179c773013545012cefb420c24b9",
"hash": "000d1de57f44570814c41ede03779c61f539179c773013545012cefb420c24b9",
"version": 1,
"size": 301,
"locktime": 0,
"vin": [
{
"txid": "89cae982b3434a8b31b5ab96a12cfe8ceed70c7802f5cc8a8c2856f9dc35f36c",
"vout": 0,
"scriptSig": {
"asm": "3045022100ff5e0a663f2831a3178c2400bfcb889a002a5410d40269aae8b2e91fd383c0e902202ffc219665dc195f76cf6fc83de99966d6e493c5c81ab96fc0acc94bdbba9224[ALL|FORKID] 0340b9ff8973614c195feaab1a04abbe7fc793a29070e489945cf9c8629ea04e5b",
"hex": "483045022100ff5e0a663f2831a3178c2400bfcb889a002a5410d40269aae8b2e91fd383c0e902202ffc219665dc195f76cf6fc83de99966d6e493c5c81ab96fc0acc94bdbba922441210340b9ff8973614c195feaab1a04abbe7fc793a29070e489945cf9c8629ea04e5b"
},
"sequence": 4294967295
}
],
"vout": [
{
"value": 0.10000000,
"n": 0,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 0a0e2c484394a7698ac0bab399933d34bc0ff4da OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a9140a0e2c484394a7698ac0bab399933d34bc0ff4da88ac",
"reqSigs": 1,
"type": "pubkeyhash",
"addresses": [
"bitcoincash:qq9qutzggw22w6v2czat8xvn856tcrl5mglxgt4c8q"
]
}
},
{
"value": 0.09714320,
"n": 1,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 0c77797d0fb9ebc22fde0536ff699a7a7faa44b3 OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a9140c77797d0fb9ebc22fde0536ff699a7a7faa44b388ac",
"reqSigs": 1,
"type": "pubkeyhash",
"addresses": [
"bitcoincash:qqx8w7tap7u7hs30mczndlmfnfa8l2jykvyyqqy0lt"
]
}
},
{
"value": 0.00000000,
"n": 2,
"scriptPubKey": {
"asm": "OP_RETURN 3d3a4253432e424e423a3078374233356645316366394341344344663538383863393439343946316164433531313932363931363a302f312f303a74643a3730",
"hex": "6a403d3a4253432e424e423a3078374233356645316366394341344344663538383863393439343946316164433531313932363931363a302f312f303a74643a3730",
"type": "nulldata"
}
}
],
"hex": "01000000016cf335dcf956288c8accf502780cd7ee8cfe2ca196abb5318b4a43b382e9ca89000000006b483045022100ff5e0a663f2831a3178c2400bfcb889a002a5410d40269aae8b2e91fd383c0e902202ffc219665dc195f76cf6fc83de99966d6e493c5c81ab96fc0acc94bdbba922441210340b9ff8973614c195feaab1a04abbe7fc793a29070e489945cf9c8629ea04e5bffffffff0380969800000000001976a9140a0e2c484394a7698ac0bab399933d34bc0ff4da88ac903a9400000000001976a9140c77797d0fb9ebc22fde0536ff699a7a7faa44b388ac0000000000000000426a403d3a4253432e424e423a3078374233356645316366394341344344663538383863393439343946316164433531313932363931363a302f312f303a74643a373000000000",
"blockhash": "0000000000000000021118988454b6bbf97060ed77dd07995479b018e613f283",
"confirmations": 1,
"time": 1712831710,
"blocktime": 1712831710
}Get address
Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.
Method: GET
https://bchbook.nownodes.io/api/v2/address/<address>[?page=<page>&pageSize=<size>&from=<block height>&to=<block height>&details=<basic|tokens|tokenBalances|txids|txs>&contract=<contract address>&secondary=usd]Example response: 200
{
"page": 1,
"totalPages": 1,
"itemsOnPage": 1000,
"address": "bitcoincash:qqx8w7tap7u7hs30mczndlmfnfa8l2jykvyyqqy0lt",
"balance": "363184496",
"totalReceived": "485288718",
"totalSent": "122104222",
"unconfirmedBalance": "0",
"unconfirmedTxs": 0,
"txs": 22,
"txids": [
"000d1de57f44570814c41ede03779c61f539179c773013545012cefb420c24b9",
"89cae982b3434a8b31b5ab96a12cfe8ceed70c7802f5cc8a8c2856f9dc35f36c",
"23d6cb0f30704513a7b997acdf2fa4569d6a0d2b1f8c403f879dca30c0e90945",
"cd1e3d032d5d3272b3e9f6b6ca1204ed3d41648a6b916056678e7ce758b5285e",
"b17a68b25ccf6cc3039205cb053bbb53881b7dbdda2bcb729f7501c0d3d630ea",
"87c6d2275764eefb93650f0f09cd6f1464b4b2336e6301f526a181fe8984d784",
"4332ff036c930469b358c322cd4a4f85972cf01034a3bf7f6bb8fce81a819b14",
"b311bb5c516975fd8fc70259d1d745c754718894e01622c5a5d0e8c1961b225e",
"2c305d906e4b23a6195246c8778ca902ef7fb0e176a1b6cdebc5447757c991c9",
"8d8e003b0e6785dcf271cb19372062ecc14f1dfd41eed4277845354d81663236",
"ad3c0472d51fd7c4c170daeea13a7f62928407184002677b7952d0656eaddcca",
"18bf224f41764107972d6f3ae23d9459bc72fc66299de209aafe85eeef4aa8a9",
"b62a117a5295b03f7887d459a89a92886a5190af85e352c064f78b39aa0fffdf",
"06b5ec64c5204661462075628b435aa50f2c4fe676447c73f848af3b67da9b82",
"dade8c7aa125b264b161aa4fea26e76da83cbc0b556836aa668fcfa95c6dd94b",
"8662d4ad966c68e80b75830957cb17c43502e34a8d4bd1fd1f416869559ddce8",
"a7a60a0b17d3a77447117775e28d73588078466f7ec6515603bb77b04d7ab5bf",
"cbfe2caf93b574cc9a240a146f71301f845a31721c1af2d0abcf78219480ed28",
"4e999e11281c4e6c70cf7eb8efc661cbef649577e5ae40b7406896204e2573a1",
"fa71912a27022a7a2fb8daea6f425e07014b6e77d50f17ba2491623cbf76e029",
"57abcd4998617f75dfa46e3856afa7676090376fdf9028fa20c8ca28bb878fd8",
"98dd5416c96e0e1960b64b8abec7ea912003218d25198181ed638887b5079643"
]
}Get xpub
Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins.
Method: GET
https://bchbook.nownodes.io/api/v2/xpub/<xpub|descriptor>[?page=<page>&pageSize=<size>&from=<block height>&to=<block height>&details=<basic|tokens|tokenBalances|txids|txs>&tokens=<nonzero|used|derived>&secondary=eur]Example response: 200
{
"page": 1,
"totalPages": 1,
"itemsOnPage": 1000,
"address": "xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB",
"balance": "0",
"totalReceived": "0",
"totalSent": "0",
"unconfirmedBalance": "0",
"unconfirmedTxs": 0,
"txs": 0
}Get utxo
Returns array of unspent transaction outputs of address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions. The query parameter confirmed=true disables return of unconfirmed transactions. The returned utxos are sorted by block height, newest blocks first. For xpubs or output descriptors, the response also contains address and derivation path of the utxo.
Unconfirmed utxos do not have field height, the field confirmations has value 0 and may contain field lockTime, if not zero.
Coinbase utxos have field coinbase set to true, however due to performance reasons only up to minimum coinbase confirmations limit (100). After this limit, utxos are not detected as coinbase.
Method: GET
https://bchbook.nownodes.io/api/v2/utxo/<address|xpub|descriptor>[?confirmed=true]Example response: 200
[
{
"txid": "000d1de57f44570814c41ede03779c61f539179c773013545012cefb420c24b9",
"vout": 1,
"value": "9714320",
"height": 840800,
"confirmations": 2
},
{
"txid": "23d6cb0f30704513a7b997acdf2fa4569d6a0d2b1f8c403f879dca30c0e90945",
"vout": 1,
"value": "24060926",
"height": 837314,
"confirmations": 3488
},
{
"txid": "cd1e3d032d5d3272b3e9f6b6ca1204ed3d41648a6b916056678e7ce758b5285e",
"vout": 0,
"value": "26916417",
"height": 835627,
"confirmations": 5175
},
{
"txid": "b17a68b25ccf6cc3039205cb053bbb53881b7dbdda2bcb729f7501c0d3d630ea",
"vout": 4,
"value": "38350239",
"height": 833259,
"confirmations": 7543
},
{
"txid": "87c6d2275764eefb93650f0f09cd6f1464b4b2336e6301f526a181fe8984d784",
"vout": 0,
"value": "26971380",
"height": 830897,
"confirmations": 9905
},
{
"txid": "4332ff036c930469b358c322cd4a4f85972cf01034a3bf7f6bb8fce81a819b14",
"vout": 0,
"value": "31515421",
"height": 829056,
"confirmations": 11746
},
{
"txid": "b311bb5c516975fd8fc70259d1d745c754718894e01622c5a5d0e8c1961b225e",
"vout": 0,
"value": "26065519",
"height": 826740,
"confirmations": 14062
},
{
"txid": "2c305d906e4b23a6195246c8778ca902ef7fb0e176a1b6cdebc5447757c991c9",
"vout": 3,
"value": "38770360",
"height": 824568,
"confirmations": 16234
},
{
"txid": "8d8e003b0e6785dcf271cb19372062ecc14f1dfd41eed4277845354d81663236",
"vout": 0,
"value": "34712486",
"height": 822518,
"confirmations": 18284
},
{
"txid": "ad3c0472d51fd7c4c170daeea13a7f62928407184002677b7952d0656eaddcca",
"vout": 0,
"value": "60900000",
"height": 820073,
"confirmations": 20729
},
{
"txid": "18bf224f41764107972d6f3ae23d9459bc72fc66299de209aafe85eeef4aa8a9",
"vout": 1,
"value": "8792983",
"height": 820069,
"confirmations": 20733
},
{
"txid": "b62a117a5295b03f7887d459a89a92886a5190af85e352c064f78b39aa0fffdf",
"vout": 0,
"value": "12641143",
"height": 818288,
"confirmations": 22514
},
{
"txid": "dade8c7aa125b264b161aa4fea26e76da83cbc0b556836aa668fcfa95c6dd94b",
"vout": 0,
"value": "11084442",
"height": 815138,
"confirmations": 25664
},
{
"txid": "a7a60a0b17d3a77447117775e28d73588078466f7ec6515603bb77b04d7ab5bf",
"vout": 1,
"value": "6484761",
"height": 813551,
"confirmations": 27251
},
{
"txid": "57abcd4998617f75dfa46e3856afa7676090376fdf9028fa20c8ca28bb878fd8",
"vout": 0,
"value": "6204099",
"height": 807256,
"confirmations": 33546
}
]Get block
Returns information about block with transactions, subject to paging.
Method: GET
https://bchbook.nownodes.io/api/v2/block/<block height|block hash>Example response: 200
{
"page": 1,
"totalPages": 1,
"itemsOnPage": 1000,
"hash": "000000000000000001012aaf4b6aa033ddda9d9bbf832b7be597705be5635311",
"previousBlockHash": "00000000000000000187e432f75afc24582887d31b9885db69efae94b270ea93",
"nextBlockHash": "00000000000000000196113373c35c2f408a27ab893bdab66ef717fce6d109e6",
"height": 800000,
"confirmations": 40802,
"size": 12185,
"time": 1688286302,
"version": 543162368,
"merkleRoot": "0bb68dcc462d6112cb64b28deeb5352f61669ebb4f0bd60955ae9cbae1765513",
"nonce": "498838372",
"bits": "18026bd4",
"difficulty": "454110858140.4885",
"txCount": 20,
"txs": [
{
"txid": "fe6dfc32d902377e953f4c78366cc95e916cbcd878660c9848058f615f2d31da",
"vin": [
{
"n": 0,
"isAddress": false,
"value": "0"
}
],
"vout": [
{
"value": "625020602",
"n": 0,
"spent": true,
"addresses": [
"bitcoincash:qq0pg56eg90m7rv6en7l0vv4gpudh8wf3swa0hqsu2"
],
"isAddress": true
}
],
"blockHash": "000000000000000001012aaf4b6aa033ddda9d9bbf832b7be597705be5635311",
"blockHeight": 800000,
"confirmations": 40802,
"blockTime": 1688286302,
"value": "625020602",
"valueIn": "0",
"fees": "0"
},
{
"txid": "02da1a38738ba3ddf4b75f19851a9e93a2fbc1a9e9d6284f77fbbe8b194f7610",
"vin": [
{
"n": 0,
"addresses": [
"bitcoincash:qp9n7uufk83eqzj6d7wgev8m4n0qx355wcz32dhrnk"
],
"isAddress": true,
"value": "90812609818"
}
],
"vout": [
{
"value": "2940936000",
"n": 0,
"spent": true,
"addresses": [
"bitcoincash:qpt950qplfkvkx78547as6svf49wap4tmven8zsksm"
],
"isAddress": true
},
{
"value": "87871673592",
"n": 1,
"spent": true,
"addresses": [
"bitcoincash:qp9n7uufk83eqzj6d7wgev8m4n0qx355wcz32dhrnk"
],
"isAddress": true
}
],
"blockHash": "000000000000000001012aaf4b6aa033ddda9d9bbf832b7be597705be5635311",
"blockHeight": 800000,
"confirmations": 40802,
"blockTime": 1688286302,
"value": "90812609592",
"valueIn": "90812609818",
"fees": "226"
},
...Send transaction
Sends new transaction to backend.
Method: GET
https://bchbook.nownodes.io/api/v2/sendtx/<hex tx data>Example response: 200
{
"result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}or in case of error
{
"error": {
"message": "error message"
}
}Tickers list
Returns a list of available currency rate tickers (secondary currencies) for the specified date, along with an actual data timestamp.
Method: GET
https://bchbook.nownodes.io/api/v2/tickers-list/?timestamp=<timestamp>Example response: 200
{
"error": "No tickers found for date 2023-11-23 09:46:40 +0000 UTC."
}Balance history
Returns a balance history for the specified XPUB or address.
Method: GET
https://bchbook.nownodes.io/api/v2/balancehistory/<XPUB|address>?from=<dateFrom>&to=<dateTo>[&fiatcurrency=<currency>&groupBy=<groupBySeconds>]Example response: 200
[
{
"time": 1692331200,
"txs": 1,
"received": "8662763",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1692694800,
"txs": 1,
"received": "6204099",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1694404800,
"txs": 1,
"received": "28889209",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1695276000,
"txs": 2,
"received": "25343747",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1696406400,
"txs": 1,
"received": "6484761",
"sent": "62895719",
"sentToSelf": "6484761"
},
{
"time": 1696762800,
"txs": 1,
"received": "17920661",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1697367600,
"txs": 1,
"received": "11084442",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1697972400,
"txs": 1,
"received": "21573070",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1699286400,
"txs": 1,
"received": "12641143",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700384400,
"txs": 1,
"received": "8792983",
"sent": "39493731",
"sentToSelf": "8792983"
},
{
"time": 1700388000,
"txs": 1,
"received": "60900000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1701892800,
"txs": 1,
"received": "34712486",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1703156400,
"txs": 1,
"received": "38770360",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1704387600,
"txs": 1,
"received": "26065519",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1705759200,
"txs": 1,
"received": "31515421",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1706875200,
"txs": 1,
"received": "26971380",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1708268400,
"txs": 1,
"received": "38350239",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1709643600,
"txs": 1,
"received": "26916417",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1710662400,
"txs": 1,
"received": "24060926",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1712138400,
"txs": 1,
"received": "19714772",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1712829600,
"txs": 1,
"received": "9714320",
"sent": "19714772",
"sentToSelf": "9714320"
}
]Last updated