Status
Status page returns current status of Blockbook and connected backend.
Method: GET
Copy https://dogebook-testnet.nownodes.io/api/ Example response: 200
Copy {
"blockbook": {
"coin": "Dogecoin",
"host": "978ca794d63e",
"version": "devel",
"gitCommit": "89431f5",
"buildTime": "2022-09-16T11:21:44+00:00",
"syncMode": true,
"initialSync": false,
"inSync": true,
"bestHeight": 6135161,
"lastBlockTime": "2024-04-19T13:10:26.492636119Z",
"inSyncMempool": true,
"lastMempoolTime": "2024-04-19T13:10:26.378721319Z",
"mempoolSize": 3,
"decimals": 8,
"dbSize": 13561363476,
"about": "Blockbook - blockchain indexer for Trezor wallet https://trezor.io/. Do not use for any other purpose."
},
"backend": {
"chain": "test",
"blocks": 6135161,
"headers": 6135161,
"bestBlockHash": "54eae80bf9da17e412e76c455b52b5d8ef42b1d0032976bd68c3b0a3cafe0ef2",
"difficulty": "0.002155030673878273",
"sizeOnDisk": 3518547789,
"version": "1140600",
"subversion": "/Shibetoshi:1.14.6/",
"protocolVersion": "70015"
}
} Get block hash
Method: GET
Copy https://dogebook-testnet.nownodes.io/api/v2/block-index/<block height> Example response: 200
Copy {
"blockHash": "54eae80bf9da17e412e76c455b52b5d8ef42b1d0032976bd68c3b0a3cafe0ef2"
} 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
Copy https://dogebook-testnet.nownodes.io/api/v2/tx/<txid> Example response: 200
Copy {
"txid": "5723454de1b819e84095b47a21cf2c987e164d8a4030c97fe2bd3f3cb7c29649",
"version": 1,
"vin": [
{
"sequence": 4294967295,
"n": 0,
"isAddress": false,
"coinbase": "03159d5d"
}
],
"vout": [
{
"value": "1000000000000",
"n": 0,
"hex": "76a914ad15fe0eef614f0600c78568d4a91ede27b19e5188ac",
"addresses": [
"njyMWWyh1L7tSX6QkWRgetMVCVyVtfoDta"
],
"isAddress": true
}
],
"blockHash": "e826c10e9ac6c53df471138ec3d62f81b439f74e576d5c037a6662c044bd7e7c",
"blockHeight": 6135061,
"confirmations": 115,
"blockTime": 1713529210,
"value": "1000000000000",
"valueIn": "0",
"fees": "0",
"hex": "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff0403159d5dffffffff010010a5d4e80000001976a914ad15fe0eef614f0600c78568d4a91ede27b19e5188ac00000000"
} Get transaction specific
Returns transaction data in the exact format as returned by backend, including all coin specific fields:
Method: GET
Copy https://dogebook-testnet.nownodes.io/api/v2/tx-specific/<txid> Example response: 200
Copy {
"hex": "01000000010000000000000000000000000000000000000000000000000000000000000000ffffffff0403159d5dffffffff010010a5d4e80000001976a914ad15fe0eef614f0600c78568d4a91ede27b19e5188ac00000000",
"txid": "5723454de1b819e84095b47a21cf2c987e164d8a4030c97fe2bd3f3cb7c29649",
"hash": "5723454de1b819e84095b47a21cf2c987e164d8a4030c97fe2bd3f3cb7c29649",
"size": 89,
"vsize": 89,
"version": 1,
"locktime": 0,
"vin": [
{
"coinbase": "03159d5d",
"sequence": 4294967295
}
],
"vout": [
{
"value": 10000.00000000,
"n": 0,
"scriptPubKey": {
"asm": "OP_DUP OP_HASH160 ad15fe0eef614f0600c78568d4a91ede27b19e51 OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a914ad15fe0eef614f0600c78568d4a91ede27b19e5188ac",
"reqSigs": 1,
"type": "pubkeyhash",
"addresses": [
"njyMWWyh1L7tSX6QkWRgetMVCVyVtfoDta"
]
}
}
],
"blockhash": "e826c10e9ac6c53df471138ec3d62f81b439f74e576d5c037a6662c044bd7e7c",
"confirmations": 121,
"time": 1713529210,
"blocktime": 1713529210
} Get address
Returns balances and transactions of an address. The returned transactions are sorted by block height, newest blocks first.
Method: GET
Copy https://dogebook-testnet.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
Copy {
"page": 1,
"totalPages": 190,
"itemsOnPage": 1000,
"address": "njyMWWyh1L7tSX6QkWRgetMVCVyVtfoDta",
"balance": "189089152970592016",
"totalReceived": "189186239742501407",
"totalSent": "97086771909391",
"unconfirmedBalance": "0",
"unconfirmedTxs": 0,
"txs": 189194,
"txids": [
"42c2ef2725d61d5693d4fe0a8de950f0ba9fd7af1a8831a26d081b12fa9bc998",
"0737b4e1dfc1a176bc53202f50b07132974f84f709a736091f0e8a383bfd3e53",
"6835f67a06b7eaf92515e20bee4753fd5a04937100196904fb42130399fb8ba8",
"eaf83992df6a836b81431e8c9fd75c5b930d7117022cf7007549e6949a986e14",
"ba8355c30c3d4b874fa7a96bd1d01f7af8c6a258985c1b1ac367578efbce3c4d",
"1e9868b91d684f34e7487a9110251f13766806531dd26d593af05cf5d6088d16",
"18e64e9c80ca31cc296c905b48e319f2b492884fef56e0b4c3729238613e7cbe",
"95214d53ee77d47eeb2a9b522d0189552dda2fb3c5d6606b9db923a971e8500d",
"26e6e218f0fc24f35b650191166d3e63a9c94e9dfa0f4b1de11a78c5b5faa50f",
"be2c5975561f6018323c9f9b3f7ce8054495eb2c790086f2aba1c68d73317178",
"2f1757bfbe5163843fd143429df44ca3d70a1a3c9b6877fa2b9a705418756a1f",
"f276e6b0b0d48672af02b6745eaff29a45366e97f7bb6cb47a3579d29a1eb80c",
"f465dc3253d00c7ac1ead3fbebe8ec26a6e7e44bed6dddd61e113488f2c64bd4",
"d38035702d7e3cfb014eadbc599e9d751114bc62221651d61c404f1368ecc834",
"e38f9f1c5ab32aa811218195a72c7dfb510aef12dc62a88018bc6397d5b77e7c",
"5fc77dcb5a1a12986474c967ef6975891c844b748d9159fda85f8168b6c1b6d6",
"4d64cbf4e87b6f9f3fc31d4d813a88a5e7df39347e45330a51884cbe4e35d028",
"c2653ebe280a0da5074eaf8e4679a36b302e464034f52741f643a0abdd62d67f",
"68b9e03be86b9dd4e8db0fbb1a7e25cedd5aa2e085a161a3ac6598170b5af143",
"e02e671a568801d718ce17b571447ab3ff50771772e242e984f00e96ee171393",
"98f690cd2869892a8b63d27cb7aad178b426409ed49fac358f52794edb79c106",
"e125c3abe071d68678394f6c54e7b171e2a2ea2a38b4040e091b341562d452e2",
"c8bff2d8e35cb0255eb04ec27890454f330099c6157d5226e9bda2a85ee0a8c9",
"6e52443e6b357ec215e2af6d8265fe0475d95abb5d7db9633a8aba7c58fb154a",
"db4f49293fb99b6c14850518e9755417a2d3dc89f608345f81aefd894a00f00d",
"f14edb2d23adb4fbdd80e258ac1f52ab5b237174ec789cb0b5950e318f0a11c0",
"e21f4c3427ed336752d51bf34a542ce34c39a3ab7a44b0bfef22a1e94d1faad4",
"9909da6e57f0a22e252cd77f24184469a14ab22b5723090230ff965ada33d2bc",
"b59ac4ff46bab59d111e44341468b8fdfbb732e0672cc57dcd453ca7359b1576",
"769b0be070eb19581e0639d59a772beb9c5537f40ca240f94636b94790d6415e",
"d6288c8f853d6cfb18517cc8d4de17d0f834b2b0115551abec52cc87dc20b2c9",
"c6d091bfd9e218418193baffae167701dac1586262e87756753625cf2c2a16a4",
"68b25cfc9f5dd818574246b4a321d34c0d33015a45e03144eacafc43fb61bc0b",
"1a8db69f3224b65877c66f41f65ab9f03ca7dd5733e6886462f4d8d88144306a",
"eabfa20e9992a5dbc0c7984d7ed9c460ec74c455d7415eaf3a36d3a231c6d0d4",
"8fbac86ae3ce40d676dad2bd466e04f605b99462c2e344af9dadc54421cd6de9",
"171c3c040510739042b98dc9e859c12fd5c402956f4677643e441f47272808b8",
"9dc64c8bea8990c95d9881c741bc9c53f7eb9bcecab49625f38a3fdcef088682",
... Get xpub
Returns balances and transactions of an xpub or output descriptor, applicable only for Bitcoin-type coins.
Method: GET
Copy https://dogebook-testnet.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
Copy {
"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
Copy https://dogebook-testnet.nownodes.io/api/v2/utxo/<address|xpub|descriptor>[?confirmed=true] Example response: 200
Copy [
{
"txid": "b22c0f3642b7adabe858a281e95fef53a73221c18174887a5758ab8272337756",
"vout": 0,
"value": "1000000000000",
"height": 6135185,
"confirmations": 1,
"coinbase": true
},
{
"txid": "6d901c90f441e90795ae49bcfccdf1d42c18a1940f3e568d242e22e31292dd4d",
"vout": 0,
"value": "1000000000000",
"height": 6135184,
"confirmations": 2,
"coinbase": true
},
{
"txid": "fb7d3322664179f390a2bf4405542de32164fa6d509f6b663aec648e04a10604",
"vout": 0,
"value": "1000000000000",
"height": 6135183,
"confirmations": 3,
"coinbase": true
},
{
"txid": "42c2ef2725d61d5693d4fe0a8de950f0ba9fd7af1a8831a26d081b12fa9bc998",
"vout": 0,
"value": "1000000000000",
"height": 6135182,
"confirmations": 4,
"coinbase": true
},
{
"txid": "0737b4e1dfc1a176bc53202f50b07132974f84f709a736091f0e8a383bfd3e53",
"vout": 0,
"value": "1000000000000",
"height": 6135181,
"confirmations": 5,
"coinbase": true
},
{
"txid": "6835f67a06b7eaf92515e20bee4753fd5a04937100196904fb42130399fb8ba8",
"vout": 0,
"value": "1000000000000",
"height": 6135180,
"confirmations": 6,
"coinbase": true
},
... Get block
Returns information about block with transactions, subject to paging.
Method: GET
Copy https://dogebook-testnet.nownodes.io/api/v2/block/<block height|block hash> Example response: 200
Copy {
"page": 1,
"totalPages": 1,
"itemsOnPage": 1000,
"hash": "94b241dc5dea45d3d110a2ea891539f5e59d4bd8b50807085d8ef91145ebaa8e",
"previousBlockHash": "838272822113120863e6c86e563c396da0e5067fbb0d0eb0b7ed209d429a6e84",
"height": 6135185,
"confirmations": 1,
"size": 170,
"time": 1713532845,
"version": 6422532,
"merkleRoot": "b22c0f3642b7adabe858a281e95fef53a73221c18174887a5758ab8272337756",
"nonce": "585787494",
"bits": "1e0291e9",
"difficulty": "0.001519941183019148",
"txCount": 1,
"txs": [
{
"txid": "b22c0f3642b7adabe858a281e95fef53a73221c18174887a5758ab8272337756",
"vin": [
{
"n": 0,
"isAddress": false,
"value": "0"
}
],
"vout": [
{
"value": "1000000000000",
"n": 0,
"addresses": [
"njyMWWyh1L7tSX6QkWRgetMVCVyVtfoDta"
],
"isAddress": true
}
],
"blockHash": "94b241dc5dea45d3d110a2ea891539f5e59d4bd8b50807085d8ef91145ebaa8e",
"blockHeight": 6135185,
"confirmations": 1,
"blockTime": 1713532845,
"value": "1000000000000",
"valueIn": "0",
"fees": "0"
}
]
} Send transaction
Sends new transaction to backend.
Method: GET
Copy https://dogebook-testet.nownodes.io/api/v2/sendtx/<hex tx data> Example response: 200
Copy {
"result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
} or in case of error
Copy {
"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
Copy https://dogebook-testnet.nownodes.io/api/v2/tickers-list/?timestamp=<timestamp> Example response: 200
Copy {
"error": "No tickers found"
} Balance history
Returns a balance history for the specified XPUB or address.
Method: GET
Copy https://dogebook-testnet.nownodes.io/api/v2/balancehistory/<XPUB|address>?from=<dateFrom>&to=<dateTo>[&fiatcurrency=<currency>&groupBy=<groupBySeconds>] Example response: 200
Copy [
{
"time": 1700398800,
"txs": 14,
"received": "14000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700402400,
"txs": 81,
"received": "81000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700406000,
"txs": 87,
"received": "87000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700409600,
"txs": 60,
"received": "60000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700413200,
"txs": 73,
"received": "73000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700416800,
"txs": 89,
"received": "89000000000000",
"sent": "0",
"sentToSelf": "0"
},
{
"time": 1700420400,
"txs": 71,
"received": "71000000000000",
"sent": "0",
"sentToSelf": "0"
},
...