Blockchain RPCs

getbestblockhash

Returns the hash of the best (tip) block in the most-work fully-validated chain.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{"jsonrpc": "1.0", "id": "curltest", "method": "getbestblockhash", "params": []}

Example response: 200

{
    "result": "0000000000000000008fcafa769c9ec90008563b331d5a521c706509111668dc",
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblock",
    "params": [
        "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
    ]
}

Example response: 200

{
    "result": {
        "tx": [
            "fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33"
        ],
        "hash": "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
        "confirmations": 838703,
        "size": 216,
        "height": 1000,
        "version": 1,
        "versionHex": "00000001",
        "merkleroot": "fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33",
        "num_tx": 1,
        "time": 1232346882,
        "mediantime": 1232344831,
        "nonce": 2595206198,
        "bits": "1d00ffff",
        "difficulty": 1,
        "chainwork": "000000000000000000000000000000000000000000000000000003e903e903e9",
        "previousblockhash": "0000000008e647742775a230787d66fdf92c46a48c896bfbc85cdc8acc67e87d",
        "nextblockhash": "00000000a2887344f8db859e372e7e4bc26b23b9de340f725afbf2edb265b4c6",
        "status": {
            "validity": "scripts",
            "data": true,
            "undo": true,
            "failed": false,
            "parent failed": false,
            "disk meta": true,
            "soft reject": false,
            "double spend": false,
            "soft consensus frozen": false
        }
    },
    "error": null,
    "id": "curltest"
}

getblockchaininfo

Returns an object containing various state info regarding blockchain processing.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockchaininfo",
    "params": []
}

Example response: 200

{
    "result": {
        "chain": "main",
        "blocks": 839702,
        "headers": 839702,
        "bestblockhash": "0000000000000000008fcafa769c9ec90008563b331d5a521c706509111668dc",
        "difficulty": 109801376509.8045,
        "mediantime": 1712843187,
        "verificationprogress": 0.9999996306720346,
        "chainwork": "0000000000000000000000000000000000000000015534be5822053403d3e643",
        "pruned": false,
        "softforks": [
            {
                "id": "bip34",
                "version": 2,
                "reject": {
                    "status": true
                }
            },
            {
                "id": "bip66",
                "version": 3,
                "reject": {
                    "status": true
                }
            },
            {
                "id": "bip65",
                "version": 4,
                "reject": {
                    "status": true
                }
            },
            {
                "id": "csv",
                "version": 5,
                "reject": {
                    "status": true
                }
            }
        ]
    },
    "error": null,
    "id": "curltest"
}

getblockcount

Returns the height of the most-work fully-validated chain.

The genesis block has height 0.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockcount",
    "params": []
}

Example response: 200

{
    "result": 839702,
    "error": null,
    "id": "curltest"
}

getblockhash

Returns hash of block in best-block-chain at height provided.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockhash",
    "params": [
        1000
    ]
}

Example response: 200

{
    "result": "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockheader",
    "params": [
        "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"
    ]
}

Example response: 200

{
    "result": {
        "hash": "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09",
        "confirmations": 838703,
        "size": 216,
        "height": 1000,
        "version": 1,
        "versionHex": "00000001",
        "merkleroot": "fe28050b93faea61fa88c4c630f0e1f0a1c24d0082dd0e10d369e13212128f33",
        "num_tx": 1,
        "time": 1232346882,
        "mediantime": 1232344831,
        "nonce": 2595206198,
        "bits": "1d00ffff",
        "difficulty": 1,
        "chainwork": "000000000000000000000000000000000000000000000000000003e903e903e9",
        "previousblockhash": "0000000008e647742775a230787d66fdf92c46a48c896bfbc85cdc8acc67e87d",
        "nextblockhash": "00000000a2887344f8db859e372e7e4bc26b23b9de340f725afbf2edb265b4c6",
        "status": {
            "validity": "scripts",
            "data": true,
            "undo": true,
            "failed": false,
            "parent failed": false,
            "disk meta": true,
            "soft reject": false,
            "double spend": false,
            "soft consensus frozen": false
        }
    },
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockstats",
    "params": [
        1000,
        [
            "minfeerate",
            "avgfeerate"
        ]
    ]
}

Example response: 200

{
    "result": null,
    "error": {
        "code": -1,
        "message": "JSON value is not a string as expected"
    },
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintips",
    "params": []
}

Example response: 200

{
    "result": [
        {
            "height": 839702,
            "hash": "0000000000000000008fcafa769c9ec90008563b331d5a521c706509111668dc",
            "branchlen": 0,
            "status": "active"
        },
        {
            "height": 837582,
            "hash": "00000000000000000407cec3a2caa30d363362196fc4c2e5e413e2a356699b6b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 836660,
            "hash": "000000000000000002eeef89b98cfaa52f94b1e6e2391ca9c0607e97e29bd1cc",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 836591,
            "hash": "0000000000000000049d5724bddedd4f71e61bcc50d8682304681cab19e23e73",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 835204,
            "hash": "000000000000000006b09e9b0266ac9ee80023d1a8d3dc79351e16e6c02ac0b9",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 834511,
            "hash": "0000000000000000082385c8814755e967746046bc1b98fb398f6ca01fe9c85d",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 834317,
            "hash": "000000000000000003a1f6739ebb4b686bc8dddc7c96c971bea31f20dd6ad7a1",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 834228,
            "hash": "0000000000000000026bbc6f638946dc53765e74319ce40f2e269209831acfa7",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 833675,
            "hash": "000000000000000005cdd79ab7b496c77bb97caea1943f34df5e1618702e9d19",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 833602,
            "hash": "000000000000000002965832083b8dcdb885b31d30ffedd1d31ed50e4070a42c",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 833590,
            "hash": "0000000000000000010670153063fbc48f5195c23e4fe4aa18ad9fb7548ebec7",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 833316,
            "hash": "000000000000000004e28665d5bec3ee20a8848bb77542082e60b1fdc1e2876f",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 833304,
            "hash": "0000000000000000062a12cbb8d286772c902c3e868a9050b92e7375b98bc451",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 833245,
            "hash": "000000000000000001ffcd680fa38298435479f7f16b6e0aea06dc1ea069e781",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 831565,
            "hash": "0000000000000000071672209ec63d75c5fe4a1ea0b5f85974d0ee5cb1238b59",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 830537,
            "hash": "0000000000000000036426532110dc5f5d698eed9677786d8bfddcf93c721189",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 830053,
            "hash": "000000000000000006f12c24fbd84939647f7041ef4ce60e3b2aa32c53529bbb",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 829881,
            "hash": "00000000000000000259059ec0bc0c70107fbb07bc48027260d199bcd6766003",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 829828,
            "hash": "00000000000000000276e10d451a1b439224aba1cf596210f65cd78cb061082e",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 829093,
            "hash": "00000000000000000a2aa7bbb941f10a139ad3670680486c67328279f795497b",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 828912,
            "hash": "00000000000000000659d0ec462b27105e67825f7cc44fb2f236079d4d6ba9f9",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 827928,
            "hash": "0000000000000000005b7905af17bac91509a30c4eb6b984a107f9e1d568c310",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 827915,
            "hash": "000000000000000001651a9eb12cc528f6b438034c64a8c45a2caeaca1f8c103",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 827358,
            "hash": "0000000000000000016adc3aa423db5502dc472d9f72fa93726e120f5368c178",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826964,
            "hash": "0000000000000000056ad7f7a7c0b7e090eeaaf1722820781e0ef503b26bad27",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 826811,
            "hash": "00000000000000000875aeacb2d6f3a8fd31112ec3d2b1fa5d3a94e47193e38b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826732,
            "hash": "000000000000000005b789a96e662f9b81ae3487841921ece72fe7c5fdf888f1",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826654,
            "hash": "00000000000000000238df39ca2bcd7814c9d3b466b8842b34fa4cb8920fa5e2",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826642,
            "hash": "000000000000000006377c73f6bbcab75060af0ec34a43eff5ebebe1df1398d0",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826559,
            "hash": "0000000000000000043f99a7d522b65724aece0dc912b2ebc2f19fac23b54976",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826553,
            "hash": "000000000000000008d14e9b7f27f0dd48f559c05f7beac44412edc591211780",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 826480,
            "hash": "0000000000000000017c49fb28af0abf0ce73344b2c9338a300646c5a5ad4f45",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 826255,
            "hash": "000000000000000008a56744647596d48409c0855a9d152535d04a1edcc1a01a",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 826101,
            "hash": "0000000000000000015a6b9e2e71b01d21d578f5078ed9ffed1d499df1c6882d",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 825147,
            "hash": "000000000000000003be3ec249e84d8b3ac8c73398c0de60cdf269a5bef8a808",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 824586,
            "hash": "00000000000000000007a3aad30d4fcf4955fa30ad0f01006abca124f1cfa600",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 824569,
            "hash": "000000000000000001d2304bd2b4f3f34cbcd3e0a0063c11c3c225936d001821",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 824480,
            "hash": "00000000000000000850c6f667347fc5894f35c6c11f711d6a95a6d0a683495f",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 823948,
            "hash": "00000000000000000c70c36189de5a47d3d1f0d0fcc2421d1c489180dd61e587",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823727,
            "hash": "000000000000000008a0120cf0fd147347344fc6da8812e122a47a733555acf7",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823619,
            "hash": "00000000000000000b0ac718793d6d25d28aed664af9c8e960f3a8ee26b0144d",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823617,
            "hash": "00000000000000000a1838b19cbbfb53981a19dc7d01b4178d8b65c124496647",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 823590,
            "hash": "000000000000000008a3012d5d106921e836921a6e9ddec517a32a0aad02ebb7",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823486,
            "hash": "000000000000000001c3c42cd2547163086bcdde4dc715f50e9c1b90cc5972b0",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823435,
            "hash": "00000000000000000d240e356e4d714768b18b07bb310f9fd8569d42270d31bd",
            "branchlen": 2,
            "status": "valid-headers"
        },
        {
            "height": 823363,
            "hash": "00000000000000000e7e710208ea103734c6dcfda83e3b51facd1ef7164c39c6",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823298,
            "hash": "00000000000000000c0d2ba7b04a65d633bb2d4d5a67a256aa4f8141df898650",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823261,
            "hash": "0000000000000000065333e1f380d7512799b67d46eb9b38088ee98fad83eff7",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 823237,
            "hash": "00000000000000000dbe5975cdca8bc52e13fc7307f970beeee46e3c6498d307",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 822985,
            "hash": "00000000000000000016e84907d8bfd09c61f59a1609c724def5063cf4cb85dd",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 822968,
            "hash": "000000000000000002cf7135cd5b0d0f8bbb8bcaf049c8b5def1bc65d62f5545",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 822961,
            "hash": "000000000000000004517d4854423ee3de18f3bcb4e59ba8df13acd7bd1cd763",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 822919,
            "hash": "00000000000000000356df2984dab4b34fc7caedf8a8058be013e64d4e45ddc6",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 822907,
            "hash": "000000000000000007734f4fbf40312738b2670828c0ce143f32b4d9bf76bb24",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 822798,
            "hash": "000000000000000009d7bf46c8c61d30e0f2c6e11a205a558b4b71367bba6229",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 822675,
            "hash": "0000000000000000076495d0e66f7f08667eb9231e89b81790a4fed5b49abab2",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 822457,
            "hash": "00000000000000000ada9349acdcfe0521fa75393090629b92f025e4031589fa",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 820957,
            "hash": "000000000000000003d8ad03d2a75ff82bcdfe20e1b1202373c2fecec45ed3fa",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 818408,
            "hash": "00000000000000000ca2362d27a4c4f8f832ecc89a13f9c1edbfaa090f7e47ca",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815466,
            "hash": "000000000000000009f8f491447248614ea43fec3256ae34ea09ea2eb2a3e58b",
            "branchlen": 1,
            "status": "headers-only"
        },
        {
            "height": 815458,
            "hash": "00000000000000000605e19642f9a6ad2bbd4538cc06e66424da2a5ba0241d2b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 815388,
            "hash": "000000000000000007f339c66eb25f3f4c047d6c621b8e3c9d37b71d5121d1db",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 815381,
            "hash": "0000000000000000027f8f80c3ea21ed83a3c69a145ba7102f3439ffd2ecd824",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 815309,
            "hash": "00000000000000000528a2320a52b92cd9c8d9d21f43270de2c209b53c984adc",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 815303,
            "hash": "00000000000000000538196e3ca54c0ab785f77e1aaf2111256aaa31576de3c3",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815298,
            "hash": "000000000000000009fa3153375434be316a77589feb4cd2abcc5f2132941263",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815294,
            "hash": "00000000000000000081888ab0b2b66eff5f30978c7643320067f7e3f0f3d8dc",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815265,
            "hash": "00000000000000000491438f77e214a4ea51437ee883ec0ad4285a54dd5c633d",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815206,
            "hash": "0000000000000000055b013f7178caca61e1faffca576ff3d61db465f3d55177",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815017,
            "hash": "0000000000000000001a11a134912c66c124a88e478c4bf3298c30659d0df83a",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 815008,
            "hash": "00000000000000000823f34a5bf6556243367e8fc20dfc66b71057c98d140953",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814983,
            "hash": "000000000000000007e70ca19534c040f0746bad5c424db85acb3b55d186f3bb",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 814980,
            "hash": "0000000000000000079bdf187a35b3aa0caf1d8c1a2611b6d376d2be24ba256b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814905,
            "hash": "00000000000000000192f423bf6f8dbe5b14fb544874bf91f6db4c4f2722aa58",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 814886,
            "hash": "000000000000000007c6c06f471c2ab7dec50a0391a9c029d8b9f2d63fc96523",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814870,
            "hash": "000000000000000007a0fba1a50deb5f08f1d5fc4b3f55ffb98c55126b7d3214",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 814801,
            "hash": "000000000000000005152005dc9c5cabc7bf28e64687283f4af97f77fa1b2325",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814670,
            "hash": "000000000000000008a48311ecdc2b35fc3ce8ea1cf0ae65f06ab0e8b511a950",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814528,
            "hash": "000000000000000003875eaab64df97aa9f277be00afcee03b577fc4ae8fffe8",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814342,
            "hash": "00000000000000000236aae131e4c799ccf2d233910ab8297c91b5250e5735cf",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 814060,
            "hash": "00000000000000000dcee37628a7656884bc82333a346873c66d8d52f3caa258",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 811524,
            "hash": "000000000000000007a57aecd76f5e6d3c78796e4e1e0960b5c5fa158b0b845b",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 810296,
            "hash": "0000000000000000044c7c290faeaaf4b9892596ba19ac6a4b1e2d21c360d87c",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 810275,
            "hash": "00000000000000000d05e9cafffb1a387522a0d81de4268e9b9f1c72ef89568d",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 804677,
            "hash": "00000000000000000396bef478fabae957c0a45107350f77c91575c79d521f76",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 804223,
            "hash": "00000000000000000db579e7dafb48636cfcbe58981fa22a267f8a3dfea04cbe",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 804135,
            "hash": "000000000000000005acf5cbaa862df7463e210254388b608f1618b5420621eb",
            "branchlen": 2,
            "status": "valid-fork"
        },
        {
            "height": 803276,
            "hash": "0000000000000000074e30328379ef6ce6bb8867240d1ad51558b0d8fab80bcd",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 803247,
            "hash": "0000000000000000019ffa06979767da8920e6ed2a2f76579588cdfb29696c96",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 802661,
            "hash": "0000000000000000119329e9a57bf8a559b19c6bfefedec8d9e1a31a763782f2",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 799357,
            "hash": "0000000000000000045d9d0ad900c7caea3030ec432a3a97f42dea2f9ee54a6d",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 799122,
            "hash": "00000000000000000521ab1f0ac3b7f2a51e622e8d22f622bf389989c3100e5e",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 798120,
            "hash": "000000000000000001ed40a503c4ea799f144272a5c89516a4212d9cb86cd2e4",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 796466,
            "hash": "000000000000000000fdcc98d21c288a002e465e25552382feffac0b040eda56",
            "branchlen": 1,
            "status": "headers-only"
        },
        {
            "height": 796125,
            "hash": "00000000000000000ce53128713c423bab108e032e75c4bf2f60b73fa6aa022b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 795504,
            "hash": "000000000000000007dd48816ae6d7abdb576897847d6547da8e2fd91e576bfe",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 795310,
            "hash": "000000000000000002878a42f09ace08dacb65be19009c83f75deadb41a720eb",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 793992,
            "hash": "000000000000000005574992bf1d55bb3d7c00349cf6aadd58438f9a763e5677",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 793465,
            "hash": "00000000000000000eb5fb6f17f28300459b0ca949817a1e2f389d8968293513",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 678301,
            "hash": "0000000000000000052a3f47b1eaa34d4bd945bcf3e46206a26a3b1911b19428",
            "branchlen": 1,
            "status": "headers-only"
        },
        {
            "height": 592656,
            "hash": "00000000000000000cd2c787d48b7e71eedf0725888a5daae9655b8993ddee2e",
            "branchlen": 52,
            "status": "headers-only"
        }
    ],
    "error": null,
    "id": "curltest"
}

getchaintxstats

Compute statistics about the total number and rate of transactions in the chain.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintxstats",
    "params": [
        2016
    ]
}

Example response: 200

{
    "result": {
        "time": 1712848167,
        "txcount": 3673698247,
        "window_block_count": 2016,
        "window_tx_count": 1293579,
        "window_interval": 1202088,
        "txrate": 1.076110068480843
    },
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintips",
    "params": []
}

Example response: 200

{
    "result": [
        {
            "height": 839702,
            "hash": "0000000000000000008fcafa769c9ec90008563b331d5a521c706509111668dc",
            "branchlen": 0,
            "status": "active"
        },
        {
            "height": 837582,
            "hash": "00000000000000000407cec3a2caa30d363362196fc4c2e5e413e2a356699b6b",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 836660,
            "hash": "000000000000000002eeef89b98cfaa52f94b1e6e2391ca9c0607e97e29bd1cc",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 836591,
            "hash": "0000000000000000049d5724bddedd4f71e61bcc50d8682304681cab19e23e73",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 835204,
            "hash": "000000000000000006b09e9b0266ac9ee80023d1a8d3dc79351e16e6c02ac0b9",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 834511,
            "hash": "0000000000000000082385c8814755e967746046bc1b98fb398f6ca01fe9c85d",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 834317,
            "hash": "000000000000000003a1f6739ebb4b686bc8dddc7c96c971bea31f20dd6ad7a1",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 834228,
            "hash": "0000000000000000026bbc6f638946dc53765e74319ce40f2e269209831acfa7",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 833675,
            "hash": "000000000000000005cdd79ab7b496c77bb97caea1943f34df5e1618702e9d19",
            "branchlen": 1,
            "status": "valid-fork"
        },
        {
            "height": 833602,
            "hash": "000000000000000002965832083b8dcdb885b31d30ffedd1d31ed50e4070a42c",
            "branchlen": 1,
            "status": "valid-fork"
        },
...

getchaintxstats

Compute statistics about the total number and rate of transactions in the chain.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintxstats",
    "params": [
        2016
    ]
}

Example response: 200

{
    "result": {
        "time": 1712848167,
        "txcount": 3673698247,
        "window_block_count": 2016,
        "window_tx_count": 1293579,
        "window_interval": 1202088,
        "txrate": 1.076110068480843
    },
    "error": null,
    "id": "curltest"
}

getdifficulty

Returns the proof-of-work difficulty as a multiple of the minimum difficulty.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getdifficulty",
    "params": []
}

Example response: 200

{
    "result": 109801376509.8045,
    "error": null,
    "id": "curltest"
}

getmempoolancestors

If txid is in the mempool, returns all in-mempool ancestors.

Method: POST

https://bsv.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://bsv.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 hexadecimal string (not 'mytxid') and length of it must be divisible by 2"
    },
    "id": "curltest"
}

getmempoolentry

Returns mempool data for given transaction

Method: POST

https://bsv.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 hexadecimal string (not 'mytxid') and length of it must be divisible by 2"
    },
    "id": "curltest"
}

getmempoolinfo

Returns details on the active state of the TX memory pool.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolinfo",
    "params": []
}

Example response: 200

{
    "result": {
        "size": 432,
        "journalsize": 14,
        "nonfinalsize": 0,
        "bytes": 436065,
        "usage": 22237600,
        "usagedisk": 0,
        "usagecpfp": 21329256,
        "nonfinalusage": 192,
        "maxmempool": 1000000000,
        "maxmempoolsizedisk": 0,
        "maxmempoolsizecpfp": 100000000,
        "mempoolminfee": 0.00000000
    },
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawmempool",
    "params": [
        true
    ]
}

Example response: 200

{
    "result": {
        "0f47f42f259b018cecfc4db4fb286f4e819055eb58f833f8098ee4b9ccdba4cd": {
            "size": 3093,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712731469,
            "height": 839508,
            "depends": []
        },
        "753258db46185a2803469e4f076120606bc5e6c44eb024f97871309421ad3284": {
            "size": 225,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712732463,
            "height": 839510,
            "depends": []
        },
        "5d3d79c9e8bd74ffb4225ce4d9a19769d4079c071872fc04ce8232e18a02b33b": {
            "size": 225,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712733265,
            "height": 839510,
            "depends": []
        },
        "a2faec9a83b4b24f372c9644df2af5bcb6bb32c91bf8fc5b44239a89d2e53cfd": {
            "size": 225,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712733560,
            "height": 839510,
            "depends": []
        },
        "35241709d0116706794e4ef5ea9176030f76c47ad564dda08d8930c80b54eaa3": {
            "size": 226,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712733600,
            "height": 839510,
            "depends": []
        },
        "c3bcad313754a9ff6af1d7f5653120d8da64fce1b32f5464b9ca6b8fc383275a": {
            "size": 225,
            "fee": 0.00000000,
            "modifiedfee": 0.00000000,
            "time": 1712733674,
            "height": 839510,
            "depends": []
        },
...

gettxout

Returns details about an unspent transaction output.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxout",
    "params": [
        "txid",
        1
    ]
}

Example response: 200

{
    "result": null,
    "error": null,
    "id": "curltest"
}

gettxoutproof

Returns a hex-encoded proof that “txid” was included in a block.

Method: POST

https://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxoutproof",
    "params": [
        [
            "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
            "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
        ],
        null
    ]
}

Example response: 200

{
    "result": null,
    "error": {
        "code": -1,
        "message": "JSON value is not a string as expected"
    },
    "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://bsv.nownodes.io

Example body (raw)

{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "preciousblock",
    "params": [
        "blockhash"
    ]
}

Example response: 200

{
    "result": null,
    "error": {
        "code": -5,
        "message": "Block not found"
    },
    "id": "curltest"
}

Last updated