Blockchain RPCs
getbestblockhash
Returns the hash of the best (tip) block in the most-work fully-validated chain.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{"jsonrpc": "1.0", "id": "curltest", "method": "getbestblockhash", "params": []}Example response: 200
{
"result": "000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0",
"error": null,
"id": "curltest"
}getblock
If verbosity is 0, returns a string that is serialized, hex-encoded data for block ‘hash’.
If verbosity is 1, returns an Object with information about block ‘hash’. If verbosity is 2, returns an Object with information about block ‘hash’ and information about each transaction.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblock",
"params": [
"000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0"
]
}Example response: 200
{
"result": {
"hash": "000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0",
"confirmations": 1,
"height": 2585857,
"version": 547356672,
"versionHex": "20a00000",
"merkleroot": "cce9a161dc46d8c8f71764fe8fdb366efc909bf51cad41437763f14bb58b39f1",
"time": 1712757644,
"mediantime": 1712755070,
"nonce": 974427767,
"bits": "1926e250",
"difficulty": 110454122.3273832,
"chainwork": "000000000000000000000000000000000000000000000d68384698bd06ac3330",
"nTx": 493,
"previousblockhash": "00000000000000149fc5450d35384d1238e72d9271155d606b45f479a7cba56b",
"strippedsize": 61265,
"size": 139352,
"weight": 323147,
"tx": [
"3c50a7a5445ca47ba982b93cd95ab974b7dc008802050bfc43925c49a4032cdc",
"b75ac6bfb370f2055303a201009fbf85f52abfc295d7a4c15d14d31c8059c962",
"4fbfc35cc2fc23e7ecc47ff828e7c4aee930b16f8613b3914389554cbc0b404b",
"84fcfd018fac1c8485713f6e19537fa53a9548c08d81b92be1a10cc61ff30b0f",
"62a394b66f45eccc71575ba5d8d5377279ad3b0a38b76a1d5eb57c9b1ad37d87",
"5f69d4a8788906457a9838f6cf3877702d19cd8281331c2e0d0ceadcd132382c",
"d321f0467587cce0d35bc51135af756193e0e36c7a5194f7b7f9bb38f95ad9e1",
"dab89af9917c6424d461ec763e1c210d6eb070e02487cc08522ee98099bdd039",
"4a6dcc53219d85d2c19b337314d43145a33dfba763c6339a3abd1e74490bc33f",
"12fb09ee25db17742259f30dc1492162224db18afd605c5e300c1f89a628415a",
"a036d89acb7669e4d9545d2c8272193a29c9aeffea6966552dace755d1c80fce",
"ec2e5745cacf0aed986c25350798a605c6f17c19ff3f168bcedb1002840a2568",
"64f29f8e7788477047ebf0f4b33672e27a58cddb9e83b5a0504d80e91f9960b4",
"088c500efb40e3410364262ad11d8b93b866f57859653536ac815dd0bc005196",
"45d2b5b676a42565f35739fc1d6745fc2f282404e21013fad2a2856d06c37dff",
"1cbd3ea053ff881f9493480bda16a7a9b8df2c609d3767c4d8b9ac4eda66aab4",
"ae3d88badeec76fddb8f86fff742121d2dd8b08592362e8a1872a319e38bbb70",
"212a99b5bda54d819da1c9a0cea921b3ae66452723d4294ead7acfdcf54a64c3",
"b55a1672f3c6afa10e2bac62c69f5607df6065dd6d25225378cff9a49ff9d5e6",
"fe402fcf7ff2a2b245f9f84776668c6eb205bf95b4578411c87b25c4dbc437c7",
"caf5482cdad8d863603741727503a1aa55d165c5255395c1d3fa4a93e68ba6f8",
"1861db8e61390c491aaf876c42803907ded3f42e1f7c7ddcc3e3d05308f039d9",
"3a6462cf4a93345d6528699ef0e22a3cc93d0a43969619e69dc211f6ad8be033",
"1194a31eaab27f958a17c346ab884d938f8b8637826608527f53bbfefd2854de",
"11eb64ecf6baf41b2360465fa8b8dc97e8608be5d9a8ce9449133c5c7f6f8b83",
"a9b5d0805b9ca6d8be30c444dafe8456bb36cd6696eadb34f1d99c2449cbaf25",
"a8e57a62b9728d9dd4da7ef16522dcc9c1b3628e34b0f51f4021e3d666010d9a",
"1cd66788f4b1c07f1f5a39b92d63233f39999567472de0079626b1f2ffa77ce3",
"8b6d665253ff8a4fc1d328ef88e90584450e68f0fa871b8cf36311336a8cbbc0",
"4b136d8a914526b74b56bf3207558d4613b1cb058fdf1df2f6e6ad3f8a7c2085",
...getblockchaininfo
Returns an object containing various state info regarding blockchain processing.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockchaininfo",
"params": []
}Example response: 200
{
"result": {
"chain": "test",
"blocks": 2585857,
"headers": 2585857,
"bestblockhash": "000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0",
"difficulty": 110454122.3273832,
"time": 1712757644,
"mediantime": 1712755070,
"verificationprogress": 0.9999986842687764,
"initialblockdownload": false,
"chainwork": "000000000000000000000000000000000000000000000d68384698bd06ac3330",
"size_on_disk": 37088221416,
"pruned": false,
"warnings": "Unknown new rules activated (versionbit 28)"
},
"error": null,
"id": "curltest"
}getblockcount
Returns the height of the most-work fully-validated chain.
The genesis block has height 0.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockcount",
"params": []
}Example response: 200
{
"result": 2585857,
"error": null,
"id": "curltest"
}getblockfilter
Retrieve a BIP 157 content filter for a particular block.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockfilter",
"params": [
"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
"basic"
]
}Example response: 200
{
"result": null,
"error": {
"code": -1,
"message": "Index is not enabled for filtertype basic"
},
"id": "curltest"
}getblockhash
Returns hash of block in best-block-chain at height provided.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockhash",
"params": [
1000
]
}Example response: 200
{
"result": "00000000373403049c5fff2cd653590e8cbe6f7ac639db270e7d1a7503d698df",
"error": null,
"id": "curltest"
}getblockheader
If verbose is false, returns a string that is serialized, hex-encoded data for blockheader ‘hash’.
If verbose is true, returns an Object with information about blockheader ‘hash’.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockheader",
"params": [
"000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0"
]
}Example response: 200
{
"result": {
"hash": "000000000000001e41c5a08fc1e0177f42e60c6ceff8fd746c900bed85585eb0",
"confirmations": 1,
"height": 2585857,
"version": 547356672,
"versionHex": "20a00000",
"merkleroot": "cce9a161dc46d8c8f71764fe8fdb366efc909bf51cad41437763f14bb58b39f1",
"time": 1712757644,
"mediantime": 1712755070,
"nonce": 974427767,
"bits": "1926e250",
"difficulty": 110454122.3273832,
"chainwork": "000000000000000000000000000000000000000000000d68384698bd06ac3330",
"nTx": 493,
"previousblockhash": "00000000000000149fc5450d35384d1238e72d9271155d606b45f479a7cba56b"
},
"error": null,
"id": "curltest"
}getblockstats
Compute per block statistics for a given window. All amounts are in satoshis.
It won’t work for some heights with pruning.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockstats",
"params": [
1000,
[
"minfeerate",
"avgfeerate"
]
]
}Example response: 200
{
"result": {
"avgfeerate": 0,
"minfeerate": 0
},
"error": null,
"id": "curltest"
}getchaintips
Return information about all known tips in the block tree, including the main chain as well as orphaned branches.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintips",
"params": []
}Example response: 200
{
"result": [
{
"height": 2585858,
"hash": "000000000000001e7c9c1c0c87b7b6ae98176df9c1faa4f09dc571bc70e00a31",
"branchlen": 0,
"status": "active"
},
{
"height": 2585505,
"hash": "000000000015aa72dfef49de344f672e749fc3a2336eddeb135ac2cbf3268042",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 2585263,
"hash": "0000000000004e8e0040a61b16884cfe1fdb12eb1b1877eed0bce22791af9bc8",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 2584935,
"hash": "00000000000035d77d5afa18467f7a443b19f2486da765c2d38dc2925ace7f58",
"branchlen": 2,
"status": "valid-fork"
},
{
"height": 2584132,
"hash": "00000000000fa96495a47b31cdcb76d728d9bd1ea2b30d439dc0953296afdeab",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 2582802,
"hash": "00000000008bb8d8cd04c95d1b479b349dddc8eb91568cf8108e1e188b37bd77",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 2582753,
"hash": "00000000007917c0252b1983228bcb928bde41370a6692a2568d0ddb0bd9fbe8",
"branchlen": 2,
"status": "valid-fork"
},
{
"height": 2582645,
"hash": "0000000000e714e4b1a4e48c9fe3aa93929fe8b6d2ab801f8952dddf3c21c75f",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 2582448,
"hash": "0000000000ca775f2aed3a8adedc0f2e28ddb30d625f66dc9e1efbba6a5c23a3",
"branchlen": 1,
"status": "valid-fork"
},
...getchaintxstats
Compute statistics about the total number and rate of transactions in the chain.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintxstats",
"params": [
2016
]
}Example response: 200
{
"result": {
"time": 1712758452,
"txcount": 75724625,
"window_final_block_hash": "000000000000001e7c9c1c0c87b7b6ae98176df9c1faa4f09dc571bc70e00a31",
"window_final_block_height": 2585858,
"window_block_count": 2016,
"window_tx_count": 820911,
"window_interval": 1205517,
"txrate": 0.6809617782246123
},
"error": null,
"id": "curltest"
}getdifficulty
Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getdifficulty",
"params": []
}Example response: 200
{
"result": 110454122.3273832,
"error": null,
"id": "curltest"
}getmempoolancestors
If txid is in the mempool, returns all in-mempool ancestors.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getmempoolancestors",
"params": [
"mytxid"
]
}Example response: 200
{
"result": null,
"error": {
"code": -8,
"message": "parameter 1 must be of length 64 (not 6, for 'mytxid')"
},
"id": "curltest"
}getmempooldescendants
If txid is in the mempool, returns all in-mempool descendants.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getmempooldescendants",
"params": [
"mytxid"
]
}Example response: 200
{
"result": null,
"error": {
"code": -8,
"message": "parameter 1 must be of length 64 (not 6, for 'mytxid')"
},
"id": "curltest"
}getmempoolentry
Returns mempool data for given transaction
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getmempoolentry",
"params": [
"mytxid"
]
}Example response: 200
{
"result": null,
"error": {
"code": -8,
"message": "parameter 1 must be of length 64 (not 6, for 'mytxid')"
},
"id": "curltest"
}getmempoolinfo
Returns details on the active state of the TX memory pool.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getmempoolinfo",
"params": []
}Example response: 200
{
"result": {
"loaded": true,
"size": 1099,
"bytes": 185113,
"usage": 1572688,
"total_fee": 0.01518901,
"maxmempool": 2000000000,
"mempoolminfee": 0.00001000,
"minrelaytxfee": 0.00001000,
"incrementalrelayfee": 0.00001000,
"unbroadcastcount": 0,
"fullrbf": false
},
"error": null,
"id": "curltest"
}getrawmempool
Returns all transaction ids in memory pool as a json array of string transaction ids.
Hint: use getmempoolentry to fetch a specific transaction from the mempool.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getrawmempool",
"params": [
true
]
}Example response: 200
{
"result": {
"87708ccea544674bbe25dff7746229e72487c5c04f0af2ddefe7c1a0a7b59158": {
"vsize": 225,
"weight": 900,
"time": 1712758589,
"height": 2585858,
"descendantcount": 1,
"descendantsize": 225,
"ancestorcount": 1,
"ancestorsize": 225,
"wtxid": "87708ccea544674bbe25dff7746229e72487c5c04f0af2ddefe7c1a0a7b59158",
"fees": {
"base": 0.00060000,
"modified": 0.00060000,
"ancestor": 0.00060000,
"descendant": 0.00060000
},
"depends": [],
"spentby": [],
"bip125-replaceable": false,
"unbroadcast": false
},
"90eca835459b5a28aa4ec8a8c81f9b0ff638d6ba38afbc9c79615d7631579014": {
"vsize": 164,
"weight": 654,
"time": 1712758460,
"height": 2585858,
"descendantcount": 1,
"descendantsize": 164,
"ancestorcount": 1,
"ancestorsize": 164,
"wtxid": "b9e6a2ad234b9925bb04bbbe9992f5538630fa144b3549cc2fbaf75b8877fc68",
"fees": {
"base": 0.00014904,
"modified": 0.00014904,
"ancestor": 0.00014904,
"descendant": 0.00014904
},
"depends": [],
"spentby": [],
"bip125-replaceable": true,
"unbroadcast": false
},
"0d54a21f580ad3af8574bd028caeacfe62de6d5129a009a031359e4844336dd3": {
"vsize": 154,
"weight": 616,
"time": 1712758533,
"height": 2585858,
"descendantcount": 2,
"descendantsize": 318,
"ancestorcount": 1,
"ancestorsize": 154,
"wtxid": "4ea15b527ce5775d9c7c2085e28a4f5c6593378646616bdcea869d4238c6b066",
"fees": {
"base": 0.00010626,
"modified": 0.00010626,
"ancestor": 0.00010626,
"descendant": 0.00025530
},
"depends": [],
"spentby": [
"e0b7e0ed52e1fc93613c939f1e37783991b0d46598a6c87f966fd3365653ff84"
],
"bip125-replaceable": false,
"unbroadcast": false
},
...gettxout
Returns details about an unspent transaction output.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "gettxout",
"params": [
"txid",
1
]
}Example response: 200
{
"result": null,
"error": {
"code": -8,
"message": "txid must be of length 64 (not 4, for 'txid')"
},
"id": "curltest"
}gettxoutproof
Returns a hex-encoded proof that “txid” was included in a block.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "gettxoutproof",
"params": [
[
"3c50a7a5445ca47ba982b93cd95ab974b7dc008802050bfc43925c49a4032cdc",
"b75ac6bfb370f2055303a201009fbf85f52abfc295d7a4c15d14d31c8059c962"
],
null
]
}Example response: 200
{
"result": "0000a0206ba5cba779f4456b605d1571922de738124d38350d45c59f1400000000000000f1398bb54bf163774341ad1cf59b90fc6e36db8ffe6417f7c8d846dc61a1e9cc8c9b166650e226197796143aed0100000adc2c03a4495c9243fc0b05028800dcb774b95ad93cb982a97ba45c44a5a7503c62c959801cd3145dc1a4d795c2bf2af585bf9f0001a2035305f270b3bfc65ab7c775c4c5a2cdf25309599c3db28b274b0cb6d4ee0aa65e28dde1a5d0b55588055032873f7a35a92ae4e77ac4a33db72e040f6866834ca9f4a8b28a35e8e0df936ab3be6d662cd0601f5bc0b40ede97ffb11b309c44ae03d091a1c1128061c701fbc6117da4df84a176f4ae976b7c0decdb558176603b89318b40ac5a007e4596fbd1f7c799c1c3845ade5309f0b5a7cda8819f06f50fce95b93f4e813d7ba4b8cbf4f77774b2c5cb835531b2a06fa4eb373b939e297079102612b1ba4c921d1ce15b2843ed12bc39a59755da7239199c0cafc2e079150f0f558a317e26fad206431cf71692154d9b8a50a7044d05417f3f49b26d00064b59bb1a863c5ebeaa8c03ff0700",
"error": null,
"id": "curltest"
}gettxoutsetinfo
Returns statistics about the unspent transaction output set.
Note this call may take some time.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{"jsonrpc": "1.0", "id": "curltest", "method": "gettxoutsetinfo", "params": []}Example response: 200
{
"result": {
"height": 2585858,
"bestblock": "000000000000001e7c9c1c0c87b7b6ae98176df9c1faa4f09dc571bc70e00a31",
"txouts": 38855987,
"bogosize": 2919211905,
"hash_serialized_3": "784594fc723b039f05347e8dad17cc28d13e8f5c72b15bdef55bea7eb5b0751a",
"total_amount": 20994788.28571239,
"transactions": 18446595,
"disk_size": 2268992765
},
"error": null,
"id": "curltest"
}preciousblock
Treats a block as if it were received before others with the same work.
A later preciousblock call can override the effect of an earlier one.
The effects of preciousblock are not retained across restarts.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "preciousblock",
"params": [
"blockhash"
]
}Example response: 200
{
"result": null,
"error": {
"code": -8,
"message": "blockhash must be of length 64 (not 9, for 'blockhash')"
},
"id": "curltest"
}savemempool
Dumps the mempool to disk. It will fail until the previous dump is fully loaded.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "savemempool",
"params": []
}Example response: 200
{
"result": {
"filename": "/coin/data/testnet3/mempool.dat"
},
"error": null,
"id": "curltest"
}verifychain
Verifies blockchain database.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "verifychain",
"params": []
}Example response: 200
{
"result": true,
"error": null,
"id": "curltest"
}estimatesmartfee
Estimates the smart fee per kilobyte to be paid for a transaction and also returns the number of blocks for which the estimate is valid.
Method: POST
https://btc-testnet.nownodes.io
Example body (raw)
{
"method": "estimatesmartfee",
"params": [
10
]
}Example response: 200
{
"result": {
"feerate": 0.05531357,
"blocks": 10
},
"error": null,
"id": null
}Last updated