BlockBook API

v1.0.0

Base URLs

https://rvn-blockbook.nownodes.io

https://rvn.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / Blockbook

BlockBook

Get Blockbook backend info

GET

https://rvn-blockbook.nownodes.io/api

Returns general metadata and status about the Blockbook service and its connected backend node.

Response

200OK

Successfully retrieved Blockbook info

500Internal Server Error

Internal error

Authorization

api-keyAuthapiKey in header

Get Blockbook backend info

curl -X GET 'https://rvn-blockbook.nownodes.io/api'

const response = await fetch('https://rvn-blockbook.nownodes.io/api', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api')
data = response.json()

{
  "blockbook": {
    "coin": "Ravencoin",
    "host": "blockbook-node",
    "version": "0.4.4",
    "gitCommit": "65e2800",
    "buildTime": "2022-02-12T12:34:56Z",
    "syncMode": false,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 823456,
    "lastBlockTime": "2023-07-20T10:45:00Z",
    "inSyncMempool": true,
    "mempoolSize": 1023,
    "decimals": 8,
    "dbSize": 5123456789,
    "dbSizeChain": 20123456789,
    "about": "Welcome to Blockbook"
  },
  "backend": {
    "chain": "main",
    "blocks": 823456,
    "headers": 823456,
    "bestblockhash": "0000000000000000000769b1d6c56bb8f...",
    "difficulty": 482903248239.23,
    "size_on_disk": 33110011233,
    "version": "0.21.1",
    "protocolversion": 70016
  }
}

{
  "error": "Internal server error"
}

Get block hash by block height

GET

https://rvn-blockbook.nownodes.io/api/v2/block-index/{height}

Returns the block hash corresponding to the specified block height.

Parameters

heightinteger>= 0requiredpath

The height of the block (e.g., 800000)

Response

200OK

Successfully retrieved block hash

404Not Found

Block not found at given height

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash by block height

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/block-index/{height}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/block-index/{height}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/block-index/{height}')
data = response.json()

{
  "blockHash": "00000000000000000004e6a25d5e8bb4d9b23f94b84f8e0cf4e2128c2b93a6b1"
}

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get specific transaction details

GET

https://rvn-blockbook.nownodes.io/api/v2/tx-specific/{txid}

Returns full decoded transaction data for a given transaction ID.

Parameters

txidstringrequiredpath

Transaction ID (txid) to look up

Response

200OK

Successful response with transaction details

404Not Found

Transaction not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get specific transaction details

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/tx-specific/{txid}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/tx-specific/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/tx-specific/{txid}')
data = response.json()

{
  "txid": "f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a",
  "hash": "cbc797f38d2451d82abcf87a34411dfc2301013bfb2e02e603f23f79162f06e9",
  "version": 1,
  "size": 294,
  "vsize": 267,
  "weight": 1068,
  "locktime": 0,
  "vin": [
    {
      "coinbase": "03bad60d0f2f736c7573682f0d006505579f3105fabe6d6df4fa1f8b7243b5932215779ccf2859f87b3c2ab4759e5ae6767b78836d69851310000000000000000000a5f122000dd100000000",
      "txinwitness": [
        "0000000000000000000000000000000000000000000000000000000000000000"
      ],
      "sequence": 4294967295
    }
  ],
  "vout": [
    {
      "value": 3.16083585,
      "n": 0,
      "scriptPubKey": {
        "asm": "OP_HASH160 1f0cbbec8bc4c945e4e16249b11eee911eded55f OP_EQUAL",
        "desc": "addr(34XC8GbijKCCvppNvhw4Ra8QZdWsg8tC11)#08lwrngg",
        "hex": "a9141f0cbbec8bc4c945e4e16249b11eee911eded55f87",
        "address": "34XC8GbijKCCvppNvhw4Ra8QZdWsg8tC11",
        "type": "scripthash"
      }
    },
    {
      "value": 0,
      "n": 1,
      "scriptPubKey": {
        "asm": "OP_RETURN aa21a9eda0eefc77c01fe976be38c09d179d818253863e0c2e0ceb8718a75b66a0f02515",
        "desc": "raw(6a24aa21a9eda0eefc77c01fe976be38c09d179d818253863e0c2e0ceb8718a75b66a0f02515)#79qd3k53",
        "hex": "6a24aa21a9eda0eefc77c01fe976be38c09d179d818253863e0c2e0ceb8718a75b66a0f02515",
        "type": "nulldata"
      }
    },
    {
      "value": 0,
      "n": 2,
      "scriptPubKey": {
        "asm": "OP_RETURN 52534b424c4f434b3a45ace0e0b600b6c87a591f975cc9f3eaecc5d6476173a2f8d1827117007733ae",
        "desc": "raw(6a2952534b424c4f434b3a45ace0e0b600b6c87a591f975cc9f3eaecc5d6476173a2f8d1827117007733ae)#k35jmcwj",
        "hex": "6a2952534b424c4f434b3a45ace0e0b600b6c87a591f975cc9f3eaecc5d6476173a2f8d1827117007733ae",
        "type": "nulldata"
      }
    }
  ],
  "hex": "010000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff4c03bad60d0f2f736c7573682f0d006505579f3105fabe6d6df4fa1f8b7243b5932215779ccf2859f87b3c2ab4759e5ae6767b78836d69851310000000000000000000a5f122000dd100000000ffffffff03810dd7120000000017a9141f0cbbec8bc4c945e4e16249b11eee911eded55f870000000000000000266a24aa21a9eda0eefc77c01fe976be38c09d179d818253863e0c2e0ceb8718a75b66a0f0251500000000000000002b6a2952534b424c4f434b3a45ace0e0b600b6c87a591f975cc9f3eaecc5d6476173a2f8d1827117007733ae0120000000000000000000000000000000000000000000000000000000000000000000000000",
  "blockhash": "0000000000000000000050fec987e125eab4ea779162a1cdf7ed05bb3535f24e",
  "confirmations": 1,
  "time": 1753349199,
  "blocktime": 1753349199
}

{
  "error": "Transaction not found"
}

{
  "error": "Internal server error"
}

Get address information

GET

https://rvn-blockbook.nownodes.io/api/v2/address/{address}

Returns detailed information about a Ravencoin address such as balance, total received and sent, unconfirmed transactions, list of txids, and more. Supports pagination and filtering by block height and details.

Parameters

addressstringrequiredpath

Ravencoin address to query.

pageinteger1query

Page number for pagination (default is 1).

pageSizeinteger1000query

Number of items per page (default 1000).

fromintegerquery

Starting block height to filter transactions (optional).

tointegerquery

Ending block height to filter transactions (optional).

detailsstringbasictokenstokenBalancestxidstxsquery

Level of transaction detail to return. Options:

basic: Basic transaction info.
tokens: Include token info.
tokenBalances: Include token balances.
txids: Return only transaction IDs.
txs: Return full transaction details.

contractstringquery

Filter by contract address (optional).

secondarystringquery

Include secondary currency balances (e.g., USD).

Response

200OK

Successful response with address details

400Bad Request

Invalid address or bad request

404Not Found

Address not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get address information

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/address/{address}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/address/{address}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "bc1qll4224u6ecldm02xs250h20ax9u6dc4pl9332d",
  "balance": "0",
  "totalReceived": "4555309",
  "totalSent": "4555309",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 2,
  "txids": [
    "99446b8a7d2d61301ef6d4e34d65ee179da9d15daec46d8ca746ce9984ba31d1",
    "44d575c325e9ee502a67364b1d9537d3d3233f4047bbae42888838ececb8cf86"
  ]
}

{
  "error": "Invalid address format"
}

{
  "error": "Address not found"
}

{
  "error": "Internal server error"
}

Get XPUB or descriptor details

GET

https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}

Retrieves detailed information about an XPUB or descriptor including confirmed balance, total received and sent amounts, unconfirmed balances, transaction counts, tokens used, and paginated transaction IDs.

Parameters

xpubOrDescriptorstringrequiredpath

XPUB or descriptor to query.

pageinteger1query

Page number for pagination (default is 1).

pageSizeinteger1000query

Number of items per page (default 1000).

fromintegerquery

Starting block height to filter transactions (optional).

tointegerquery

Ending block height to filter transactions (optional).

detailsstringbasictokenstokenBalancestxidstxsquery

Level of transaction detail to return. Options:

basic: Basic transaction info.
tokens: Include token info.
tokenBalances: Include token balances.
txids: Return only transaction IDs.
txs: Return full transaction details.

tokensstringnonzerousedderivedquery

Filter tokens by usage type:

nonzero: Tokens with non-zero balances.
used: Tokens that have been used.
derived: Tokens derived from this XPUB.

secondarystringquery

Include secondary currency balances (e.g., EUR).

Response

200OK

Successful response with XPUB details

400Bad Request

Invalid XPUB or bad request

404Not Found

XPUB not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get XPUB or descriptor details

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB",
  "balance": "0",
  "totalReceived": "2063000",
  "totalSent": "2063000",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 18,
  "addrTxCount": 18,
  "txids": [
    "b435109b7e6ad2b8181583cbf51fcdefe618959cf8bc4f7d45b6d1f5c0c79f89",
    "06577f9c46abed29c32a6f3921dc3bf3cfb2b2f8e7e0b96d281b8ca4e26185d9",
    "9e29a01ca3bb3aa878d25279dc0761efb34de402744ef46b94c057f964ed8628",
    "657f6e76df55a65356d98371370e9f512d1c5d41a01d0d12467edc0609640444",
    "5256a1c98272d1525b46d96b4c01abe62737b8b5932df313c535ab7ebfd4658f",
    "9f127de1c7dc91ef69bec8f0ec5900bda86cec65cb9ace25b6507d410c478a65",
    "9146c7e0a9e7d3d7dd0c4be8bce00d088a25a0bae333d00f22f559a566d7fa41",
    "5caa0c516b2e39b560b7ccfee86824c001e798d20b72e9ea58b3284c46c77d18",
    "90c36964f0e161dcbe054d5201e4fbb8e51782289658893eb00d5dab4547750a",
    "c8d3da26fd0e5a98ef15856becee55fddd2178b8c4fdc786f116251d04bc444d",
    "80c7b9836ae6156a1574f380bb277c712405ebc8e415e34ae61653b2212c7be8",
    "3abc1608b70f0ed319a9a43eb5ed631c39ff8ff57b717652ab45a0c9729ef6ac",
    "62cca9c94fbc618df729d0f1f937222bc9be9de153d7cb1abd4abafdd4f5f1b5",
    "8a82f253ca23b870f2b2f23d3a3cb3aeb26057e21431c35d5f48bd40d78d7c30",
    "99e6806d5253649a758d3e23c66fb48642fd321efdebf4eb1ae78cbdd2fdc8df",
    "318d068ea98fb1ce64cfacf3bd992b87fb78be52289cad14d1ccfd4d472d964f",
    "66a4185ef490e31434e2f11fdf22fc0e58c5acef1b744cb0598daae2979acfce",
    "6398de55c404e897b60cf19f55ab9d9daee95227378164c1a89a820b4d4e779b"
  ],
  "usedTokens": 9
}

{
  "error": "Invalid XPUB format"
}

{
  "error": "XPUB not found"
}

{
  "error": "Internal server error"
}

Get UTXOs for address, XPUB or descriptor

GET

https://rvn-blockbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}

Retrieves the unspent transaction outputs (UTXOs) associated with a specific address, XPUB, or descriptor. Optionally filter only confirmed UTXOs by using the confirmed query parameter.

Parameters

addressOrXpubOrDescriptorstringrequiredpath

Address, XPUB or descriptor to query UTXOs for.

confirmedbooleanfalsequery

If true, only return confirmed UTXOs. Defaults to false (returns both confirmed and unconfirmed).

Response

200OK

List of UTXOs for the given address, XPUB, or descriptor

400Bad Request

Invalid address or parameter error

404Not Found

No UTXOs found for the specified input

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get UTXOs for address, XPUB or descriptor

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/utxo/{addressOrXpubOrDescriptor}')
data = response.json()

[
  {
    "txid": "99446b8a7d2d61301ef6d4e34d65ee179da9d15daec46d8ca746ce9984ba31d1",
    "vout": 0,
    "value": "4555309",
    "height": 700000,
    "confirmations": 100,
    "coinbase": false,
    "spent": false
  },
  {
    "txid": "44d575c325e9ee502a67364b1d9537d3d3233f4047bbae42888838ececb8cf86",
    "vout": 1,
    "value": "1000000",
    "height": 699900,
    "confirmations": 200,
    "coinbase": true,
    "spent": false
  }
]

{
  "error": "Invalid address format"
}

{
  "error": "No UTXOs found"
}

{
  "error": "Internal server error"
}

Get block details by height or hash

GET

https://rvn-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}

Returns detailed information about a block specified by its height or hash.

Parameters

blockHeightOrHashstringrequiredpath

Block height (integer) or block hash (string) to identify the block.

Response

200OK

Block details response

400Bad Request

Invalid block height or hash format

404Not Found

Block not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block details by height or hash

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}')
data = response.json()

{
  "hash": "0000000000000000000a1b2c3d4e5f67890abcdef1234567890abcdef1234567",
  "confirmations": 123,
  "size": 1234567,
  "height": 700000,
  "version": 536870912,
  "merkleroot": "4d5e6f7890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "tx": [
    "f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a",
    "cbc797f38d2451d82abcf87a34411dfc2301013bfb2e02e603f23f79162f06e9"
  ],
  "time": 1753349199,
  "nonce": 2083236893,
  "bits": "1d00ffff",
  "difficulty": 19354847804972.85,
  "previousblockhash": "0000000000000000000872af0a1b2c3d4e5f67890abcdef1234567890abcdef1",
  "nextblockhash": "0000000000000000000b3c4d5e6f7890abcdef1234567890abcdef1234567890"
}

{
  "error": "Invalid block height or hash"
}

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Broadcast raw transaction

GET

https://rvn-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}

Sends a raw transaction to the blockchain network. The transaction must be provided as a hex-encoded string in the URL path.

Parameters

hexTxDatastringrequiredpath

Hex-encoded raw transaction data to be broadcasted.

Response

200OK

Transaction broadcast successful

400Bad Request

Invalid transaction hex data

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Broadcast raw transaction

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}')
data = response.json()

{
  "txid": "f508de864ef389255b2d2a9c3973794cab186aeb1f47e5f9036c66e64651562a",
  "result": "Transaction broadcasted successfully"
}

{
  "error": "Invalid hex transaction data"
}

{
  "error": "Internal server error"
}

Get list of tickers updated since timestamp

GET

https://rvn-blockbook.nownodes.io/api/v2/tickers-list

Returns an array of ticker objects representing cryptocurrency prices updated since the specified UNIX timestamp (in seconds).

Parameters

timestampintegerquery

UNIX timestamp (in seconds). Only tickers updated after this time are returned.

Response

200OK

List of tickers

400Bad Request

Invalid timestamp parameter

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get list of tickers updated since timestamp

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/tickers-list'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/tickers-list', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/tickers-list')
data = response.json()

[
  {
    "symbol": "BTC",
    "price": "26859.45",
    "timestamp": 1680001234
  },
  {
    "symbol": "ETH",
    "price": "1875.32",
    "timestamp": 1680001250
  }
]

{
  "error": "Invalid timestamp parameter"
}

{
  "error": "Internal server error"
}

Get balance history for an address or XPUB

GET

https://rvn-blockbook.nownodes.io/api/v2/balancehistory/{account}

Returns the balance history for the specified address or XPUB between the from and to date parameters. The balances can be optionally converted to a specified fiat currency and grouped by time intervals.

Parameters

accountstringrequiredpath

XPUB or address to query balance history for

fromstring<date-time>requiredquery

Start date (ISO 8601 format, e.g. 2023-01-01T00:00:00Z)

tostring<date-time>requiredquery

End date (ISO 8601 format, e.g. 2023-01-10T00:00:00Z)

fiatcurrencystringquery

Fiat currency code to convert balances (e.g., USD, EUR). Optional.

groupByintegerquery

Group results by time interval in seconds (e.g., 86400 for daily). Optional.

Response

200OK

Balance history retrieved successfully

400Bad Request

Invalid or missing parameters

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get balance history for an address or XPUB

curl -X GET 'https://rvn-blockbook.nownodes.io/api/v2/balancehistory/{account}'

const response = await fetch('https://rvn-blockbook.nownodes.io/api/v2/balancehistory/{account}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://rvn-blockbook.nownodes.io/api/v2/balancehistory/{account}')
data = response.json()

{
  "account": "xpub661MyMwAqRbcFW31YEwpkMuc5THy2PSt5bDMsktWQcFF8syAmRUapSCGu8ED9W6oDMSgv6Zz8idoc4a6mr8BDzTJY47LJhkJ8UB7WEGuduB",
  "from": "2023-01-01T00:00:00Z",
  "to": "2023-01-10T00:00:00Z",
  "fiatcurrency": "USD",
  "groupBy": 86400,
  "history": [
    {
      "timestamp": "2023-01-01T00:00:00Z",
      "balance": "0.10000000",
      "balanceFiat": "4200.00"
    },
    {
      "timestamp": "2023-01-02T00:00:00Z",
      "balance": "0.10500000",
      "balanceFiat": "4410.00"
    },
    {
      "timestamp": "2023-01-03T00:00:00Z",
      "balance": "0.10300000",
      "balanceFiat": "4320.00"
    },
    {
      "timestamp": "2023-01-04T00:00:00Z",
      "balance": "0.11000000",
      "balanceFiat": "4620.00"
    },
    {
      "timestamp": "2023-01-05T00:00:00Z",
      "balance": "0.11500000",
      "balanceFiat": "4830.00"
    },
    {
      "timestamp": "2023-01-06T00:00:00Z",
      "balance": "0.11200000",
      "balanceFiat": "4700.00"
    },
    {
      "timestamp": "2023-01-07T00:00:00Z",
      "balance": "0.11800000",
      "balanceFiat": "4950.00"
    },
    {
      "timestamp": "2023-01-08T00:00:00Z",
      "balance": "0.12000000",
      "balanceFiat": "5040.00"
    },
    {
      "timestamp": "2023-01-09T00:00:00Z",
      "balance": "0.12500000",
      "balanceFiat": "5250.00"
    },
    {
      "timestamp": "2023-01-10T00:00:00Z",
      "balance": "0.13000000",
      "balanceFiat": "5460.00"
    }
  ]
}

{
  "error": "Invalid date format for parameter 'from'"
}

{
  "error": "Internal server error"
}

MAINNET / Blockchain_RPCs

getbestblockhash

POST

https://rvn-blockbook.nownodes.io/

Returns the hash of the best block in the most-work fully-validated chain. The best block is the tip of the blockchain, representing the most recent block that has been validated and added to the chain.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetbestblockhashrequired

paramsArray<any>required

Response

200OK

Valid response

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getbestblockhash

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getbestblockhash",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getbestblockhash",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

getblock

POST

https://rvn-blockbook.nownodes.io/

Returns information about the block with the given block hash. Optional verbosity levels determine the level of detail in the response:

0: Returns a string that is serialized, hex-encoded data for the block.
1: Returns a JSON object with basic block details and txids.
2: Returns a JSON object with detailed transaction info.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockrequired

paramsArray<string | integer>required

Parameters:

blockhash (string) – The hash of the block
verbosity (integer, optional) – Level of detail: 0, 1, or 2

Show child attributes

One of

string

integer

Response

200OK

Block information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblock

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblock",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      1
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblock",
      "params": [
        "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
        1
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    1
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    1
  ]
}

{
  "result": {
    "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "confirmations": 100,
    "height": 855000,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "a3e1f3...ff9a",
    "time": 1700000000,
    "mediantime": 1699995000,
    "nonce": 4282073135,
    "bits": "170d1f5d",
    "difficulty": 225983213292.9388,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "previousblockhash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "nextblockhash": "0000000000000000000735c64b80cd102b8e4d67c2cc09db81fa4451a6f58e3a",
    "tx": [
      "string"
    ]
  },
  "error": {},
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockchaininfo

POST

https://rvn-blockbook.nownodes.io/

Returns an object containing various state info regarding blockchain processing.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockchaininforequired

paramsArray<any>required

Response

200OK

Blockchain state information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockchaininfo

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockchaininfo",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockchaininfo",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "chain": "main",
    "blocks": 855000,
    "headers": 855002,
    "bestblockhash": "0000000000000000000b27d455de872dfe8a8aa4f2efbfc5f1877357f7c8e97b",
    "difficulty": 225983213292.9388,
    "mediantime": 1700000500,
    "verificationprogress": 0.999999,
    "initialblockdownload": false,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "size_on_disk": 495000000000,
    "pruned": false,
    "pruneheight": null,
    "automatic_pruning": false,
    "prune_target_size": null,
    "warnings": ""
  },
  "error": {},
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockcount

POST

https://rvn-blockbook.nownodes.io/

Returns the number of blocks in the longest blockchain. This number increases as new blocks are added.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockcountrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Current block height retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockcount

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockcount",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockcount",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

getblockhash

POST

https://rvn-blockbook.nownodes.io/

Returns the block hash of the block at the given height in the blockchain. You must provide a block height (0-based index).

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockhashrequired

paramsArray<integer>required

Parameters:

height (integer) — The height (index) of the block.

Response

200OK

Block hash successfully retrieved

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockhash

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockhash",
    "params": [
      855000
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockhash",
      "params": [
        855000
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockhash",
  "params": [
    855000
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

getblockheader

POST

https://rvn-blockbook.nownodes.io/

Returns information about the block header given a block hash. You can specify whether to return a JSON object or raw hex-encoded string using the verbose flag.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockheaderrequired

paramsArray<string | boolean>required

Parameters:

blockhash (string) — The hash of the block.
verbose (boolean, optional) — If true, returns a JSON object; if false, returns a hex string. Default is true.

Show child attributes

One of

string

boolean

Response

200OK

Block header information retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockheader

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockheader",
    "params": [
      "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockheader",
      "params": [
        "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockheader",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    true
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockheader",
  "params": [
    "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    true
  ]
}

{
  "result": {
    "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "confirmations": 105,
    "height": 855000,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "e3abc1234...",
    "time": 1700000000,
    "mediantime": 1699995000,
    "nonce": 1234567890,
    "bits": "170d1f5d",
    "difficulty": 225983213292.9388,
    "chainwork": "0000000000000000000000000000000000000000230c36f8ff7f4fbee5b6a0c2",
    "previousblockhash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "nextblockhash": "0000000000000000000735c64b80cd102b8e4d67c2cc09db81fa4451a6f58e3a"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getblockstats

POST

https://rvn-blockbook.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash. Available in Bitcoin Core v0.17.0 and later.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetblockstatsrequired

paramsArray<integer | string | Array<string>>required

Parameters:

height_or_hash (integer or string) — The block height (integer) or block hash (string).
stats (array, optional) — Specific stats to return. If not specified, returns all.

Show child attributes

One of

integer

string

Array<string>

Response

200OK

Block statistics returned successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getblockstats

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getblockstats",
    "params": [
      855000
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getblockstats",
      "params": [
        855000
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblockstats",
  "params": [
    855000
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "avgfee": 1289,
    "avgfeerate": 3,
    "avgtxsize": 500,
    "blockhash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
    "height": 855000,
    "ins": 6000,
    "maxfee": 35000,
    "maxfeerate": 50,
    "maxtxsize": 2500,
    "medianfee": 1000,
    "mediantime": 1700000000,
    "mediantxsize": 250,
    "minfee": 200,
    "minfeerate": 1,
    "mintxsize": 100,
    "outs": 6500,
    "subsidy": 625000000,
    "swtotal_size": 1000000,
    "swtotal_weight": 3200000,
    "swtxs": 1800,
    "time": 1700000500,
    "total_out": 100000000000,
    "total_size": 1250000,
    "total_weight": 3999000,
    "totalfee": 2300000,
    "txs": 2200,
    "utxo_increase": 500,
    "utxo_size_inc": 20000,
    "utxo_increase_actual": 498
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getchaintips

POST

https://rvn-blockbook.nownodes.io/

Returns information about all known tips in the block tree, including the main chain as well as orphaned forks.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetchaintipsrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Chain tips retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getchaintips

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintips",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getchaintips",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": [
    {
      "height": 855000,
      "hash": "0000000000000000000a1e63be6bb1d1f4e6d2a345234a4a6b8f86e4f0de3c5a",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 854980,
      "hash": "0000000000000000000f83a8e9a563e48e7b8e5400e38310ff299b7f30aaf8d9",
      "branchlen": 20,
      "status": "valid-fork"
    }
  ],
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getchaintxstats

POST

https://rvn-blockbook.nownodes.io/

Compute statistics about the total number and rate of transactions in the blockchain. You can optionally specify the number of blocks and a block hash to start from.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetchaintxstatsrequired

paramsArray<integer | string>required

Parameters:

nblocks (integer, optional) — Number of blocks to average over. Default: 1 month worth (~4320).
blockhash (string, optional) — Hash of the block to stop at; defaults to the chain tip.

Show child attributes

One of

integer

string

Response

200OK

Chain transaction statistics retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getchaintxstats

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getchaintxstats",
    "params": [
      144,
      "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getchaintxstats",
      "params": [
        144,
        "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintxstats",
  "params": [
    144,
    "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getchaintxstats",
  "params": [
    144,
    "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1"
  ]
}

{
  "result": {
    "time": 1700000000,
    "txcount": 889452301,
    "window_final_block_hash": "0000000000000000000c1e1ecf0aef02b1c3d4c44c920afe0aaec7d08d0019e1",
    "window_final_block_height": 855000,
    "window_block_count": 144,
    "window_tx_count": 17000,
    "window_interval": 11520,
    "txrate": 1.475
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getdifficulty

POST

https://rvn-blockbook.nownodes.io/

Returns the current difficulty as a multiple of the minimum difficulty (lowest possible difficulty on the network). This is a relative measure of how difficult it is to find a new block.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetdifficultyrequired

paramsarrayrequired

This method takes no parameters.

Response

200OK

Difficulty value returned successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getdifficulty

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getdifficulty",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getdifficulty",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

getmempoolancestors

POST

https://rvn-blockbook.nownodes.io/

Returns all in-mempool ancestor transactions for a given transaction ID. An ancestor is a transaction whose outputs are used as inputs in another transaction. You can get a summary or detailed object output.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolancestorsrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — Transaction ID to query.
verbose (boolean, optional) — Whether to return a JSON object or just an array of txids. Default is false.

Show child attributes

One of

string

boolean

Response

200OK

Ancestor transaction(s) retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolancestors

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolancestors",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolancestors",
      "params": [
        "txid_example",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolancestors",
  "params": [
    "txid_example",
    true
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid1": {
      "size": 250,
      "fee": 1000,
      "modifiedfee": 1000,
      "time": 1700000000,
      "height": 854998,
      "descendantcount": 1,
      "descendantsize": 600,
      "descendantfees": 3000,
      "ancestorcount": 1,
      "ancestorsize": 250,
      "ancestorfees": 1000,
      "depends": []
    },
    "txid2": "..."
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempooldescendants

POST

https://rvn-blockbook.nownodes.io/

Returns all in-mempool descendant transactions for a given transaction ID. Descendants are transactions that depend on the outputs of the specified transaction. Can return either a simple list of transaction IDs or detailed JSON objects.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempooldescendantsrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — Transaction ID to query descendants for.
verbose (boolean, optional) — Return JSON object if true, or list of txids if false. Default: false.

Show child attributes

One of

string

boolean

Response

200OK

Descendant transactions retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempooldescendants

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempooldescendants",
    "params": [
      "txid_example",
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempooldescendants",
      "params": [
        "txid_example",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempooldescendants",
  "params": [
    "txid_example",
    true
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid1": {
      "size": 300,
      "fee": 2000,
      "modifiedfee": 2100,
      "time": 1700000100,
      "height": 855000,
      "descendantcount": 0,
      "descendantsize": 0,
      "descendantfees": 0,
      "ancestorcount": 2,
      "ancestorsize": 600,
      "ancestorfees": 4000,
      "depends": [
        "txid_example"
      ]
    },
    "txid2": "..."
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempoolentry

POST

https://rvn-blockbook.nownodes.io/

Returns detailed information about a transaction currently in the mempool. Requires the transaction ID (txid) as a parameter.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolentryrequired

paramsArray<string>required

Parameters:

txid (string, required) — Transaction ID to query.

Response

200OK

Mempool entry details retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolentry

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolentry",
    "params": [
      "txid_example"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolentry",
      "params": [
        "txid_example"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmempoolentry",
  "params": [
    "txid_example"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "size": 226,
    "fee": 1210,
    "modifiedfee": 1210,
    "time": 1699990000,
    "height": 854000,
    "descendantcount": 2,
    "descendantsize": 452,
    "descendantfees": 3000,
    "ancestorcount": 1,
    "ancestorsize": 226,
    "ancestorfees": 1210,
    "depends": []
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getmempoolinfo

POST

https://rvn-blockbook.nownodes.io/

Returns details about the current state of the mempool, including size, usage, fees, and more. No parameters required.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetmempoolinforequired

paramsArray<any>required

No parameters required

Response

200OK

Mempool info retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmempoolinfo

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmempoolinfo",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmempoolinfo",
      "params": []
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "size": 1240,
    "bytes": 987654,
    "usage": 1234567,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "maxfeerate": 0.1
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getrawmempool

POST

https://rvn-blockbook.nownodes.io/

Returns all transaction IDs currently in the mempool. If verbose is true, returns a JSON object with detailed mempool entry information for each transaction.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetrawmempoolrequired

paramsArray<boolean>required

Parameters:

verbose (boolean, optional) — If true, return detailed JSON objects instead of txid array. Default: false.

Response

200OK

Mempool transactions retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getrawmempool

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawmempool",
    "params": [
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getrawmempool",
      "params": [
        true
      ]
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid1": {
      "size": 226,
      "fee": 1210,
      "time": 1699990000,
      "height": 854000,
      "startingpriority": 1000,
      "currentpriority": 950,
      "descendantcount": 2,
      "descendantsize": 452,
      "descendantfees": 3000,
      "ancestorcount": 1,
      "ancestorsize": 226,
      "ancestorfees": 1210,
      "depends": []
    }
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

gettxout

POST

https://rvn-blockbook.nownodes.io/

Returns details about an unspent transaction output (UTXO) specified by transaction ID and output index.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgettxoutrequired

paramsArray<string | integer | boolean>required

Parameters:

txid (string, required) — The transaction ID.
vout (integer, required) — The output index.
include_mempool (boolean, optional, default: true) — Whether to include mempool transactions.

Show child attributes

One of

string

integer

boolean

Response

200OK

UTXO details retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

gettxout

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxout",
    "params": [
      "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
      1,
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "gettxout",
      "params": [
        "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
        1,
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxout",
  "params": [
    "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
    1,
    true
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "gettxout",
  "params": [
    "4e568274d63c824f5aa8215e2090d3dcfc97bf9922103dd06171ff779bd8cd5d",
    1,
    true
  ]
}

{
  "result": {
    "bestblock": "000000000000000000010927cae2186713052813554025f0b3c2d2a09f28ff91",
    "confirmations": 1,
    "value": 3.16459147,
    "scriptPubKey": {
      "asm": "OP_DUP OP_HASH160 6582f2551e2a47e1ae8b03fb666401ed7c4552ef OP_EQUALVERIFY OP_CHECKSIG",
      "hex": "a9146582f2551e2a47e1ae8b03fb666401ed7c4552ef87",
      "reqSigs": 1,
      "type": "scripthash",
      "addresses": [
        "3Awm3FNpmwrbvAFVThRUFqgpbVuqWisni9"
      ]
    },
    "coinbase": true
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

gettxoutproof

POST

https://rvn-blockbook.nownodes.io/

Returns a hex-encoded proof that one or more transactions are included in a block. The proof can be validated with verifytxoutproof.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgettxoutproofrequired

paramsArray<Array<string> | string>required

Parameters:

txids (array[string], required) — Array of transaction IDs to prove inclusion.
blockhash (string, optional) — Hash of the block to look for transactions. If omitted, searches the entire blockchain.

Show child attributes

One of

Array<string>

string

Response

200OK

Proof retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

gettxoutproof

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "gettxoutproof",
    "params": [
      [
        "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
        "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
      ],
      null
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "gettxoutproof",
      "params": [
        [
          "ee652f0b40209bd02468de0c6336854f5efdd79fb865560aef2c46f4fa0b4a07",
          "cee11bc3bb3d9db8c4813ed2072a14369a15fcfb9e6bc5cb37a0b5bcc6aa59aa"
        ],
        null
      ]
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

preciousblock

POST

https://rvn-blockbook.nownodes.io/

Marks a block as "precious," causing the node to reconsider the chain from that block. This can be used to manually reorganize the chain to a particular fork.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringpreciousblockrequired

paramsArray<string>required

Parameters:

blockhash (string, required) — The hash of the block to mark as precious.

Response

200OK

Block marked as precious successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

preciousblock

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "preciousblock",
    "params": [
      "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "preciousblock",
      "params": [
        "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "preciousblock",
  "params": [
    "0000000000000000000a7b89e4d3f3bcebd7025fa72d2d9c7b3e8f7a3bc5c8a5"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

"Unknown API_key"

"Service is unavailable"

MAINNET / Mining_RPCs

getmininginfo

POST

https://rvn-blockbook.nownodes.io/

Returns mining-related information such as current block, difficulty, network hash rate, etc. No parameters are required.

Body

application/json

jsonrpcstringrequired

JSON-RPC version (always "1.0")

idstringrequired

Request identifier

methodstringgetmininginforequired

The RPC method name

paramsarrayrequired

No parameters required

Response

200OK

Mining info retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getmininginfo

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getmininginfo",
    "params": []
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getmininginfo",
      "params": []
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getmininginfo",
  "params": []
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "blocks": 854000,
    "currentblockweight": 3990000,
    "currentblocktx": 2450,
    "difficulty": 568382716485.9244,
    "networkhashps": 130000000000000,
    "pooledtx": 5421,
    "chain": "main",
    "warnings": ""
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getnetworkhashps

POST

https://rvn-blockbook.nownodes.io/

Returns the estimated network hashes per second (hash rate) based on the last nblocks blocks. This provides an estimate of the total computational power securing the network.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version (always "1.0")

idstringrequired

The identifier for the request

methodstringgetnetworkhashpsrequired

The name of the RPC method

paramsArray<integer>required

Optional parameters:

nblocks (integer) — The number of blocks to average over. Default is 120.
height (integer) — Use the block at this height instead of the current tip. Use -1 for the tip.

Show child attributes

One of

integer

Response

200OK

Hash rate retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getnetworkhashps

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getnetworkhashps",
    "params": [
      120,
      -1
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getnetworkhashps",
      "params": [
        120,
        -1
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getnetworkhashps",
  "params": [
    120,
    -1
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getnetworkhashps",
  "params": [
    120,
    -1
  ]
}

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

"Unknown API_key"

"Service is unavailable"

MAINNET / Rawtransactions_RPCs

createrawtransaction

POST

https://rvn-blockbook.nownodes.io/

Creates an unsigned raw transaction from a list of inputs and outputs. The transaction is returned as a serialized hex string, which can then be signed and broadcast.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringcreaterawtransactionrequired

paramsArray<Array<object> | object | integer | boolean>required

Parameters:

inputs (array) — List of transaction inputs, each including txid and vout.
outputs (object) — Destination addresses and amounts.
locktime (integer, optional) — Locktime value.
replaceable (boolean, optional) — Whether this transaction signals BIP125 replaceability.

Show child attributes

One of

Array<object>

Show child attributes

txidstring

Transaction ID to spend

voutinteger

Output index

object

integer

boolean

Response

200OK

Unsigned raw transaction created successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

createrawtransaction

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "createrawtransaction",
    "params": [
      [
        {
          "txid": "my_txid_here",
          "vout": 0
        }
      ],
      {
        "bc1qrecipientaddress...": 0.001
      }
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "createrawtransaction",
      "params": [
        [
          {
            "txid": "my_txid_here",
            "vout": 0
          }
        ],
        {
          "bc1qrecipientaddress...": 0.001
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "createrawtransaction",
  "params": [
    [
      {
        "txid": "my_txid_here",
        "vout": 0
      }
    ],
    {
      "bc1qrecipientaddress...": 0.001
    }
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "createrawtransaction",
  "params": [
    [
      {
        "txid": "my_txid_here",
        "vout": 0
      }
    ],
    {
      "bc1qrecipientaddress...": 0.001
    }
  ]
}

{
  "result": "0200000001abcd...00000000",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

decoderawtransaction

POST

https://rvn-blockbook.nownodes.io/

Decodes a raw hex-encoded Bitcoin transaction and returns a JSON object with readable fields. Useful for viewing the contents of raw transactions before broadcasting.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringdecoderawtransactionrequired

paramsArray<string>required

Parameters:

hexstring (string, required) — The raw transaction hex string.

Response

200OK

Transaction decoded successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

decoderawtransaction

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decoderawtransaction",
    "params": [
      "0200000001abcd...00000000"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "decoderawtransaction",
      "params": [
        "0200000001abcd...00000000"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decoderawtransaction",
  "params": [
    "0200000001abcd...00000000"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decoderawtransaction",
  "params": [
    "0200000001abcd...00000000"
  ]
}

{
  "result": {
    "txid": "abcd1234...",
    "hash": "abcd1234...",
    "version": 2,
    "size": 225,
    "vsize": 144,
    "locktime": 0,
    "vin": [
      {
        "txid": "input_txid",
        "vout": 0,
        "scriptSig": {
          "asm": "asm_code",
          "hex": "hex_code"
        },
        "sequence": 4294967295
      }
    ],
    "vout": [
      {
        "value": 0.001,
        "n": 0,
        "scriptPubKey": {
          "asm": "asm_output",
          "hex": "hex_output",
          "type": "witness_v0_keyhash",
          "addresses": [
            "bc1q..."
          ]
        }
      }
    ]
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

decodescript

POST

https://rvn-blockbook.nownodes.io/

Decodes a hex-encoded script (usually scriptPubKey) and returns a JSON representation including the script type and addresses. Useful for analyzing output scripts or creating Pay-to-Script-Hash addresses.

Body

application/json

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringdecodescriptrequired

RPC method name

paramsArray<string>required

Parameters:

hexstring (string, required) — The script in hex format to decode.

Response

200OK

Script decoded successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

decodescript

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "decodescript",
    "params": [
      "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "decodescript",
      "params": [
        "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decodescript",
  "params": [
    "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "decodescript",
  "params": [
    "00141d0f172a0ecb48aee1be1f2687d2963ae33f71a1"
  ]
}

{
  "result": {
    "asm": "OP_0 1d0f172a0ecb48aee1be1f2687d2963ae33f71a1",
    "type": "witness_v0_keyhash",
    "reqSigs": 1,
    "addresses": [
      "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
    ],
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

getrawtransaction

POST

https://rvn-blockbook.nownodes.io/

Retrieves a raw transaction by its txid. If verbose is false or omitted, the result is a raw hex string. If verbose is true, returns a JSON object with decoded transaction details.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringgetrawtransactionrequired

paramsArray<string | boolean>required

Parameters:

txid (string, required) — The transaction ID.
verbose (boolean, optional) — If true, return JSON; if false, return hex. Default: false.

Show child attributes

One of

string

boolean

Response

200OK

Transaction retrieved successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

getrawtransaction

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "getrawtransaction",
    "params": [
      "txid_here",
      true
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "getrawtransaction",
      "params": [
        "txid_here",
        true
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getrawtransaction",
  "params": [
    "txid_here",
    true
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0200000001abcd...00000000",
  "error": null,
  "id": "curltest"
}

{
  "result": {
    "txid": "abcd1234...",
    "hash": "abcd1234...",
    "version": 2,
    "size": 225,
    "vsize": 144,
    "locktime": 0,
    "vin": [
      "..."
    ],
    "vout": [
      "..."
    ],
    "hex": "0200000001abcd...00000000"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

sendrawtransaction

POST

https://rvn-blockbook.nownodes.io/

Submits a raw transaction (hex-encoded string) to the mempool and broadcasts it to the network. Returns the transaction ID (txid) if accepted.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsendrawtransactionrequired

paramsArray<string | number | boolean>required

Parameters:

hexstring (string, required): The raw transaction in hex format.
maxfeerate (number or boolean, optional): Reject transactions with fees higher than this (BTC/KB). Use false to disable check.

Show child attributes

One of

string

number

boolean

Response

200OK

Transaction accepted and broadcasted

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

sendrawtransaction

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "sendrawtransaction",
    "params": [
      "0200000001abcd...00000000",
      false
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "sendrawtransaction",
      "params": [
        "0200000001abcd...00000000",
        false
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "sendrawtransaction",
  "params": [
    "0200000001abcd...00000000",
    false
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "sendrawtransaction",
  "params": [
    "0200000001abcd...00000000",
    false
  ]
}

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

"Unknown API_key"

"Service is unavailable"

signrawtransactionwithkey

POST

https://rvn-blockbook.nownodes.io/

Signs inputs for a raw transaction using explicitly provided private keys, without needing access to a local wallet. Useful for offline signing or stateless transaction construction.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsignrawtransactionwithkeyrequired

paramsArray<string | Array<string> | Array<object>>required

Parameters:

hexstring (string, required): The raw transaction hex string.
privkeys (array of strings, required): Array of WIF private keys.
prevtxs (array, optional): Array of previous output details for inputs to sign.

Show child attributes

One of

string

Array<string>

Array<object>

Show child attributes

txidstring

Transaction ID of the UTXO being spent.

voutinteger

Output index.

scriptPubKeystring

Script of the UTXO.

redeemScriptstring

(optional) Redeem script for P2SH inputs.

witnessScriptstring

(optional) Witness script for P2WSH inputs.

amountnumber

Amount in BTC of the UTXO.

Response

200OK

Transaction signed successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

signrawtransactionwithkey

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "signrawtransactionwithkey",
    "params": [
      "0200000001abcd...00000000",
      [
        "cV...yourWIFkey..."
      ],
      [
        {
          "txid": "abcd1234...",
          "vout": 0,
          "scriptPubKey": "76a914...88ac",
          "redeemScript": "0020...",
          "amount": 0.001
        }
      ]
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "signrawtransactionwithkey",
      "params": [
        "0200000001abcd...00000000",
        [
          "cV...yourWIFkey..."
        ],
        [
          {
            "txid": "abcd1234...",
            "vout": 0,
            "scriptPubKey": "76a914...88ac",
            "redeemScript": "0020...",
            "amount": 0.001
          }
        ]
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signrawtransactionwithkey",
  "params": [
    "0200000001abcd...00000000",
    [
      "cV...yourWIFkey..."
    ],
    [
      {
        "txid": "abcd1234...",
        "vout": 0,
        "scriptPubKey": "76a914...88ac",
        "redeemScript": "0020...",
        "amount": 0.001
      }
    ]
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signrawtransactionwithkey",
  "params": [
    "0200000001abcd...00000000",
    [
      "cV...yourWIFkey..."
    ],
    [
      {
        "txid": "abcd1234...",
        "vout": 0,
        "scriptPubKey": "76a914...88ac",
        "redeemScript": "0020...",
        "amount": 0.001
      }
    ]
  ]
}

{
  "result": {
    "hex": "0200000001abcd...00000000",
    "complete": true,
    "errors": []
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

MAINNET / Util_RPCs

signmessagewithprivkey

POST

https://rvn-blockbook.nownodes.io/

Signs a message with the given private key (in WIF format). Returns the base64-encoded signature.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringsignmessagewithprivkeyrequired

paramsArray<string>required

Parameters:

privkey (string, required): The private key in WIF format.
message (string, required): The message to sign.

Response

200OK

Message signed successfully

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

signmessagewithprivkey

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "signmessagewithprivkey",
    "params": [
      "cV...yourWIFkey...",
      "This is my message."
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "signmessagewithprivkey",
      "params": [
        "cV...yourWIFkey...",
        "This is my message."
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signmessagewithprivkey",
  "params": [
    "cV...yourWIFkey...",
    "This is my message."
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "signmessagewithprivkey",
  "params": [
    "cV...yourWIFkey...",
    "This is my message."
  ]
}

{
  "result": "H+JdK+U...signature==",
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

validateaddress

POST

https://rvn-blockbook.nownodes.io/

Validate a Bitcoin address and return useful information such as whether it is valid, script, or witness, and optionally if it's linked to the wallet.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringvalidateaddressrequired

paramsArray<string>required

Parameters:

address (string, required): The Bitcoin address to validate.

Response

200OK

Address validation result

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

validateaddress

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "validateaddress",
    "params": [
      "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "validateaddress",
      "params": [
        "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "validateaddress",
  "params": [
    "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080"
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "isvalid": true,
    "address": "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kygt080",
    "scriptPubKey": "0014751e76e8199196d454941c45d1b3a323f1433bd6",
    "isscript": false,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "751e76e8199196d454941c45d1b3a323f1433bd6"
  },
  "error": null,
  "id": "curltest"
}

"Unknown API_key"

"Service is unavailable"

verifymessage

POST

https://rvn-blockbook.nownodes.io/

Verify a message signature. Returns true if the signature is valid and corresponds to the provided address and message.

Body

application/json

jsonrpcstringrequired

idstringrequired

methodstringverifymessagerequired

paramsArray<string>required

Parameters:

address (string, required): The Bitcoin address to verify.
signature (string, required): The base64-encoded signature.
message (string, required): The original signed message.

Response

200OK

Signature verification result

401Unauthorized

Unauthorized

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

verifymessage

curl -X POST 'https://rvn-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "1.0",
    "id": "curltest",
    "method": "verifymessage",
    "params": [
      "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
      "H9zbxP...==",
      "This is a test message."
    ]
  }'

const response = await fetch('https://rvn-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "1.0",
      "id": "curltest",
      "method": "verifymessage",
      "params": [
        "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
        "H9zbxP...==",
        "This is a test message."
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "verifymessage",
  "params": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "H9zbxP...==",
    "This is a test message."
  ]
}

response = requests.post('https://rvn-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "verifymessage",
  "params": [
    "1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa",
    "H9zbxP...==",
    "This is a test message."
  ]
}

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

"Unknown API_key"

"Service is unavailable"

Documentation

Authentication

MAINNET / Blockbook

BlockBook

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

MAINNET / Blockchain_RPCs

getbestblockhash

Body

Response

Authorization

getblock

Body

Response

Authorization

getblockchaininfo

Body

Response

Authorization

getblockcount

Body

Response

Authorization

getblockhash

Body

Response

Authorization

getblockheader

Body

Response

Authorization

getblockstats

Body

Response

Authorization

getchaintips

Body

Response

Authorization

getchaintxstats

Body

Response

Authorization

getdifficulty

Body

Response

Authorization

getmempoolancestors

Body

Response

Authorization

getmempooldescendants

Body