Blockchain RPCs
getbestblockhash
Returns the hash of the best (tip) block in the most-work fully-validated chain.
Method: POST
https://pivx.nownodes.io
Example body (raw)
{"jsonrpc": "1.0", "id": "curltest", "method": "getbestblockhash", "params": []}
Example response: 200
{
"result": "0000000000000000000105be70f4867eacf87fd2f64acad34f0a85019aa2edbd",
"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://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblock",
"params": [
"4e2370451ae0584d804f3494fd40cc30e10a93754294113da4d87267d4d1724f"
]
}
Example response: 200
{
"result": {
"hash": "4e2370451ae0584d804f3494fd40cc30e10a93754294113da4d87267d4d1724f",
"confirmations": 3,
"size": 511,
"height": 4349491,
"version": 11,
"merkleroot": "57b5d5a1c41b881ff0a94c46a4275dde682b2831b6aa893be901fd7257624ca7",
"acc_checkpoint": "0000000000000000000000000000000000000000000000000000000000000000",
"finalsaplingroot": "1cde4573279cc8029de2df170c9d24be1351be7072db0daad5e81ce806f8b727",
"tx": [
"583981f78244ed5695195d5d312b954bdfe7ebd940cf8131cfdb5964002d1738",
"38ea476e32f04f3345647689d2f6b2ee687daf6616ad98856c957a97be691b07"
],
"time": 1713429675,
"mediantime": 1713429480,
"nonce": 0,
"bits": "1b05d4c4",
"difficulty": 11238.84400808064,
"chainwork": "00000000000000000000000000000000000000000000004685d80688816a4abe",
"previousblockhash": "0e1e21138a1a4a3889a19c9d5dbc9c0d3e85f271259705f2ffb779163a5ab92a",
"nextblockhash": "09aeeee56593a9ccddf396899f8976d37d7564d352068912bd590112b8dfd37b",
"stakeModifier": "c40fca1d65d9c70ee854eec6a6eae64ece78d0e98a57eb6e5b3f59cfdedb04af",
"hashProofOfStake": "00000d9f9039e906edf5c3e199b20693423f882b8c015cda5842e1414b62bb0e",
"chainlock": false
},
"error": null,
"id": "curltest"
}
getblockchaininfo
Returns an object containing various state info regarding blockchain processing.
Method: POST
https://pvix.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockchaininfo",
"params": []
}
Example response: 200
{
"result": {
"chain": "main",
"blocks": 4349493,
"headers": 4349493,
"bestblockhash": "578d000f0abcb9b8581b1a738ed6eace54f9de9739dfff326fab5cd15de931c6",
"difficulty": 10247.18287882041,
"verificationprogress": 0.999999596840764,
"chainwork": "00000000000000000000000000000000000000000000004685d85a76dc3ab4e6",
"shield_pool_value": {
"chainValue": 751045.21345081,
"valueDelta": 0.00000000
},
"initial_block_downloading": false,
"softforks": [
{
"id": "bip65",
"version": 5,
"reject": {
"status": true
}
}
],
"upgrades": {
"PoS": {
"activationheight": 259201,
"status": "active",
"info": "Proof of Stake Consensus activation"
},
"PoS v2": {
"activationheight": 615800,
"status": "active",
"info": "New selection for stake modifier"
},
"Zerocoin": {
"activationheight": 863787,
"status": "active",
"info": "ZeroCoin protocol activation - start block v4"
},
"Zerocoin v2": {
"activationheight": 1153160,
"status": "active",
"info": "New zerocoin serials and zPOS start"
},
"BIP65": {
"activationheight": 1808634,
"status": "active",
"info": "CLTV (BIP65) activation - start block v5"
},
"Zerocoin Public": {
"activationheight": 1880000,
"status": "active",
"info": "Activation of zerocoin public spends (spend v3)"
},
"PIVX v3.4": {
"activationheight": 1967000,
"status": "active",
"info": "New 256-bit stake modifier - start block v6"
},
"PIVX v4.0": {
"activationheight": 2153200,
"status": "active",
"info": "New message sigs - start block v7 - time protocol - zc spend v4"
},
"v5 shield": {
"activationheight": 2700500,
"status": "active",
"info": "Sapling Shield - start block v8 - start transaction v3"
},
"PIVX v5.2": {
"activationheight": 2927000,
"status": "active",
"info": "New cold-staking rules"
},
"PIVX v5.3": {
"activationheight": 3014000,
"status": "active",
"info": "New staking rules"
},
"PIVX v5.5": {
"activationheight": 3715200,
"status": "active",
"info": "New rewards structure"
},
"PIVX v5.6": {
"activationheight": 4281680,
"status": "active",
"info": "Exchange address"
}
},
"warnings": ""
},
"error": null,
"id": "curltest"
}
getblockcount
Returns the height of the most-work fully-validated chain.
The genesis block has height 0.
Method: POST
https://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockcount",
"params": []
}
Example response: 200
{
"result": 4349498,
"error": null,
"id": "curltest"
}
getblockhash
Returns hash of block in best-block-chain at height provided.
Method: POST
https://pivx.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://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getblockheader",
"params": [
"4e2370451ae0584d804f3494fd40cc30e10a93754294113da4d87267d4d1724f"
]
}
Example response: 200
{
"result": {
"hash": "4e2370451ae0584d804f3494fd40cc30e10a93754294113da4d87267d4d1724f",
"confirmations": 4,
"height": 4349491,
"version": 11,
"merkleroot": "57b5d5a1c41b881ff0a94c46a4275dde682b2831b6aa893be901fd7257624ca7",
"time": 1713429675,
"mediantime": 1713429480,
"nonce": 0,
"bits": "1b05d4c4",
"difficulty": 11238.84400808064,
"chainwork": "00000000000000000000000000000000000000000000004685d80688816a4abe",
"acc_checkpoint": "0000000000000000000000000000000000000000000000000000000000000000",
"shield_pool_value": {
"chainValue": 751045.21345081,
"valueDelta": 0.00000000
},
"previousblockhash": "0e1e21138a1a4a3889a19c9d5dbc9c0d3e85f271259705f2ffb779163a5ab92a",
"nextblockhash": "09aeeee56593a9ccddf396899f8976d37d7564d352068912bd590112b8dfd37b",
"chainlock": false
},
"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://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintips",
"params": []
}
Example response: 200
{
"result": [
{
"height": 838408,
"hash": "0000000000000000000290e2caf27f3f4d0799b1ce05b07d9ed492c187a2b3c4",
"branchlen": 0,
"status": "active"
},
{
"height": 829613,
"hash": "0000000000000000000357088139cba6dc295875d7d3b2dd1fd764705727e451",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 827853,
"hash": "00000000000000000002c7de4016a0d09a47c19075cb73947e7f66e3461efd27",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 823226,
"hash": "0000000000000000000365e705dbbea406f6e383f510d400fa23e40eae71e056",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 822941,
"hash": "00000000000000000003aaaacecbebd40417c2e6c39b5774a8a212d5b324052b",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 819343,
"hash": "0000000000000000000262af3fb1dd3bc62ad5a119c48a57267a3b96145ce82c",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 818038,
"hash": "000000000000000000029afbc6cbd660df5548a90ca9202e80866c5c680f29e4",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 816358,
"hash": "00000000000000000001d5f92e2dbbfcbc1e859873117e7983dd574857da5e14",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 815570,
"hash": "000000000000000000024c1b977ae540b29e329ccfc3bbb37f3b0880c2336212",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 815202,
"hash": "0000000000000000000093917031004a140b6db5c6adec217f814db98d7f0bde",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 813210,
"hash": "000000000000000000021c9f203786c0adcd7ae9a68a25d5e430d2a3dba613d5",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 811703,
"hash": "0000000000000000000270d5eed2457bf394e45f5035c1d721f4f3ccecbb2ba5",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 809478,
"hash": "000000000000000000006840568a01091022093a176d12a1e8e5e261e4f11853",
"branchlen": 1,
"status": "invalid"
},
{
"height": 807025,
"hash": "000000000000000000048d93a8093bd9b104cadd46957a6d14ba3ce6f2a29b9f",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 804900,
"hash": "00000000000000000004c20bfe0ed1a9b714fbc07710531b8252dc998f9ccd67",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 803389,
"hash": "00000000000000000002ea858e57fc91ec34ae26a1d2a53720d7d4e08334fba2",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 800786,
"hash": "000000000000000000020e419bbdd75f21609d5a050a24bafe45b73a1574127d",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 797434,
"hash": "00000000000000000000fe9e3172a5d9ee3b815d952476a31056bc007657b83f",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 796038,
"hash": "0000000000000000000552fdbbe1edbff2887ea7879dc777b33f8cefc4ba665e",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 795426,
"hash": "000000000000000000045d66a7991b54de7e11776eed27e34df24a59b7de370e",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 792379,
"hash": "000000000000000000032956cbfd8721abe0572d81542e75e38e6185312bee09",
"branchlen": 1,
"status": "valid-fork"
}
],
"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://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getchaintips",
"params": []
}
Example response: 200
{
"result": [
{
"height": 838408,
"hash": "0000000000000000000290e2caf27f3f4d0799b1ce05b07d9ed492c187a2b3c4",
"branchlen": 0,
"status": "active"
},
{
"height": 829613,
"hash": "0000000000000000000357088139cba6dc295875d7d3b2dd1fd764705727e451",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 827853,
"hash": "00000000000000000002c7de4016a0d09a47c19075cb73947e7f66e3461efd27",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 823226,
"hash": "0000000000000000000365e705dbbea406f6e383f510d400fa23e40eae71e056",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 822941,
"hash": "00000000000000000003aaaacecbebd40417c2e6c39b5774a8a212d5b324052b",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 819343,
"hash": "0000000000000000000262af3fb1dd3bc62ad5a119c48a57267a3b96145ce82c",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 818038,
"hash": "000000000000000000029afbc6cbd660df5548a90ca9202e80866c5c680f29e4",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 816358,
"hash": "00000000000000000001d5f92e2dbbfcbc1e859873117e7983dd574857da5e14",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 815570,
"hash": "000000000000000000024c1b977ae540b29e329ccfc3bbb37f3b0880c2336212",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 815202,
"hash": "0000000000000000000093917031004a140b6db5c6adec217f814db98d7f0bde",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 813210,
"hash": "000000000000000000021c9f203786c0adcd7ae9a68a25d5e430d2a3dba613d5",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 811703,
"hash": "0000000000000000000270d5eed2457bf394e45f5035c1d721f4f3ccecbb2ba5",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 809478,
"hash": "000000000000000000006840568a01091022093a176d12a1e8e5e261e4f11853",
"branchlen": 1,
"status": "invalid"
},
{
"height": 807025,
"hash": "000000000000000000048d93a8093bd9b104cadd46957a6d14ba3ce6f2a29b9f",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 804900,
"hash": "00000000000000000004c20bfe0ed1a9b714fbc07710531b8252dc998f9ccd67",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 803389,
"hash": "00000000000000000002ea858e57fc91ec34ae26a1d2a53720d7d4e08334fba2",
"branchlen": 1,
"status": "valid-fork"
},
{
"height": 800786,
"hash": "000000000000000000020e419bbdd75f21609d5a050a24bafe45b73a1574127d",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 797434,
"hash": "00000000000000000000fe9e3172a5d9ee3b815d952476a31056bc007657b83f",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 796038,
"hash": "0000000000000000000552fdbbe1edbff2887ea7879dc777b33f8cefc4ba665e",
"branchlen": 1,
"status": "valid-headers"
},
{
"height": 795426,
"hash": "000000000000000000045d66a7991b54de7e11776eed27e34df24a59b7de370e",
"branchlen": 1,
"status": "headers-only"
},
{
"height": 792379,
"hash": "000000000000000000032956cbfd8721abe0572d81542e75e38e6185312bee09",
"branchlen": 1,
"status": "valid-fork"
}
],
"error": null,
"id": "curltest"
}
getdifficulty
Returns the proof-of-work difficulty as a multiple of the minimum difficulty.
Method: POST
https://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getdifficulty",
"params": []
}
Example response: 200
{
"result": 10087.84911332942,
"error": null,
"id": "curltest"
}
getmempoolinfo
Returns details on the active state of the TX memory pool.
Method: POST
https://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getmempoolinfo",
"params": []
}
Example response: 200
{
"result": {
"loaded": true,
"size": 0,
"bytes": 0,
"usage": 0,
"mempoolminfee": 0.00010000,
"minrelaytxfee": 0.00010000
},
"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://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "getrawmempool",
"params": [
true
]
}
Example response: 200
{
"result": {},
"error": null,
"id": "curltest"
}
gettxout
Returns details about an unspent transaction output.
Method: POST
https://pivx.nownodes.io
Example body (raw)
{
"jsonrpc": "1.0",
"id": "curltest",
"method": "gettxout",
"params": [
"txid",
1
]
}
Example response: 200
{
"result": null,
"error": null,
"id": "curltest"
}
Last updated