Blockchain RPCs

getbestblockhash

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

Method: POST

https://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": "b68a67688a93de124fa027707f7713645ed73f88cf5bf6e5a0b37f5dd9ee6b01",
    "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://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": {
        "hash": "b68a67688a93de124fa027707f7713645ed73f88cf5bf6e5a0b37f5dd9ee6b01",
        "confirmations": 1,
        "strippedsize": 7026,
        "size": 7026,
        "weight": 7026,
        "height": 877771,
        "version": 536875008,
        "versionHex": "20001000",
        "merkleroot": "c9d310ce6aeed58143a6acfbb5c7a3d33a7f47a468193d2fd08bd8ea7786badb",
        "tx": [
            "99a507aa1c0c9fd755efcc19bcf88e15ab44f14886b7c32a9dc90be68033ea39",
            "430ddc663d0fc069c2c97a51992d0a28405be734ec28e0ba024729cb18996077",
            "a9740640bff5c4eff7f868d5ee5946c8db410ddf7ff375618bc5a9639a50f331",
            "dffd93af1e25375d9409334e87eb327fb069e67fd3f566156d5937c72fcc05ca"
        ],
        "cbTx": {
            "version": 2,
            "height": 877771,
            "merkleRootMNList": "ee3dbaf0092e18e6718f645f966cc47601d291740ddb597200e830fee1e8cf1e",
            "merkleRootQuorums": "bf2a24ee86e3ae92332a1ec48d6dc180a6625b640c5ffbf2dbf82aea54725a93"
        },
        "time": 1714314938,
        "mediantime": 1714314196,
        "nonce": 0,
        "bits": "1b1215d8",
        "difficulty": 3623.655765920826,
        "chainwork": "0000000000000000000000000000000000000000000000015986ee4e9825bf26",
        "previousblockhash": "9b6a3797d6d97217196192b723fb1d8f3ff1e08e2c95632a1c5ed90cc220b0a6",
        "chainlock": true
    },
    "error": null,
    "id": "curltest"
}

getblockchaininfo

Returns an object containing various state info regarding blockchain processing.

Method: POST

https://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": {
        "chain": "main",
        "blocks": 877771,
        "headers": 877771,
        "bestblockhash": "b68a67688a93de124fa027707f7713645ed73f88cf5bf6e5a0b37f5dd9ee6b01",
        "difficulty": 3623.655765920826,
        "mediantime": 1714314196,
        "verificationprogress": 0.9999992003945339,
        "chainwork": "0000000000000000000000000000000000000000000000015986ee4e9825bf26",
        "pruned": false,
        "softforks": [
            {
                "id": "bip34",
                "version": 2,
                "reject": {
                    "status": true
                }
            },
            {
                "id": "bip66",
                "version": 3,
                "reject": {
                    "status": false
                }
            },
            {
                "id": "bip65",
                "version": 4,
                "reject": {
                    "status": false
                }
            }
        ],
        "bip9_softforks": {
            "csv": {
                "status": "failed",
                "startTime": 1462060800,
                "timeout": 1493596800,
                "since": 34272
            },
            "segwit": {
                "status": "failed",
                "startTime": 1479168000,
                "timeout": 1510704000,
                "since": 62496
            }
        }
    },
    "error": null,
    "id": "curltest"
}

getblockcount

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

The genesis block has height 0.

Method: POST

https://firo.nownodes.io

Example body (raw)

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

Example response: 200

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

getblockhash

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

Method: POST

https://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": "2f42e445c42c28e7cfd8647916484ba838a94bacde698864d5bf5de67bbec998",
    "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://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": {
        "hash": "b68a67688a93de124fa027707f7713645ed73f88cf5bf6e5a0b37f5dd9ee6b01",
        "confirmations": 2,
        "height": 877771,
        "version": 536875008,
        "versionHex": "20001000",
        "merkleroot": "c9d310ce6aeed58143a6acfbb5c7a3d33a7f47a468193d2fd08bd8ea7786badb",
        "time": 1714314938,
        "mediantime": 1714314196,
        "nonce": 0,
        "bits": "1b1215d8",
        "difficulty": 3623.655765920826,
        "chainwork": "0000000000000000000000000000000000000000000000015986ee4e9825bf26",
        "previousblockhash": "9b6a3797d6d97217196192b723fb1d8f3ff1e08e2c95632a1c5ed90cc220b0a6",
        "nextblockhash": "9ff504808e8c4f93646e56d59f79fadee1cad932275f00839f0e4d2fcefa9409",
        "chainlock": true
    },
    "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://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": [
        {
            "height": 877772,
            "hash": "9ff504808e8c4f93646e56d59f79fadee1cad932275f00839f0e4d2fcefa9409",
            "branchlen": 0,
            "status": "active"
        },
        {
            "height": 877330,
            "hash": "268afd281ef8aab57e49de9607ac55f076b55a70f62bcaaffbe95dbe750333f9",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 876153,
            "hash": "49c3b9e7dda3f75ca0cdd61c49888bb16c609cb983d851970b75db4320251de0",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 874942,
            "hash": "e9fad1a5f8b366d0b9889b5ff9c6aa90abd9fcca89115bf6e506332042892035",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 873983,
            "hash": "accdea41f61dfec7c3e7c880b3004e5f875c17941a4b5dcaea74ff3a9c8b11bb",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 868132,
            "hash": "3b714be1a8eb21794fd47dedb124e61d8fec53e5e7927a7792d23736046ec4dd",
            "branchlen": 1,
            "status": "invalid"
        },
        {
            "height": 865975,
            "hash": "889d6a63baeba1be920016399f3c4f9e1403bf589f721093c9b3f231675ffea0",
            "branchlen": 1,
            "status": "valid-headers"
        },
        {
            "height": 865270,
            "hash": "8903f50cc81b1d9a32fa6d36bc12dffca71788a482e18339ccb9386bbada8299",
            "branchlen": 1,
            "status": "valid-headers"
        },
...

getdifficulty

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

Method: POST

https://firo.nownodes.io

Example body (raw)

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

Example response: 200

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

getmempoolancestors

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

Method: POST

https://firo.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 hexadecimal string (not 'mytxid')"
    },
    "id": "curltest"
}

getmempooldescendants

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

Method: POST

https://firo.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://firo.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://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": {
        "size": 1,
        "bytes": 374,
        "usage": 1184,
        "maxmempool": 2000000000,
        "mempoolminfee": 0.00000000,
        "instantsendlocks": 7
    },
    "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://firo.nownodes.io

Example body (raw)

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

Example response: 200

{
    "result": {
        "4b534d7042685adc68efe9404ee9e83d9b8765b46a763097aa7ec53369468525": {
            "size": 374,
            "fee": 0.00000417,
            "modifiedfee": 0.00000417,
            "time": 1714315449,
            "height": 877773,
            "startingpriority": 0,
            "currentpriority": 0,
            "descendantcount": 1,
            "descendantsize": 374,
            "descendantfees": 417,
            "ancestorcount": 1,
            "ancestorsize": 374,
            "ancestorfees": 417,
            "depends": [],
            "instantlock": true
        },
        "bfb208e560818d59f1190b09c57fb9e3c251a7d3dd67a7ba7980b322e8b43ce0": {
            "size": 5065,
            "fee": 0.00006897,
            "modifiedfee": 0.00006897,
            "time": 1714315492,
            "height": 877773,
            "startingpriority": 0,
            "currentpriority": 0,
            "descendantcount": 1,
            "descendantsize": 5065,
            "descendantfees": 6897,
            "ancestorcount": 1,
            "ancestorsize": 5065,
            "ancestorfees": 6897,
            "depends": [],
            "instantlock": true
        }
    },
    "error": null,
    "id": "curltest"
}

gettxout

Returns details about an unspent transaction output.

Method: POST

https://firo.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://firo.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://firo.nownodes.io

Example body (raw)

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

Example response: 200

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

Last updated