Blockbook API

v2.0.0-draft

Base URLs

https://btcbook.nownodes.ioNOWNodes Bitcoin MAINNET endpoint.

https://btc.nownodes.ioNOWNodes Bitcoin MAINNET endpoint.

https://btcbook-testnet.nownodes.ioNOWNodes Bitcoin TESTNET endpoint.

https://btc-testnet.nownodes.ioNOWNodes Bitcoin TESTNET endpoint.

https://btcbook-testnet4.nownodes.ioNOWNodes Bitcoin TESTNET4 endpoint.

https://btc-testnet4.nownodes.ioNOWNodes Bitcoin TESTNET4 endpoint.

Canonical description of the Blockbook public API, based on blockbook-api.ts, api/xpub.go, and the api/server handlers.

API V2 is the current Blockbook API. It is available over REST and over WebSocket using the WsRequest/WsResponse JSON envelope documented below. The normalized API shapes are shared by all supported coins, while blockchain-specific payloads remain extensible where Blockbook returns raw backend JSON.

Amounts are strings in the lowest denomination of the chain, such as satoshis or wei, without a decimal point. Empty fields are omitted: empty means null, an empty string, numeric zero, a null object, or an empty array. Since the same API serves many different chains, this can sometimes hide otherwise meaningful zero values such as transaction version 0.

Legacy API V1 is a Bitcore Insight-compatible subset for Bitcoin-type coins. It is provided as-is for compatibility and is not being extended.

Load estimates are qualitative hints for client authors. Low means a small constant-time lookup or cached metadata. Medium means bounded indexed work or response size. High means potentially large scans, large payloads, broadcast/backend work, or external RPC enrichment. Actual cost also depends on chain speed, backend health, cache warmth, mempool size, pageSize, gap, and the number of addresses, transactions, tokens, filters, or timestamps involved.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

MAINNET / Blockbook

BlockBook

BlockBook operations.

Get Blockbook and backend status.

GET

https://btcbook.nownodes.io/api/status

Returns Blockbook sync state and connected backend metadata.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Blockbook and backend status.

curl -X GET 'https://btcbook.nownodes.io/api/status'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/status')
data = response.json()

{
  "blockbook": {
    "coin": "Bitcoin",
    "network": "BTC",
    "host": "7cefc6cfaa2f",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 952967,
    "lastBlockTime": "2026-06-09T12:29:00.438569983Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:31:13.827027699Z",
    "mempoolSize": 40906,
    "decimals": 8,
    "dbSize": 624383292266,
    "hasFiatRates": true,
    "hasTokenFiatRates": false,
    "currentFiatRatesTime": "2026-06-09T12:30:02.048488697Z",
    "historicalFiatRatesTime": "",
    "historicalTokenFiatRatesTime": "",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "main",
    "blocks": 952967,
    "headers": 952967,
    "bestBlockHash": "0000000000000000000154998a62f1dbcbf10c96207d1794bab046dda9184612",
    "difficulty": "138955357012247.3",
    "sizeOnDisk": 850096367934,
    "version": "310000",
    "subversion": "/Satoshi:31.0.0/",
    "protocolVersion": "70016"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction 'missing-txid' not found"
}

Get status from the API index handler.

GET

https://btcbook.nownodes.io/api

Alias served by the same handler as /api/status on full public interfaces.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get status from the API index handler.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Bitcoin",
    "network": "BTC",
    "host": "7cefc6cfaa2f",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 952967,
    "lastBlockTime": "2026-06-09T12:29:00.438569983Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:31:13.827027699Z",
    "mempoolSize": 40906,
    "decimals": 8,
    "dbSize": 624383292266,
    "hasFiatRates": true,
    "hasTokenFiatRates": false,
    "currentFiatRatesTime": "2026-06-09T12:30:02.048488697Z",
    "historicalFiatRatesTime": "",
    "historicalTokenFiatRatesTime": "",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "main",
    "blocks": 952967,
    "headers": 952967,
    "bestBlockHash": "0000000000000000000154998a62f1dbcbf10c96207d1794bab046dda9184612",
    "difficulty": "138955357012247.3",
    "sizeOnDisk": 850096367934,
    "version": "310000",
    "subversion": "/Satoshi:31.0.0/",
    "protocolVersion": "70016"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Internal error"
}

Get a block hash by height.

GET

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

Returns the block hash for a height on the backend main chain. Blockbook follows the backend main chain; after a rollback or reorg, height lookups resolve to the current main-chain block.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block hash by height.

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block height out of range"
}

Get a block by height or hash.

GET

https://btcbook.nownodes.io/api/v2/block/{blockId}

Returns block information with paged transactions. When full transaction details are unavailable, the response can contain only transaction ids.

Blockbook follows the backend main chain. Height lookups always return the current main-chain block. Hash lookups can return a block from another fork only if the backend still keeps it.

Load estimate: Medium; grows mainly with block transaction count and requested page.

Parameters

blockIdstringrequiredpath

Block height or block hash.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

Response

200OK

Block details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block/{blockId}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "760f8ed32894ccce9c1ea11c8a019cadaa82bcb434b25c30102dd7e43f326217",
  "previousBlockHash": "786a1f9f38493d32fd9f9c104d748490a070bc74a83809103bcadd93ae98288f",
  "nextBlockHash": "151615691b209de41dda4798a07e62db8429488554077552ccb1c4f8c7e9f57a",
  "height": 2648059,
  "confirmations": 47,
  "size": 951,
  "time": 1553096617,
  "version": 536870912,
  "merkleRoot": "6783f6083788c4f69b8af23bd2e4a194cf36ac34d590dfd97e510fe7aebc72c8",
  "nonce": "0",
  "bits": "1a063f3b",
  "difficulty": "2685605.260733312",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 2,
  "txs": [],
  "addressAliases": {}
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get raw block hex.

GET

https://btcbook.nownodes.io/api/v2/rawblock/{blockId}

Returns raw serialized block data.

Load estimate: High for large blocks; payload size grows with the raw block size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Raw block data.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw block hex.

curl -X GET 'https://btcbook.nownodes.io/api/v2/rawblock/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}')
data = response.json()

{
  "hex": "00000020f3e9..."
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get compact block filters.

GET

https://btcbook.nownodes.io/api/v2/block-filters

Returns compact block filters for the script type configured on this Blockbook instance. Provide either lastN or a from/to range. When to is omitted for a range, the current best height is used.

Load estimate: High for wide ranges; work and payload grow linearly with the number of requested filters.

Parameters

scriptTypestringrequiredquery

Script type configured for block filters on this instance, for example taproot.

lastNinteger>= 1query

Return filters for the last N blocks.

frominteger>= 0query

First block height in the requested range.

tointeger>= 0query

Last block height in the requested range. Defaults to the current best height when omitted.

Response

200OK

Block filters keyed by block height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get compact block filters.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block-filters/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block-filters/')
data = response.json()

{
  "P": 19,
  "M": 784931,
  "zeroedKey": false,
  "blockFilters": {
    "860730": {
      "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
      "filter": "0286f0..."
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid scriptType"
}

Get a normalized transaction.

GET

https://btcbook.nownodes.io/api/v2/tx/{txid}

Returns normalized transaction data with the same general structure for all supported coins. Coin-specific fields that do not fit the common shape are omitted here; use getTransactionSpecific for backend-native JSON.

Bitcoin-like confirmed transactions include blockHash, confirmations, blockTime, size/vsize, value/valueIn, fees, and hex. Unconfirmed transactions can include confirmationETABlocks and confirmationETASeconds.

Ethereum-like transactions have one vin and one vout, tokenTransfers, ethereumSpecific execution data, and optional addressAliases. Parsed input data is included when the 4byte signature can be resolved.

For mined transactions, blockTime is the block timestamp. For mempool transactions, blockTime is when this Blockbook instance first learned about the transaction and can differ between instances.

Load estimate: Medium; grows with inputs, outputs, token transfers, address aliases, and spending=true extra lookups.

Parameters

txidstringrequiredpath

Transaction id/hash.

spendingbooleanquery

Include spending transaction metadata for UTXO outputs when available.

Response

200OK

Normalized transaction.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a normalized transaction.

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

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

const data = await response.json();

import requests

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

{
  "txid": "8c1e3dec662d1f2a5e322ccef5eca263f98eb16723c6f990be0c88c1db113fb1",
  "version": 2,
  "lockTime": 860729,
  "vin": [
    {
      "txid": "0eb7b574373de2c88d0dc1444f49947c681d0437d21361f9ebb4dd09c62f2a66",
      "vout": 1,
      "sequence": 4294967293,
      "n": 0,
      "addresses": [
        "bc1qmgwnfjlda4ns3g6g3yz74w6scnn9yu2ts82yyc"
      ],
      "isAddress": true,
      "value": "10106300"
    }
  ],
  "vout": [
    {
      "value": "175000",
      "n": 0,
      "hex": "76a914ecc999d554eaa3efa5e871c28f58b549c36ec51788ac",
      "addresses": [
        "1Nb1ykSD7J5k4RFjJQGsrD9gxBE6jzfNa9"
      ],
      "isAddress": true
    },
    {
      "value": "9888100",
      "n": 1,
      "hex": "001496f152a0919487624bf4f13f46f0d20fa10d9acc",
      "addresses": [
        "bc1qjmc49gy3jjrkyjl57yl5duxjp7ssmxkvh5t2q5"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
  "blockHeight": 860730,
  "confirmations": 1,
  "blockTime": 1725956288,
  "size": 225,
  "vsize": 144,
  "value": "10063100",
  "valueIn": "10106300",
  "fees": "43200",
  "hex": "02000000000101662a..."
}

{
  "txid": "73b1ad97194e426031e5c692869de2d83dc2ff6033fc6f0ab5514345f92eaf0d",
  "version": 2,
  "vin": [
    {
      "txid": "bccbebb64b1613ada74eefa96753088a80fefa53a10e42c66eef1899371bc096",
      "n": 0,
      "addresses": [
        "bc1q9lh77es6m8ztr7muwcec00ewn8fxakpl9jwv8y"
      ],
      "isAddress": true,
      "value": "371042"
    }
  ],
  "vout": [
    {
      "value": "293135",
      "n": 0,
      "hex": "0014aafd7386f99f4b508ec05ee8f7edc2e07126620a",
      "addresses": [
        "bc1q4t7h8phena94prkqtm500mwzupcjvcs2akcdy9"
      ],
      "isAddress": true
    }
  ],
  "blockHeight": -1,
  "confirmations": 0,
  "confirmationETABlocks": 1,
  "confirmationETASeconds": 619,
  "blockTime": 1725959035,
  "size": 222,
  "vsize": 141,
  "value": "367157",
  "valueIn": "371042",
  "fees": "3885",
  "rbf": true
}

{
  "txid": "0xa6c8ae1f91918d09cf2bd67bbac4c168849e672fd81316fa1d26bb9b4fc0f790",
  "vin": [
    {
      "n": 0,
      "addresses": [
        "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775"
      ],
      "isAddress": true
    }
  ],
  "vout": [
    {
      "value": "5615959129349132871",
      "n": 0,
      "addresses": [
        "0xC36442b4a4522E871399CD717aBDD847Ab11FE88"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "0x10ea8cfecda89d6d864c1d919911f819c9febc2b455b48c9918cee3c6cdc4adb",
  "blockHeight": 16529834,
  "confirmations": 3,
  "blockTime": 1675204631,
  "value": "5615959129349132871",
  "fees": "19141662404282012",
  "tokenTransfers": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "from": "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775",
      "to": "0x3B685307C8611AFb2A9E83EBc8743dc20480716E",
      "contract": "0x4E15361FD6b4BB609Fa63C81A2be19d873717870",
      "name": "Fantom Token",
      "symbol": "FTM",
      "decimals": 18,
      "value": "15362368338194882707417"
    }
  ],
  "ethereumSpecific": {
    "status": 1,
    "nonce": 505,
    "gasLimit": 550941,
    "gasUsed": 434686,
    "gasPrice": "44035608242",
    "maxPriorityFeePerGas": "44035608243",
    "maxFeePerGas": "44035608244",
    "baseFeePerGas": "2035608244",
    "data": "0xac9650d800000000000000000000",
    "parsedData": {
      "methodId": "0xfa2b068f",
      "name": "Mint",
      "function": "mint(address, uint256, uint32, bytes32[], address)",
      "params": [
        {
          "type": "address",
          "values": [
            "0xa5fD1Da088598e88ba731B0E29AECF0BC2A31F82"
          ]
        }
      ]
    },
    "internalTransfers": [
      {
        "type": 0,
        "from": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
        "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "value": "5615959129349132871"
      }
    ]
  },
  "addressAliases": {
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
      "Type": "Contract",
      "Alias": "Wrapped Ether"
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get blockchain-specific transaction JSON.

GET

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

Returns transaction data in the exact backend-specific format. Use this when a chain exposes fields that are intentionally absent from the normalized Tx schema.

Load estimate: Medium; payload size depends on chain-specific fields and transaction complexity.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Chain-specific transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blockchain-specific transaction JSON.

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

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

const data = await response.json();

import requests

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

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get raw transaction hex.

GET

https://btcbook.nownodes.io/api/rawtx/{txid}

Unversioned public endpoint exposed by Blockbook for raw transaction data.

Load estimate: Medium; payload size grows with raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Raw transaction hex as a JSON string.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw transaction hex.

curl -X GET 'https://btcbook.nownodes.io/api/rawtx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/rawtx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/rawtx/{txid}')
data = response.json()

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Broadcast a raw transaction using the path.

GET

https://btcbook.nownodes.io/api/v2/sendtx/{hex}

Broadcasts hex-encoded raw transaction data. Prefer POST for large payloads.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v2/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Broadcast a raw transaction using the request body.

POST

https://btcbook.nownodes.io/api/v2/sendtx

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

https://btcbook.nownodes.io/api/v2/address/{address}

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

At details=basic, mempool transactions are not aggregated: unconfirmedBalance, unconfirmedSending, and unconfirmedReceiving are omitted, and unconfirmedTxs reports the raw mempool index size for the address.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Bitcoin address, XPUB, or descriptor value accepted by Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarybooleanfalsequery

When true, includes secondary currency values in supported balance and transaction fields.

contractstringquery

Smart-contract address used to filter token-related address data.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

Response

200OK

Address/account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address/account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
  "balance": "4225100",
  "totalReceived": "4225100",
  "totalSent": "0",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 2,
  "txids": [
    "0db6010dc0815a4bdaa505bd1ccc851056b0d53c7e4ea7af39c4d648a2c0c019",
    "7532920ddc506218337cceac978cce9c7f98e27ad3226dee55f3e934e0b32e80"
  ]
}

{
  "address": "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B",
  "balance": "21004631949601199",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 5,
  "nonTokenTxs": 3,
  "nonce": "1",
  "tokens": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "name": "Tether USD",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "transfers": 3,
      "symbol": "USDT",
      "decimals": 6,
      "balance": "4913000000",
      "baseValue": 3.104622978658881,
      "secondaryValue": 4914.214559070491
    }
  ],
  "secondaryValue": 33.247601671503574,
  "tokensBaseValue": 3.104622978658881,
  "tokensSecondaryValue": 4914.214559070491,
  "totalBaseValue": 3.125627610608482,
  "totalSecondaryValue": 4947.462160741995
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Get XPUB or descriptor account details.

GET

https://btcbook.nownodes.io/api/v2/xpub/{xpub}

Returns balances and transactions of an XPUB or output descriptor for Bitcoin-type coins. Transactions are sorted by block height with newest blocks first. URL-encode descriptors before placing them after /xpub/.

Blockbook expects XPUBs at level 3 of the derivation path, for example m/purpose'/coin_type'/account'. It derives the remaining change/address_index path. The BIP scheme is inferred from the XPUB prefix; unknown prefixes default to BIP44.

Supported descriptors are pkh(xpub), sh(wpkh(xpub)), wpkh(xpub), and tr(xpub). Descriptors can include origin paths and change selectors such as <0;1> or {0,1}; when change is omitted, Blockbook defaults to <0;1>.

Note: usedTokens always reports the total number of used addresses for the XPUB, regardless of the tokens query filter.

Load estimate: High for broad accounts; grows with derived addresses, gap, used address count, pageSize, transaction history, token rows, and protocol enrichment.

Parameters

xpubstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringnonzerousedderivednonzeroquery

Controls which XPUB-derived address rows are included.

filterstring | integerquery

Filter by input/output side or numeric id.

contractstringquery

Contract address filter.

protocolsArray<string>query

Protocol enrichments.

secondarystringquery

Secondary currency code.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

XPUB/descriptor account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get XPUB or descriptor account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF",
  "balance": "90000000",
  "totalReceived": "3093381250",
  "totalSent": "3083381250",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "unconfirmedSending": "0",
  "unconfirmedReceiving": "0",
  "txs": 5,
  "addrTxCount": 5,
  "nonTokenTxs": 0,
  "internalTxs": 0,
  "transactions": [],
  "txids": [
    "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c"
  ],
  "nonce": "",
  "usedTokens": 2,
  "tokens": [
    {
      "type": "XPUBAddress",
      "standard": "XPUBAddress",
      "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS",
      "path": "m/44'/3'/0'/0/0",
      "transfers": 3,
      "decimals": 8,
      "balance": "90000000",
      "totalReceived": "2903986975",
      "totalSent": "2803986975"
    }
  ],
  "secondaryValue": 21195.47633568,
  "tokensBaseValue": 0,
  "tokensSecondaryValue": 0,
  "totalBaseValue": 0,
  "totalSecondaryValue": 21195.47633568,
  "contractInfo": {
    "standard": "ERC20",
    "contract": "0x...",
    "name": "Token",
    "symbol": "TKN",
    "decimals": 18,
    "createdInBlock": 0,
    "destructedInBlock": 0,
    "rates": {
      "baseRate": 0.000523,
      "currency": "usd",
      "secondaryRate": 1.24
    },
    "protocols": {
      "erc4626": {
        "asset": {
          "contract": "0x...",
          "name": "WETH",
          "symbol": "WETH",
          "decimals": 18
        },
        "share": {
          "contract": "0x...",
          "name": "vToken",
          "symbol": "vToken",
          "decimals": 18
        },
        "totalAssets": "123456789",
        "convertToAssets1Share": "1000000000000000000",
        "convertToShares1Asset": "1000000000000000000",
        "previewDeposit1Asset": "999999999999999999",
        "previewRedeem1Share": "1000000000000000000",
        "error": ""
      }
    },
    "blockHeight": 12345678
  },
  "addressAliases": {},
  "stakingPools": [],
  "chainExtraData": {
    "payloadType": "tron",
    "payload": "value"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid XPUB"
}

Get UTXOs for an address, XPUB, or descriptor.

GET

https://btcbook.nownodes.io/api/v2/utxo/{descriptor}

Returns unspent outputs for an address, XPUB, or descriptor on Bitcoin-type coins. By default both confirmed and unconfirmed UTXOs are returned; confirmed=true filters out unconfirmed entries. Results are sorted by block height with newest entries first.

Unconfirmed UTXOs omit height, have confirmations set to 0, and can include lockTime. XPUB and descriptor UTXOs also include address and derivation path when available. Coinbase UTXOs include coinbase=true only up to the coinbase confirmation limit, currently 100 blocks.

Load estimate: Variable; address lookups are usually medium, while XPUB/descriptor lookups grow with gap, derived addresses, and UTXO count.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

confirmedbooleanquery

When true, return only confirmed UTXOs.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get UTXOs for an address, XPUB, or descriptor.

curl -X GET 'https://btcbook.nownodes.io/api/v2/utxo/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}')
data = response.json()

[
  {
    "txid": "13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9",
    "vout": 0,
    "value": "1422303206539",
    "height": 2648043,
    "confirmations": 0,
    "address": "",
    "path": "",
    "lockTime": 2648100,
    "coinbase": true
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get account balance history.

GET

https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}

Returns balance history points for an address, XPUB, or descriptor. from and to are Unix timestamps. groupBy is an aggregation interval in seconds and defaults to 3600. When fiatcurrency is omitted, rates can contain all available currencies. sentToSelf is the amount sent from an address to itself or within addresses of the same XPUB.

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account balance history.

curl -X GET 'https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 7855.9,
      "eur": 6838.13
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11,
      "eur": 7464.45
    }
  }
]

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "0",
    "rates": {
      "usd": 7855.9
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11
    }
  }
]

[
  {
    "time": 1578355200,
    "txs": 6,
    "received": "5000000",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 7734.45
    }
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get contract metadata.

GET

https://btcbook.nownodes.io/api/v2/contract/{contract}

Returns indexed token/contract metadata and optional current protocol enrichments such as ERC4626.

blockHeight reflects the indexer's best block at request time. ERC4626 fields under protocols.erc4626 are fetched through JSON-RPC calls pinned to that exact blockHeight, so the ERC4626 values are a consistent snapshot. If a vault is detected but the underlying asset metadata cannot be resolved, protocols.erc4626 contains error and omits asset; callers must not derive fiat rates or human-unit exchange rates from such a partial response.

Load estimate: Medium; indexed metadata is cheap, but optional protocol enrichment can add backend RPC calls and token metadata lookups.

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

Contract metadata.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get contract metadata.

curl -X GET 'https://btcbook.nownodes.io/api/v2/contract/{contract}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/contract/{contract}')
data = response.json()

{
  "standard": "ERC20",
  "contract": "0x0000000000000000000000000000000000000001",
  "name": "Vault Share",
  "symbol": "vETH",
  "decimals": 18,
  "createdInBlock": 0,
  "destructedInBlock": 0,
  "rates": {
    "baseRate": 0.000523,
    "currency": "usd",
    "secondaryRate": 1.24
  },
  "protocols": {
    "erc4626": {
      "asset": {
        "contract": "0x0000000000000000000000000000000000000002",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18
      },
      "share": {
        "contract": "0x0000000000000000000000000000000000000001",
        "name": "Vault Share",
        "symbol": "vETH",
        "decimals": 18
      },
      "totalAssets": "123456789",
      "convertToAssets1Share": "1000000000000000000",
      "convertToShares1Asset": "1000000000000000000",
      "previewDeposit1Asset": "999999999999999999",
      "previewRedeem1Share": "1000000000000000000",
      "error": ""
    }
  },
  "blockHeight": 12345678
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Contract not found"
}

Estimate a fee target.

GET

https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}

Returns backend fee estimation for the requested confirmation target.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

conservativebooleantruequery

Use conservative smart fee estimation where supported.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate a fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Get fee statistics for a block.

GET

https://btcbook.nownodes.io/api/v2/feestats/{blockId}

Returns fee statistics for transactions in one block.

Load estimate: Medium to high; grows with the number of transactions in the requested block.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Fee statistics.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fee statistics for a block.

curl -X GET 'https://btcbook.nownodes.io/api/v2/feestats/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/feestats/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/feestats/{blockId}')
data = response.json()

{
  "txCount": 1820,
  "totalFeesSat": "182000000",
  "averageFeePerKb": 23.41,
  "decilesFeePerKb": [
    3.1,
    5.4,
    8.8
  ]
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get current or historical fiat rates.

GET

https://btcbook.nownodes.io/api/v2/tickers

Returns currency rates for the requested currency and date. If a rate is unavailable for the exact timestamp, the closest available rate can be returned. Responses include the actual rate timestamp. Without a currency parameter, all available currencies can be returned. A rate of -1 marks an unavailable or invalid currency for that timestamp.

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

Fiat rate ticker.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get current or historical fiat rates.

curl -X GET 'https://btcbook.nownodes.io/api/v2/tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/tickers/')
data = response.json()

{
  "ts": 1574346615,
  "rates": {
    "eur": 7134.1,
    "usd": 7914.5
  }
}

{
  "ts": 1574346615,
  "rates": {
    "usd": 7914.5
  }
}

{
  "ts": 7980386400,
  "rates": {
    "usd": -1
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid currency"
}

Get fiat rates for multiple timestamps.

GET

https://btcbook.nownodes.io/api/v2/multi-tickers

Returns fiat rate tickers for a comma-separated list of Unix timestamps.

Load estimate: Medium; work and payload grow linearly with timestamp count, plus token/currency selection.

Parameters

timestampstringrequiredquery

Comma-separated Unix timestamps.

currencystringquery

Optional currency code.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Fiat rate tickers.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fiat rates for multiple timestamps.

curl -X GET 'https://btcbook.nownodes.io/api/v2/multi-tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

[
  {
    "ts": 1574346615,
    "rates": {
      "usd": 7914.5
    },
    "error": ""
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

Get currencies available for a timestamp.

GET

https://btcbook.nownodes.io/api/v2/tickers-list

Returns available secondary currencies for a date together with the actual rate timestamp.

Load estimate: Low to medium; token lookups and wide currency lists increase response size.

Parameters

timestampinteger<int64>requiredquery

Unix timestamp for the requested currency list.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Available currencies.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get currencies available for a timestamp.

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

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

const data = await response.json();

import requests

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

{
  "ts": 1574346615,
  "available_currencies": [
    "eur",
    "usd"
  ],
  "error": ""
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

BlockBook (legacy)

BlockBook (legacy) operations.

Legacy get block hash by height.

GET

https://btcbook.nownodes.io/api/v1/block-index/{height}

Bitcore Insight-compatible V1 route for Bitcoin-type coins.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block hash by height.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block-index/{height}'

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy get transaction.

GET

https://btcbook.nownodes.io/api/v1/tx/{txid}

Bitcore Insight-compatible V1 transaction shape for Bitcoin-type coins.

Load estimate: Medium; grows with inputs, outputs, scripts, and raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Legacy transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get transaction.

curl -X GET 'https://btcbook.nownodes.io/api/v1/tx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/tx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/tx/{txid}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Legacy get address.

GET

https://btcbook.nownodes.io/api/v1/address/{address}

Bitcore Insight-compatible V1 address shape for Bitcoin-type coins.

Load estimate: Variable; grows with address transaction count and legacy response expansion.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy address payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address.

curl -X GET 'https://btcbook.nownodes.io/api/v1/address/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/address/{address}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get address UTXOs.

GET

https://btcbook.nownodes.io/api/v1/utxo/{address}

Bitcore Insight-compatible V1 UTXO list for Bitcoin-type coins.

Load estimate: Medium; grows with the number of unspent outputs.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address UTXOs.

curl -X GET 'https://btcbook.nownodes.io/api/v1/utxo/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/utxo/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/utxo/{address}')
data = response.json()

[
  {}
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get block by height or hash.

GET

https://btcbook.nownodes.io/api/v1/block/{blockId}

Bitcore Insight-compatible V1 block shape for Bitcoin-type coins.

Load estimate: Medium to high; grows with block transaction count and legacy payload size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Legacy block payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/block/{blockId}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy estimate fee target.

GET

https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}

Bitcore Insight-compatible V1 fee estimate for Bitcoin-type coins.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy estimate fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Legacy broadcast transaction using the path.

GET

https://btcbook.nownodes.io/api/v1/sendtx/{hex}

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v1/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Legacy broadcast transaction using the request body.

POST

https://btcbook.nownodes.io/api/v1/sendtx

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v1/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v1/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

TESTNET / Blockbook

BlockBook

BlockBook operations.

Get Blockbook and backend status.

GET

https://btcbook.nownodes.io/api/status

Returns Blockbook sync state and connected backend metadata.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Blockbook and backend status.

curl -X GET 'https://btcbook.nownodes.io/api/status'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/status')
data = response.json()

{
  "blockbook": {
    "coin": "Testnet",
    "network": "TEST",
    "host": "16f366375ae5",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 4986137,
    "lastBlockTime": "2026-06-09T12:34:12.266701271Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:34:12.254397859Z",
    "mempoolSize": 0,
    "decimals": 8,
    "dbSize": 17242359062,
    "hasFiatRates": false,
    "hasTokenFiatRates": false,
    "currentFiatRatesTime": "",
    "historicalFiatRatesTime": "",
    "historicalTokenFiatRatesTime": "",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "test",
    "blocks": 4986137,
    "headers": 4986137,
    "bestBlockHash": "0000000000005a5525bcafc7dcda26260dedab4dcfeac7cfba6ae218c8e1ae83",
    "difficulty": "154073.0477206891",
    "sizeOnDisk": 209518390605,
    "version": "290000",
    "subversion": "/Satoshi:29.0.0/",
    "protocolVersion": "70016",
    "warnings": "Unknown new rules activated (versionbit 1) "
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction 'missing-txid' not found"
}

Get status from the API index handler.

GET

https://btcbook.nownodes.io/api

Alias served by the same handler as /api/status on full public interfaces.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get status from the API index handler.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Testnet",
    "network": "TEST",
    "host": "16f366375ae5",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 4986137,
    "lastBlockTime": "2026-06-09T12:34:12.266701271Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:34:12.254397859Z",
    "mempoolSize": 0,
    "decimals": 8,
    "dbSize": 17242359062,
    "hasFiatRates": false,
    "hasTokenFiatRates": false,
    "currentFiatRatesTime": "",
    "historicalFiatRatesTime": "",
    "historicalTokenFiatRatesTime": "",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "test",
    "blocks": 4986137,
    "headers": 4986137,
    "bestBlockHash": "0000000000005a5525bcafc7dcda26260dedab4dcfeac7cfba6ae218c8e1ae83",
    "difficulty": "154073.0477206891",
    "sizeOnDisk": 209518390605,
    "version": "290000",
    "subversion": "/Satoshi:29.0.0/",
    "protocolVersion": "70016",
    "warnings": "Unknown new rules activated (versionbit 1) "
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Internal error"
}

Get a block hash by height.

GET

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

Returns the block hash for a height on the backend main chain. Blockbook follows the backend main chain; after a rollback or reorg, height lookups resolve to the current main-chain block.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block hash by height.

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block height out of range"
}

Get a block by height or hash.

GET

https://btcbook.nownodes.io/api/v2/block/{blockId}

Returns block information with paged transactions. When full transaction details are unavailable, the response can contain only transaction ids.

Blockbook follows the backend main chain. Height lookups always return the current main-chain block. Hash lookups can return a block from another fork only if the backend still keeps it.

Load estimate: Medium; grows mainly with block transaction count and requested page.

Parameters

blockIdstringrequiredpath

Block height or block hash.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

Response

200OK

Block details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block/{blockId}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "760f8ed32894ccce9c1ea11c8a019cadaa82bcb434b25c30102dd7e43f326217",
  "previousBlockHash": "786a1f9f38493d32fd9f9c104d748490a070bc74a83809103bcadd93ae98288f",
  "nextBlockHash": "151615691b209de41dda4798a07e62db8429488554077552ccb1c4f8c7e9f57a",
  "height": 2648059,
  "confirmations": 47,
  "size": 951,
  "time": 1553096617,
  "version": 536870912,
  "merkleRoot": "6783f6083788c4f69b8af23bd2e4a194cf36ac34d590dfd97e510fe7aebc72c8",
  "nonce": "0",
  "bits": "1a063f3b",
  "difficulty": "2685605.260733312",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 2,
  "txs": [],
  "addressAliases": {}
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get raw block hex.

GET

https://btcbook.nownodes.io/api/v2/rawblock/{blockId}

Returns raw serialized block data.

Load estimate: High for large blocks; payload size grows with the raw block size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Raw block data.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw block hex.

curl -X GET 'https://btcbook.nownodes.io/api/v2/rawblock/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}')
data = response.json()

{
  "hex": "00000020f3e9..."
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get compact block filters.

GET

https://btcbook.nownodes.io/api/v2/block-filters

Returns compact block filters for the script type configured on this Blockbook instance. Provide either lastN or a from/to range. When to is omitted for a range, the current best height is used.

Load estimate: High for wide ranges; work and payload grow linearly with the number of requested filters.

Parameters

scriptTypestringrequiredquery

Script type configured for block filters on this instance, for example taproot.

lastNinteger>= 1query

Return filters for the last N blocks.

frominteger>= 0query

First block height in the requested range.

tointeger>= 0query

Last block height in the requested range. Defaults to the current best height when omitted.

Response

200OK

Block filters keyed by block height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get compact block filters.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block-filters/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block-filters/')
data = response.json()

{
  "P": 19,
  "M": 784931,
  "zeroedKey": false,
  "blockFilters": {
    "860730": {
      "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
      "filter": "0286f0..."
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid scriptType"
}

Get a normalized transaction.

GET

https://btcbook.nownodes.io/api/v2/tx/{txid}

For mined transactions, blockTime is the block timestamp. For mempool transactions, blockTime is when this Blockbook instance first learned about the transaction and can differ between instances.

Load estimate: Medium; grows with inputs, outputs, token transfers, address aliases, and spending=true extra lookups.

Parameters

txidstringrequiredpath

Transaction id/hash.

spendingbooleanquery

Include spending transaction metadata for UTXO outputs when available.

Response

200OK

Normalized transaction.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a normalized transaction.

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

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

const data = await response.json();

import requests

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

{
  "txid": "8c1e3dec662d1f2a5e322ccef5eca263f98eb16723c6f990be0c88c1db113fb1",
  "version": 2,
  "lockTime": 860729,
  "vin": [
    {
      "txid": "0eb7b574373de2c88d0dc1444f49947c681d0437d21361f9ebb4dd09c62f2a66",
      "vout": 1,
      "sequence": 4294967293,
      "n": 0,
      "addresses": [
        "bc1qmgwnfjlda4ns3g6g3yz74w6scnn9yu2ts82yyc"
      ],
      "isAddress": true,
      "value": "10106300"
    }
  ],
  "vout": [
    {
      "value": "175000",
      "n": 0,
      "hex": "76a914ecc999d554eaa3efa5e871c28f58b549c36ec51788ac",
      "addresses": [
        "1Nb1ykSD7J5k4RFjJQGsrD9gxBE6jzfNa9"
      ],
      "isAddress": true
    },
    {
      "value": "9888100",
      "n": 1,
      "hex": "001496f152a0919487624bf4f13f46f0d20fa10d9acc",
      "addresses": [
        "bc1qjmc49gy3jjrkyjl57yl5duxjp7ssmxkvh5t2q5"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
  "blockHeight": 860730,
  "confirmations": 1,
  "blockTime": 1725956288,
  "size": 225,
  "vsize": 144,
  "value": "10063100",
  "valueIn": "10106300",
  "fees": "43200",
  "hex": "02000000000101662a..."
}

{
  "txid": "73b1ad97194e426031e5c692869de2d83dc2ff6033fc6f0ab5514345f92eaf0d",
  "version": 2,
  "vin": [
    {
      "txid": "bccbebb64b1613ada74eefa96753088a80fefa53a10e42c66eef1899371bc096",
      "n": 0,
      "addresses": [
        "bc1q9lh77es6m8ztr7muwcec00ewn8fxakpl9jwv8y"
      ],
      "isAddress": true,
      "value": "371042"
    }
  ],
  "vout": [
    {
      "value": "293135",
      "n": 0,
      "hex": "0014aafd7386f99f4b508ec05ee8f7edc2e07126620a",
      "addresses": [
        "bc1q4t7h8phena94prkqtm500mwzupcjvcs2akcdy9"
      ],
      "isAddress": true
    }
  ],
  "blockHeight": -1,
  "confirmations": 0,
  "confirmationETABlocks": 1,
  "confirmationETASeconds": 619,
  "blockTime": 1725959035,
  "size": 222,
  "vsize": 141,
  "value": "367157",
  "valueIn": "371042",
  "fees": "3885",
  "rbf": true
}

{
  "txid": "0xa6c8ae1f91918d09cf2bd67bbac4c168849e672fd81316fa1d26bb9b4fc0f790",
  "vin": [
    {
      "n": 0,
      "addresses": [
        "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775"
      ],
      "isAddress": true
    }
  ],
  "vout": [
    {
      "value": "5615959129349132871",
      "n": 0,
      "addresses": [
        "0xC36442b4a4522E871399CD717aBDD847Ab11FE88"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "0x10ea8cfecda89d6d864c1d919911f819c9febc2b455b48c9918cee3c6cdc4adb",
  "blockHeight": 16529834,
  "confirmations": 3,
  "blockTime": 1675204631,
  "value": "5615959129349132871",
  "fees": "19141662404282012",
  "tokenTransfers": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "from": "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775",
      "to": "0x3B685307C8611AFb2A9E83EBc8743dc20480716E",
      "contract": "0x4E15361FD6b4BB609Fa63C81A2be19d873717870",
      "name": "Fantom Token",
      "symbol": "FTM",
      "decimals": 18,
      "value": "15362368338194882707417"
    }
  ],
  "ethereumSpecific": {
    "status": 1,
    "nonce": 505,
    "gasLimit": 550941,
    "gasUsed": 434686,
    "gasPrice": "44035608242",
    "maxPriorityFeePerGas": "44035608243",
    "maxFeePerGas": "44035608244",
    "baseFeePerGas": "2035608244",
    "data": "0xac9650d800000000000000000000",
    "parsedData": {
      "methodId": "0xfa2b068f",
      "name": "Mint",
      "function": "mint(address, uint256, uint32, bytes32[], address)",
      "params": [
        {
          "type": "address",
          "values": [
            "0xa5fD1Da088598e88ba731B0E29AECF0BC2A31F82"
          ]
        }
      ]
    },
    "internalTransfers": [
      {
        "type": 0,
        "from": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
        "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "value": "5615959129349132871"
      }
    ]
  },
  "addressAliases": {
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
      "Type": "Contract",
      "Alias": "Wrapped Ether"
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get blockchain-specific transaction JSON.

GET

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

Returns transaction data in the exact backend-specific format. Use this when a chain exposes fields that are intentionally absent from the normalized Tx schema.

Load estimate: Medium; payload size depends on chain-specific fields and transaction complexity.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Chain-specific transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blockchain-specific transaction JSON.

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

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

const data = await response.json();

import requests

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

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get raw transaction hex.

GET

https://btcbook.nownodes.io/api/rawtx/{txid}

Unversioned public endpoint exposed by Blockbook for raw transaction data.

Load estimate: Medium; payload size grows with raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Raw transaction hex as a JSON string.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw transaction hex.

curl -X GET 'https://btcbook.nownodes.io/api/rawtx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/rawtx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/rawtx/{txid}')
data = response.json()

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Broadcast a raw transaction using the path.

GET

https://btcbook.nownodes.io/api/v2/sendtx/{hex}

Broadcasts hex-encoded raw transaction data. Prefer POST for large payloads.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v2/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Broadcast a raw transaction using the request body.

POST

https://btcbook.nownodes.io/api/v2/sendtx

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

https://btcbook.nownodes.io/api/v2/address/{address}

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Bitcoin address, XPUB, or descriptor value accepted by Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarybooleanfalsequery

When true, includes secondary currency values in supported balance and transaction fields.

contractstringquery

Smart-contract address used to filter token-related address data.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

Response

200OK

Address/account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address/account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "tb1qwntjdqmxlvt5uay6s06mjmwmsjmx6xkercxzp4",
  "balance": "4225100",
  "totalReceived": "4225100",
  "totalSent": "0",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 2,
  "txids": [
    "0db6010dc0815a4bdaa505bd1ccc851056b0d53c7e4ea7af39c4d648a2c0c019",
    "7532920ddc506218337cceac978cce9c7f98e27ad3226dee55f3e934e0b32e80"
  ]
}

{
  "address": "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B",
  "balance": "21004631949601199",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 5,
  "nonTokenTxs": 3,
  "nonce": "1",
  "tokens": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "name": "Tether USD",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "transfers": 3,
      "symbol": "USDT",
      "decimals": 6,
      "balance": "4913000000",
      "baseValue": 3.104622978658881,
      "secondaryValue": 4914.214559070491
    }
  ],
  "secondaryValue": 33.247601671503574,
  "tokensBaseValue": 3.104622978658881,
  "tokensSecondaryValue": 4914.214559070491,
  "totalBaseValue": 3.125627610608482,
  "totalSecondaryValue": 4947.462160741995
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Get XPUB or descriptor account details.

GET

https://btcbook.nownodes.io/api/v2/xpub/{xpub}

Note: usedTokens always reports the total number of used addresses for the XPUB, regardless of the tokens query filter.

Load estimate: High for broad accounts; grows with derived addresses, gap, used address count, pageSize, transaction history, token rows, and protocol enrichment.

Parameters

xpubstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringnonzerousedderivednonzeroquery

Controls which XPUB-derived address rows are included.

filterstring | integerquery

Filter by input/output side or numeric id.

contractstringquery

Contract address filter.

protocolsArray<string>query

Protocol enrichments.

secondarystringquery

Secondary currency code.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

XPUB/descriptor account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get XPUB or descriptor account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF",
  "balance": "90000000",
  "totalReceived": "3093381250",
  "totalSent": "3083381250",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "unconfirmedSending": "0",
  "unconfirmedReceiving": "0",
  "txs": 5,
  "addrTxCount": 5,
  "nonTokenTxs": 0,
  "internalTxs": 0,
  "transactions": [],
  "txids": [
    "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c"
  ],
  "nonce": "",
  "usedTokens": 2,
  "tokens": [
    {
      "type": "XPUBAddress",
      "standard": "XPUBAddress",
      "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS",
      "path": "m/44'/3'/0'/0/0",
      "transfers": 3,
      "decimals": 8,
      "balance": "90000000",
      "totalReceived": "2903986975",
      "totalSent": "2803986975"
    }
  ],
  "secondaryValue": 21195.47633568,
  "tokensBaseValue": 0,
  "tokensSecondaryValue": 0,
  "totalBaseValue": 0,
  "totalSecondaryValue": 21195.47633568,
  "contractInfo": {
    "standard": "ERC20",
    "contract": "0x...",
    "name": "Token",
    "symbol": "TKN",
    "decimals": 18,
    "createdInBlock": 0,
    "destructedInBlock": 0,
    "rates": {
      "baseRate": 0.000523,
      "currency": "usd",
      "secondaryRate": 1.24
    },
    "protocols": {
      "erc4626": {
        "asset": {
          "contract": "0x...",
          "name": "WETH",
          "symbol": "WETH",
          "decimals": 18
        },
        "share": {
          "contract": "0x...",
          "name": "vToken",
          "symbol": "vToken",
          "decimals": 18
        },
        "totalAssets": "123456789",
        "convertToAssets1Share": "1000000000000000000",
        "convertToShares1Asset": "1000000000000000000",
        "previewDeposit1Asset": "999999999999999999",
        "previewRedeem1Share": "1000000000000000000",
        "error": ""
      }
    },
    "blockHeight": 12345678
  },
  "addressAliases": {},
  "stakingPools": [],
  "chainExtraData": {
    "payloadType": "tron",
    "payload": "value"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid XPUB"
}

Get UTXOs for an address, XPUB, or descriptor.

GET

https://btcbook.nownodes.io/api/v2/utxo/{descriptor}

Load estimate: Variable; address lookups are usually medium, while XPUB/descriptor lookups grow with gap, derived addresses, and UTXO count.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

confirmedbooleanquery

When true, return only confirmed UTXOs.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get UTXOs for an address, XPUB, or descriptor.

curl -X GET 'https://btcbook.nownodes.io/api/v2/utxo/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}')
data = response.json()

[
  {
    "txid": "13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9",
    "vout": 0,
    "value": "1422303206539",
    "height": 2648043,
    "confirmations": 0,
    "address": "",
    "path": "",
    "lockTime": 2648100,
    "coinbase": true
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get account balance history.

GET

https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account balance history.

curl -X GET 'https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 7855.9,
      "eur": 6838.13
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11,
      "eur": 7464.45
    }
  }
]

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "0",
    "rates": {
      "usd": 7855.9
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11
    }
  }
]

[
  {
    "time": 1578355200,
    "txs": 6,
    "received": "5000000",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 7734.45
    }
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get contract metadata.

GET

https://btcbook.nownodes.io/api/v2/contract/{contract}

Returns indexed token/contract metadata and optional current protocol enrichments such as ERC4626.

Load estimate: Medium; indexed metadata is cheap, but optional protocol enrichment can add backend RPC calls and token metadata lookups.

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

Contract metadata.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get contract metadata.

curl -X GET 'https://btcbook.nownodes.io/api/v2/contract/{contract}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/contract/{contract}')
data = response.json()

{
  "standard": "ERC20",
  "contract": "0x0000000000000000000000000000000000000001",
  "name": "Vault Share",
  "symbol": "vETH",
  "decimals": 18,
  "createdInBlock": 0,
  "destructedInBlock": 0,
  "rates": {
    "baseRate": 0.000523,
    "currency": "usd",
    "secondaryRate": 1.24
  },
  "protocols": {
    "erc4626": {
      "asset": {
        "contract": "0x0000000000000000000000000000000000000002",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18
      },
      "share": {
        "contract": "0x0000000000000000000000000000000000000001",
        "name": "Vault Share",
        "symbol": "vETH",
        "decimals": 18
      },
      "totalAssets": "123456789",
      "convertToAssets1Share": "1000000000000000000",
      "convertToShares1Asset": "1000000000000000000",
      "previewDeposit1Asset": "999999999999999999",
      "previewRedeem1Share": "1000000000000000000",
      "error": ""
    }
  },
  "blockHeight": 12345678
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Contract not found"
}

Estimate a fee target.

GET

https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}

Returns backend fee estimation for the requested confirmation target.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

conservativebooleantruequery

Use conservative smart fee estimation where supported.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate a fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Get fee statistics for a block.

GET

https://btcbook.nownodes.io/api/v2/feestats/{blockId}

Returns fee statistics for transactions in one block.

Load estimate: Medium to high; grows with the number of transactions in the requested block.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Fee statistics.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fee statistics for a block.

curl -X GET 'https://btcbook.nownodes.io/api/v2/feestats/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/feestats/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/feestats/{blockId}')
data = response.json()

{
  "txCount": 1820,
  "totalFeesSat": "182000000",
  "averageFeePerKb": 23.41,
  "decilesFeePerKb": [
    3.1,
    5.4,
    8.8
  ]
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get current or historical fiat rates.

GET

https://btcbook.nownodes.io/api/v2/tickers

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

Fiat rate ticker.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get current or historical fiat rates.

curl -X GET 'https://btcbook.nownodes.io/api/v2/tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/tickers/')
data = response.json()

{
  "ts": 1574346615,
  "rates": {
    "eur": 7134.1,
    "usd": 7914.5
  }
}

{
  "ts": 1574346615,
  "rates": {
    "usd": 7914.5
  }
}

{
  "ts": 7980386400,
  "rates": {
    "usd": -1
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid currency"
}

Get fiat rates for multiple timestamps.

GET

https://btcbook.nownodes.io/api/v2/multi-tickers

Returns fiat rate tickers for a comma-separated list of Unix timestamps.

Load estimate: Medium; work and payload grow linearly with timestamp count, plus token/currency selection.

Parameters

timestampstringrequiredquery

Comma-separated Unix timestamps.

currencystringquery

Optional currency code.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Fiat rate tickers.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fiat rates for multiple timestamps.

curl -X GET 'https://btcbook.nownodes.io/api/v2/multi-tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

[
  {
    "ts": 1574346615,
    "rates": {
      "usd": 7914.5
    },
    "error": ""
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

Get currencies available for a timestamp.

GET

https://btcbook.nownodes.io/api/v2/tickers-list

Returns available secondary currencies for a date together with the actual rate timestamp.

Load estimate: Low to medium; token lookups and wide currency lists increase response size.

Parameters

timestampinteger<int64>requiredquery

Unix timestamp for the requested currency list.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Available currencies.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get currencies available for a timestamp.

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

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

const data = await response.json();

import requests

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

{
  "ts": 1574346615,
  "available_currencies": [
    "eur",
    "usd"
  ],
  "error": ""
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

BlockBook (legacy)

BlockBook (legacy) operations.

Legacy get block hash by height.

GET

https://btcbook.nownodes.io/api/v1/block-index/{height}

Bitcore Insight-compatible V1 route for Bitcoin-type coins.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block hash by height.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block-index/{height}'

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy get transaction.

GET

https://btcbook.nownodes.io/api/v1/tx/{txid}

Bitcore Insight-compatible V1 transaction shape for Bitcoin-type coins.

Load estimate: Medium; grows with inputs, outputs, scripts, and raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Legacy transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get transaction.

curl -X GET 'https://btcbook.nownodes.io/api/v1/tx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/tx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/tx/{txid}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Legacy get address.

GET

https://btcbook.nownodes.io/api/v1/address/{address}

Bitcore Insight-compatible V1 address shape for Bitcoin-type coins.

Load estimate: Variable; grows with address transaction count and legacy response expansion.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy address payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address.

curl -X GET 'https://btcbook.nownodes.io/api/v1/address/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/address/{address}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get address UTXOs.

GET

https://btcbook.nownodes.io/api/v1/utxo/{address}

Bitcore Insight-compatible V1 UTXO list for Bitcoin-type coins.

Load estimate: Medium; grows with the number of unspent outputs.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address UTXOs.

curl -X GET 'https://btcbook.nownodes.io/api/v1/utxo/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/utxo/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/utxo/{address}')
data = response.json()

[
  {}
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get block by height or hash.

GET

https://btcbook.nownodes.io/api/v1/block/{blockId}

Bitcore Insight-compatible V1 block shape for Bitcoin-type coins.

Load estimate: Medium to high; grows with block transaction count and legacy payload size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Legacy block payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/block/{blockId}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy estimate fee target.

GET

https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}

Bitcore Insight-compatible V1 fee estimate for Bitcoin-type coins.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy estimate fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Legacy broadcast transaction using the path.

GET

https://btcbook.nownodes.io/api/v1/sendtx/{hex}

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v1/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Legacy broadcast transaction using the request body.

POST

https://btcbook.nownodes.io/api/v1/sendtx

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v1/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v1/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

TESTNET4 / Blockbook

BlockBook

BlockBook operations.

Get Blockbook and backend status.

GET

https://btcbook.nownodes.io/api/status

Returns Blockbook sync state and connected backend metadata.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Blockbook and backend status.

curl -X GET 'https://btcbook.nownodes.io/api/status'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/status')
data = response.json()

{
  "blockbook": {
    "coin": "Testnet4",
    "network": "TEST",
    "host": "55257662e395",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 138700,
    "lastBlockTime": "2026-06-09T12:20:30.024204265Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:35:52.461495082Z",
    "mempoolSize": 293,
    "decimals": 8,
    "dbSize": 10418289309,
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "testnet4",
    "blocks": 138700,
    "headers": 138700,
    "bestBlockHash": "0000000000dd7a1fc50d956ba50b7bd1e655a673f06df16ba94b79a6ebbac70a",
    "difficulty": "1",
    "sizeOnDisk": 23860169923,
    "version": "280000",
    "subversion": "/Satoshi:28.0.0/",
    "protocolVersion": "70016"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction 'missing-txid' not found"
}

Get status from the API index handler.

GET

https://btcbook.nownodes.io/api

Alias served by the same handler as /api/status on full public interfaces.

Load estimate: Low; constant-size status metadata.

Response

200OK

Current Blockbook and backend status.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get status from the API index handler.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Testnet4",
    "network": "TEST",
    "host": "55257662e395",
    "version": "0.4.0",
    "gitCommit": "d8c68f2b",
    "buildTime": "2024-10-16T10:45:06+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 138700,
    "lastBlockTime": "2026-06-09T12:20:30.024204265Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:35:52.461495082Z",
    "mempoolSize": 293,
    "decimals": 8,
    "dbSize": 10418289309,
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "testnet4",
    "blocks": 138700,
    "headers": 138700,
    "bestBlockHash": "0000000000dd7a1fc50d956ba50b7bd1e655a673f06df16ba94b79a6ebbac70a",
    "difficulty": "1",
    "sizeOnDisk": 23860169923,
    "version": "280000",
    "subversion": "/Satoshi:28.0.0/",
    "protocolVersion": "70016"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Internal error"
}

Get a block hash by height.

GET

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

Returns the block hash for a height on the backend main chain. Blockbook follows the backend main chain; after a rollback or reorg, height lookups resolve to the current main-chain block.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block hash by height.

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block height out of range"
}

Get a block by height or hash.

GET

https://btcbook.nownodes.io/api/v2/block/{blockId}

Returns block information with paged transactions. When full transaction details are unavailable, the response can contain only transaction ids.

Blockbook follows the backend main chain. Height lookups always return the current main-chain block. Hash lookups can return a block from another fork only if the backend still keeps it.

Load estimate: Medium; grows mainly with block transaction count and requested page.

Parameters

blockIdstringrequiredpath

Block height or block hash.

pageinteger>= 1query

1-based page index. Values outside safe bounds are sanitized to the closest possible page.

Response

200OK

Block details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block/{blockId}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "760f8ed32894ccce9c1ea11c8a019cadaa82bcb434b25c30102dd7e43f326217",
  "previousBlockHash": "786a1f9f38493d32fd9f9c104d748490a070bc74a83809103bcadd93ae98288f",
  "nextBlockHash": "151615691b209de41dda4798a07e62db8429488554077552ccb1c4f8c7e9f57a",
  "height": 2648059,
  "confirmations": 47,
  "size": 951,
  "time": 1553096617,
  "version": 536870912,
  "merkleRoot": "6783f6083788c4f69b8af23bd2e4a194cf36ac34d590dfd97e510fe7aebc72c8",
  "nonce": "0",
  "bits": "1a063f3b",
  "difficulty": "2685605.260733312",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 2,
  "txs": [],
  "addressAliases": {}
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get raw block hex.

GET

https://btcbook.nownodes.io/api/v2/rawblock/{blockId}

Returns raw serialized block data.

Load estimate: High for large blocks; payload size grows with the raw block size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Raw block data.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw block hex.

curl -X GET 'https://btcbook.nownodes.io/api/v2/rawblock/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/rawblock/{blockId}')
data = response.json()

{
  "hex": "00000020f3e9..."
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get compact block filters.

GET

https://btcbook.nownodes.io/api/v2/block-filters

Returns compact block filters for the script type configured on this Blockbook instance. Provide either lastN or a from/to range. When to is omitted for a range, the current best height is used.

Load estimate: High for wide ranges; work and payload grow linearly with the number of requested filters.

Parameters

scriptTypestringrequiredquery

Script type configured for block filters on this instance, for example taproot.

lastNinteger>= 1query

Return filters for the last N blocks.

frominteger>= 0query

First block height in the requested range.

tointeger>= 0query

Last block height in the requested range. Defaults to the current best height when omitted.

Response

200OK

Block filters keyed by block height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get compact block filters.

curl -X GET 'https://btcbook.nownodes.io/api/v2/block-filters/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/block-filters/')
data = response.json()

{
  "P": 19,
  "M": 784931,
  "zeroedKey": false,
  "blockFilters": {
    "860730": {
      "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
      "filter": "0286f0..."
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid scriptType"
}

Get a normalized transaction.

GET

https://btcbook.nownodes.io/api/v2/tx/{txid}

For mined transactions, blockTime is the block timestamp. For mempool transactions, blockTime is when this Blockbook instance first learned about the transaction and can differ between instances.

Load estimate: Medium; grows with inputs, outputs, token transfers, address aliases, and spending=true extra lookups.

Parameters

txidstringrequiredpath

Transaction id/hash.

spendingbooleanquery

Include spending transaction metadata for UTXO outputs when available.

Response

200OK

Normalized transaction.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get a normalized transaction.

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

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

const data = await response.json();

import requests

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

{
  "txid": "8c1e3dec662d1f2a5e322ccef5eca263f98eb16723c6f990be0c88c1db113fb1",
  "version": 2,
  "lockTime": 860729,
  "vin": [
    {
      "txid": "0eb7b574373de2c88d0dc1444f49947c681d0437d21361f9ebb4dd09c62f2a66",
      "vout": 1,
      "sequence": 4294967293,
      "n": 0,
      "addresses": [
        "bc1qmgwnfjlda4ns3g6g3yz74w6scnn9yu2ts82yyc"
      ],
      "isAddress": true,
      "value": "10106300"
    }
  ],
  "vout": [
    {
      "value": "175000",
      "n": 0,
      "hex": "76a914ecc999d554eaa3efa5e871c28f58b549c36ec51788ac",
      "addresses": [
        "1Nb1ykSD7J5k4RFjJQGsrD9gxBE6jzfNa9"
      ],
      "isAddress": true
    },
    {
      "value": "9888100",
      "n": 1,
      "hex": "001496f152a0919487624bf4f13f46f0d20fa10d9acc",
      "addresses": [
        "bc1qjmc49gy3jjrkyjl57yl5duxjp7ssmxkvh5t2q5"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "00000000000000000000effeb0c4460480e6a347deab95332c63007a68646ee5",
  "blockHeight": 860730,
  "confirmations": 1,
  "blockTime": 1725956288,
  "size": 225,
  "vsize": 144,
  "value": "10063100",
  "valueIn": "10106300",
  "fees": "43200",
  "hex": "02000000000101662a..."
}

{
  "txid": "73b1ad97194e426031e5c692869de2d83dc2ff6033fc6f0ab5514345f92eaf0d",
  "version": 2,
  "vin": [
    {
      "txid": "bccbebb64b1613ada74eefa96753088a80fefa53a10e42c66eef1899371bc096",
      "n": 0,
      "addresses": [
        "bc1q9lh77es6m8ztr7muwcec00ewn8fxakpl9jwv8y"
      ],
      "isAddress": true,
      "value": "371042"
    }
  ],
  "vout": [
    {
      "value": "293135",
      "n": 0,
      "hex": "0014aafd7386f99f4b508ec05ee8f7edc2e07126620a",
      "addresses": [
        "bc1q4t7h8phena94prkqtm500mwzupcjvcs2akcdy9"
      ],
      "isAddress": true
    }
  ],
  "blockHeight": -1,
  "confirmations": 0,
  "confirmationETABlocks": 1,
  "confirmationETASeconds": 619,
  "blockTime": 1725959035,
  "size": 222,
  "vsize": 141,
  "value": "367157",
  "valueIn": "371042",
  "fees": "3885",
  "rbf": true
}

{
  "txid": "0xa6c8ae1f91918d09cf2bd67bbac4c168849e672fd81316fa1d26bb9b4fc0f790",
  "vin": [
    {
      "n": 0,
      "addresses": [
        "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775"
      ],
      "isAddress": true
    }
  ],
  "vout": [
    {
      "value": "5615959129349132871",
      "n": 0,
      "addresses": [
        "0xC36442b4a4522E871399CD717aBDD847Ab11FE88"
      ],
      "isAddress": true
    }
  ],
  "blockHash": "0x10ea8cfecda89d6d864c1d919911f819c9febc2b455b48c9918cee3c6cdc4adb",
  "blockHeight": 16529834,
  "confirmations": 3,
  "blockTime": 1675204631,
  "value": "5615959129349132871",
  "fees": "19141662404282012",
  "tokenTransfers": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "from": "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775",
      "to": "0x3B685307C8611AFb2A9E83EBc8743dc20480716E",
      "contract": "0x4E15361FD6b4BB609Fa63C81A2be19d873717870",
      "name": "Fantom Token",
      "symbol": "FTM",
      "decimals": 18,
      "value": "15362368338194882707417"
    }
  ],
  "ethereumSpecific": {
    "status": 1,
    "nonce": 505,
    "gasLimit": 550941,
    "gasUsed": 434686,
    "gasPrice": "44035608242",
    "maxPriorityFeePerGas": "44035608243",
    "maxFeePerGas": "44035608244",
    "baseFeePerGas": "2035608244",
    "data": "0xac9650d800000000000000000000",
    "parsedData": {
      "methodId": "0xfa2b068f",
      "name": "Mint",
      "function": "mint(address, uint256, uint32, bytes32[], address)",
      "params": [
        {
          "type": "address",
          "values": [
            "0xa5fD1Da088598e88ba731B0E29AECF0BC2A31F82"
          ]
        }
      ]
    },
    "internalTransfers": [
      {
        "type": 0,
        "from": "0xC36442b4a4522E871399CD717aBDD847Ab11FE88",
        "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
        "value": "5615959129349132871"
      }
    ]
  },
  "addressAliases": {
    "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2": {
      "Type": "Contract",
      "Alias": "Wrapped Ether"
    }
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get blockchain-specific transaction JSON.

GET

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

Returns transaction data in the exact backend-specific format. Use this when a chain exposes fields that are intentionally absent from the normalized Tx schema.

Load estimate: Medium; payload size depends on chain-specific fields and transaction complexity.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Chain-specific transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blockchain-specific transaction JSON.

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

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

const data = await response.json();

import requests

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

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Get raw transaction hex.

GET

https://btcbook.nownodes.io/api/rawtx/{txid}

Unversioned public endpoint exposed by Blockbook for raw transaction data.

Load estimate: Medium; payload size grows with raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Raw transaction hex as a JSON string.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get raw transaction hex.

curl -X GET 'https://btcbook.nownodes.io/api/rawtx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/rawtx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/rawtx/{txid}')
data = response.json()

"value"

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Broadcast a raw transaction using the path.

GET

https://btcbook.nownodes.io/api/v2/sendtx/{hex}

Broadcasts hex-encoded raw transaction data. Prefer POST for large payloads.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v2/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Broadcast a raw transaction using the request body.

POST

https://btcbook.nownodes.io/api/v2/sendtx

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Broadcasts hex-encoded raw transaction data from the request body. The trailing slash is mandatory in the Blockbook handler. POST bodies are limited to 8 MiB.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast a raw transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

https://btcbook.nownodes.io/api/v2/address/{address}

Returns balances and transactions of an address. Transactions are sorted by block height with newest blocks first. Response size is controlled by the details parameter.

Load estimate: Variable; basic is low, token/tokenBalances and txids/txslight are medium, and txs can be high as it grows with pageSize, transactions, token rows, filters, and protocol enrichment.

Parameters

addressstringrequiredpath

Bitcoin address, XPUB, or descriptor value accepted by Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarybooleanfalsequery

When true, includes secondary currency values in supported balance and transaction fields.

contractstringquery

Smart-contract address used to filter token-related address data.

filterstring | integerquery

Filter account history by input/output side, or by numeric token/internal filter id.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated. Currently supported value: erc4626. Unknown values are rejected.

Response

200OK

Address/account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address/account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "tb1qs5da9y6v4j5nk6pr9gahm665da6ln7c4kyrncn",
  "balance": "4225100",
  "totalReceived": "4225100",
  "totalSent": "0",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 2,
  "txids": [
    "0db6010dc0815a4bdaa505bd1ccc851056b0d53c7e4ea7af39c4d648a2c0c019",
    "7532920ddc506218337cceac978cce9c7f98e27ad3226dee55f3e934e0b32e80"
  ]
}

{
  "address": "0x2df3951b2037bA620C20Ed0B73CCF45Ea473e83B",
  "balance": "21004631949601199",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "txs": 5,
  "nonTokenTxs": 3,
  "nonce": "1",
  "tokens": [
    {
      "type": "ERC20",
      "standard": "ERC20",
      "name": "Tether USD",
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "transfers": 3,
      "symbol": "USDT",
      "decimals": 6,
      "balance": "4913000000",
      "baseValue": 3.104622978658881,
      "secondaryValue": 4914.214559070491
    }
  ],
  "secondaryValue": 33.247601671503574,
  "tokensBaseValue": 3.104622978658881,
  "tokensSecondaryValue": 4914.214559070491,
  "totalBaseValue": 3.125627610608482,
  "totalSecondaryValue": 4947.462160741995
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Get XPUB or descriptor account details.

GET

https://btcbook.nownodes.io/api/v2/xpub/{xpub}

Note: usedTokens always reports the total number of used addresses for the XPUB, regardless of the tokens query filter.

Load estimate: High for broad accounts; grows with derived addresses, gap, used address count, pageSize, transaction history, token rows, and protocol enrichment.

Parameters

xpubstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringnonzerousedderivednonzeroquery

Controls which XPUB-derived address rows are included.

filterstring | integerquery

Filter by input/output side or numeric id.

contractstringquery

Contract address filter.

protocolsArray<string>query

Protocol enrichments.

secondarystringquery

Secondary currency code.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

XPUB/descriptor account details.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get XPUB or descriptor account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "dgub8sbe5Mi8LA4dXB9zPfLZW8arm...9Vjp2HHx91xdDEmWYpmD49fpoUYF",
  "balance": "90000000",
  "totalReceived": "3093381250",
  "totalSent": "3083381250",
  "unconfirmedBalance": "0",
  "unconfirmedTxs": 0,
  "unconfirmedSending": "0",
  "unconfirmedReceiving": "0",
  "txs": 5,
  "addrTxCount": 5,
  "nonTokenTxs": 0,
  "internalTxs": 0,
  "transactions": [],
  "txids": [
    "383ccb5da16fccad294e24a2ef77bdee5810573bb1b252d8b2af4f0ac8c4e04c"
  ],
  "nonce": "",
  "usedTokens": 2,
  "tokens": [
    {
      "type": "XPUBAddress",
      "standard": "XPUBAddress",
      "name": "DUCd1B3YBiXL5By15yXgSLZtEkvwsgEdqS",
      "path": "m/44'/3'/0'/0/0",
      "transfers": 3,
      "decimals": 8,
      "balance": "90000000",
      "totalReceived": "2903986975",
      "totalSent": "2803986975"
    }
  ],
  "secondaryValue": 21195.47633568,
  "tokensBaseValue": 0,
  "tokensSecondaryValue": 0,
  "totalBaseValue": 0,
  "totalSecondaryValue": 21195.47633568,
  "contractInfo": {
    "standard": "ERC20",
    "contract": "0x...",
    "name": "Token",
    "symbol": "TKN",
    "decimals": 18,
    "createdInBlock": 0,
    "destructedInBlock": 0,
    "rates": {
      "baseRate": 0.000523,
      "currency": "usd",
      "secondaryRate": 1.24
    },
    "protocols": {
      "erc4626": {
        "asset": {
          "contract": "0x...",
          "name": "WETH",
          "symbol": "WETH",
          "decimals": 18
        },
        "share": {
          "contract": "0x...",
          "name": "vToken",
          "symbol": "vToken",
          "decimals": 18
        },
        "totalAssets": "123456789",
        "convertToAssets1Share": "1000000000000000000",
        "convertToShares1Asset": "1000000000000000000",
        "previewDeposit1Asset": "999999999999999999",
        "previewRedeem1Share": "1000000000000000000",
        "error": ""
      }
    },
    "blockHeight": 12345678
  },
  "addressAliases": {},
  "stakingPools": [],
  "chainExtraData": {
    "payloadType": "tron",
    "payload": "value"
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid XPUB"
}

Get UTXOs for an address, XPUB, or descriptor.

GET

https://btcbook.nownodes.io/api/v2/utxo/{descriptor}

Load estimate: Variable; address lookups are usually medium, while XPUB/descriptor lookups grow with gap, derived addresses, and UTXO count.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

confirmedbooleanquery

When true, return only confirmed UTXOs.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get UTXOs for an address, XPUB, or descriptor.

curl -X GET 'https://btcbook.nownodes.io/api/v2/utxo/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/utxo/{descriptor}')
data = response.json()

[
  {
    "txid": "13d26cd939bf5d155b1c60054e02d9c9b832a85e6ec4f2411be44b6b5a2842e9",
    "vout": 0,
    "value": "1422303206539",
    "height": 2648043,
    "confirmations": 0,
    "address": "",
    "path": "",
    "lockTime": 2648100,
    "coinbase": true
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get account balance history.

GET

https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}

Load estimate: High; grows with account transaction history, time span, grouping cardinality, fiat rate lookups, and XPUB/descriptor gap.

Parameters

descriptorstringrequiredpath

Address, XPUB, or supported descriptor. URL-encode descriptors.

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account balance history.

curl -X GET 'https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/balancehistory/{descriptor}')
data = response.json()

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "100000",
    "rates": {
      "usd": 7855.9,
      "eur": 6838.13
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11,
      "eur": 7464.45
    }
  }
]

[
  {
    "time": 1578391200,
    "txs": 5,
    "received": "5000000",
    "sent": "0",
    "sentToSelf": "0",
    "rates": {
      "usd": 7855.9
    }
  },
  {
    "time": 1578488400,
    "txs": 1,
    "received": "0",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 8283.11
    }
  }
]

[
  {
    "time": 1578355200,
    "txs": 6,
    "received": "5000000",
    "sent": "5000000",
    "sentToSelf": "0",
    "rates": {
      "usd": 7734.45
    }
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid descriptor"
}

Get contract metadata.

GET

https://btcbook.nownodes.io/api/v2/contract/{contract}

Returns indexed token/contract metadata and optional current protocol enrichments such as ERC4626.

Load estimate: Medium; indexed metadata is cheap, but optional protocol enrichment can add backend RPC calls and token metadata lookups.

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

Contract metadata.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get contract metadata.

curl -X GET 'https://btcbook.nownodes.io/api/v2/contract/{contract}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/contract/{contract}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/contract/{contract}')
data = response.json()

{
  "standard": "ERC20",
  "contract": "0x0000000000000000000000000000000000000001",
  "name": "Vault Share",
  "symbol": "vETH",
  "decimals": 18,
  "createdInBlock": 0,
  "destructedInBlock": 0,
  "rates": {
    "baseRate": 0.000523,
    "currency": "usd",
    "secondaryRate": 1.24
  },
  "protocols": {
    "erc4626": {
      "asset": {
        "contract": "0x0000000000000000000000000000000000000002",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18
      },
      "share": {
        "contract": "0x0000000000000000000000000000000000000001",
        "name": "Vault Share",
        "symbol": "vETH",
        "decimals": 18
      },
      "totalAssets": "123456789",
      "convertToAssets1Share": "1000000000000000000",
      "convertToShares1Asset": "1000000000000000000",
      "previewDeposit1Asset": "999999999999999999",
      "previewRedeem1Share": "1000000000000000000",
      "error": ""
    }
  },
  "blockHeight": 12345678
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Contract not found"
}

Estimate a fee target.

GET

https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}

Returns backend fee estimation for the requested confirmation target.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

conservativebooleantruequery

Use conservative smart fee estimation where supported.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate a fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Get fee statistics for a block.

GET

https://btcbook.nownodes.io/api/v2/feestats/{blockId}

Returns fee statistics for transactions in one block.

Load estimate: Medium to high; grows with the number of transactions in the requested block.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Fee statistics.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fee statistics for a block.

curl -X GET 'https://btcbook.nownodes.io/api/v2/feestats/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v2/feestats/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/feestats/{blockId}')
data = response.json()

{
  "txCount": 1820,
  "totalFeesSat": "182000000",
  "averageFeePerKb": 23.41,
  "decilesFeePerKb": [
    3.1,
    5.4,
    8.8
  ]
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Get current or historical fiat rates.

GET

https://btcbook.nownodes.io/api/v2/tickers

Load estimate: Low to medium; specific currency lookups are cheap, while omitted currency and token lookups increase response size.

Parameters

currencystringquery

Optional currency code. When omitted, all available rates can be returned.

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

Block height or hash whose timestamp should be used for historical rates.

tokenstringquery

Optional token symbol or contract/address key for token-specific rates.

Response

200OK

Fiat rate ticker.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get current or historical fiat rates.

curl -X GET 'https://btcbook.nownodes.io/api/v2/tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/tickers/')
data = response.json()

{
  "ts": 1574346615,
  "rates": {
    "eur": 7134.1,
    "usd": 7914.5
  }
}

{
  "ts": 1574346615,
  "rates": {
    "usd": 7914.5
  }
}

{
  "ts": 7980386400,
  "rates": {
    "usd": -1
  }
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid currency"
}

Get fiat rates for multiple timestamps.

GET

https://btcbook.nownodes.io/api/v2/multi-tickers

Returns fiat rate tickers for a comma-separated list of Unix timestamps.

Load estimate: Medium; work and payload grow linearly with timestamp count, plus token/currency selection.

Parameters

timestampstringrequiredquery

Comma-separated Unix timestamps.

currencystringquery

Optional currency code.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Fiat rate tickers.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get fiat rates for multiple timestamps.

curl -X GET 'https://btcbook.nownodes.io/api/v2/multi-tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v2/multi-tickers/')
data = response.json()

[
  {
    "ts": 1574346615,
    "rates": {
      "usd": 7914.5
    },
    "error": ""
  }
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

Get currencies available for a timestamp.

GET

https://btcbook.nownodes.io/api/v2/tickers-list

Returns available secondary currencies for a date together with the actual rate timestamp.

Load estimate: Low to medium; token lookups and wide currency lists increase response size.

Parameters

timestampinteger<int64>requiredquery

Unix timestamp for the requested currency list.

tokenstringquery

Optional token symbol or contract/address key.

Response

200OK

Available currencies.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get currencies available for a timestamp.

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

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

const data = await response.json();

import requests

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

{
  "ts": 1574346615,
  "available_currencies": [
    "eur",
    "usd"
  ],
  "error": ""
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid timestamp"
}

BlockBook (legacy)

BlockBook (legacy) operations.

Legacy get block hash by height.

GET

https://btcbook.nownodes.io/api/v1/block-index/{height}

Bitcore Insight-compatible V1 route for Bitcoin-type coins.

Load estimate: Low; indexed height-to-hash lookup.

Parameters

heightinteger>= 0requiredpath

Block height on the backend main chain.

Response

200OK

Block hash at the requested height.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block hash by height.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block-index/{height}'

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy get transaction.

GET

https://btcbook.nownodes.io/api/v1/tx/{txid}

Bitcore Insight-compatible V1 transaction shape for Bitcoin-type coins.

Load estimate: Medium; grows with inputs, outputs, scripts, and raw transaction size.

Parameters

txidstringrequiredpath

Transaction id/hash.

Response

200OK

Legacy transaction payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get transaction.

curl -X GET 'https://btcbook.nownodes.io/api/v1/tx/{txid}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/tx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/tx/{txid}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Transaction not found"
}

Legacy get address.

GET

https://btcbook.nownodes.io/api/v1/address/{address}

Bitcore Insight-compatible V1 address shape for Bitcoin-type coins.

Load estimate: Variable; grows with address transaction count and legacy response expansion.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy address payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address.

curl -X GET 'https://btcbook.nownodes.io/api/v1/address/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/address/{address}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get address UTXOs.

GET

https://btcbook.nownodes.io/api/v1/utxo/{address}

Bitcore Insight-compatible V1 UTXO list for Bitcoin-type coins.

Load estimate: Medium; grows with the number of unspent outputs.

Parameters

addressstringrequiredpath

Chain address.

Response

200OK

Legacy UTXO list.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get address UTXOs.

curl -X GET 'https://btcbook.nownodes.io/api/v1/utxo/{address}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/utxo/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/utxo/{address}')
data = response.json()

[
  {}
]

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Address not found"
}

Legacy get block by height or hash.

GET

https://btcbook.nownodes.io/api/v1/block/{blockId}

Bitcore Insight-compatible V1 block shape for Bitcoin-type coins.

Load estimate: Medium to high; grows with block transaction count and legacy payload size.

Parameters

blockIdstringrequiredpath

Block height or block hash.

Response

200OK

Legacy block payload.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy get block by height or hash.

curl -X GET 'https://btcbook.nownodes.io/api/v1/block/{blockId}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/block/{blockId}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/block/{blockId}')
data = response.json()

{}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Block not found"
}

Legacy estimate fee target.

GET

https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}

Bitcore Insight-compatible V1 fee estimate for Bitcoin-type coins.

Load estimate: Low; a small backend fee estimate lookup.

Parameters

blocksinteger>= 1requiredpath

Confirmation target in blocks.

Response

200OK

Decimal fee estimate in chain base currency.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy estimate fee target.

curl -X GET 'https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.00002460"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Fee estimation not available"
}

Legacy broadcast transaction using the path.

GET

https://btcbook.nownodes.io/api/v1/sendtx/{hex}

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Parameters

hexstringrequiredpath

Raw transaction.

Response

200OK

Broadcast result.

400Bad Request

Bad Request

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

503Service Unavailable

Service Unavailable

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the path.

curl -X GET 'https://btcbook.nownodes.io/api/v1/sendtx/{hex}'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/{hex}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://btcbook.nownodes.io/api/v1/sendtx/{hex}')
data = response.json()

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{}

Unknown API_key

Method Not Allowed

Missing API_key

{}

{}

{
  "error": "Invalid transaction hex"
}

Legacy broadcast transaction using the request body.

POST

https://btcbook.nownodes.io/api/v1/sendtx

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

Body

text/plain

Bitcore Insight-compatible V1 broadcast route for Bitcoin-type coins.

Load estimate: High; validates and forwards to the backend, with cost growing with transaction size and backend mempool policy checks.

text/plainstring

Alternative schema variant for this parameter or payload.

string

application/jsonobject

Alternative schema variant for this parameter or payload.

object

Response

200OK

Broadcast result.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

default

Public API error.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Legacy broadcast transaction using the request body.

curl -X POST 'https://btcbook.nownodes.io/api/v1/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://btcbook.nownodes.io/api/v1/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'text/plain',
  },
  body: JSON.stringify("0x00"),
});

const data = await response.json();

import requests

payload = "0x00"

response = requests.post('https://btcbook.nownodes.io/api/v1/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{}

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

MAINNET / Blockchain_RPCs

getbestblockhash

getbestblockhash operations.

getbestblockhash

POST

https://btcbook.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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetbestblockhashrequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Valid response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getbestblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblock

getblock operations.

getblock

POST

https://btcbook.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

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.

Request payload for getblock.

jsonrpcstringrequired

JSON-RPC protocol version used by Bitcoin Core.

idstringrequired

Client-provided request identifier (echoed back in the response).

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

Method parameters.

Response

200OK

Successful JSON-RPC response containing the block data.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblock

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "1.0",
  "id": "curltest",
  "method": "getblock",
  "params": [
    "00000000000000000000c4239950797f48b0c449a66606c8523b802ca02cd525",
    1
  ]
}

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "coinbase_tx": {
      "version": 536870912,
      "locktime": 1,
      "sequence": 1,
      "coinbase": "03abcdef0123456789",
      "witness": "03abcdef0123456789"
    },
    "tx": []
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "coinbase_tx": {
      "version": 536870912,
      "locktime": 1,
      "sequence": 1,
      "coinbase": "03abcdef0123456789",
      "witness": "03abcdef0123456789"
    },
    "tx": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockchaininfo

getblockchaininfo operations.

getblockchaininfo

POST

https://btcbook.nownodes.io/

Returns an object containing various state info regarding blockchain processing.

Body

application/json

Returns an object containing various state info regarding blockchain processing.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockchaininforequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Blockchain state information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockchaininfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockcount

getblockcount operations.

getblockcount

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockcountrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Current block height retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockcount

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockhash

getblockhash operations.

getblockhash

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockhashrequired

JSON-RPC method name.

paramsArray<integer>required

Parameters:

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

Response

200OK

Block hash successfully retrieved

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockheader

getblockheader operations.

getblockheader

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockheaderrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Block header information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockheader

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockstats

getblockstats operations.

getblockstats

POST

https://btcbook.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash.

Body

application/json

Returns a variety of statistics about the block identified by its height or block hash.

Request payload for getblockstats.

jsonrpcstring1.02.0required

JSON-RPC protocol version.

methodstringgetblockstatsrequired

Name of the RPC method.

paramsArray<integer>

Parameters for the method. For getblockstats, this is an array containing a single value – either the block height (integer) or block hash (string).

idstringrequired

Request identifier. The response will echo this value. Can be any string or number.

Response

200OK

Successful block statistics retrieval.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintips

getchaintips operations.

getchaintips

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintipsrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Chain tips retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintips

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintxstats

getchaintxstats operations.

getchaintxstats

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintxstatsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

string

Response

200OK

Chain transaction statistics retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintxstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getdifficulty

getdifficulty operations.

getdifficulty

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetdifficultyrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Difficulty value returned successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getdifficulty

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolancestors

getmempoolancestors operations.

getmempoolancestors

POST

https://btcbook.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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolancestorsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Ancestor transaction(s) retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolancestors

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempooldescendants

getmempooldescendants operations.

getmempooldescendants

POST

https://btcbook.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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempooldescendantsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Descendant transactions retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempooldescendants

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolentry

getmempoolentry operations.

getmempoolentry

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolentryrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Mempool entry details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolentry

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "chunkweight": 1,
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1,
      "chunk": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "chunkweight": 1,
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1,
      "chunk": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolinfo

getmempoolinfo operations.

getmempoolinfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolinforequired

JSON-RPC method name.

paramsArray<any>required

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolinfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true,
    "permitbaremultisig": true,
    "maxdatacarriersize": 1,
    "limitclustercount": 1,
    "limitclustersize": 1,
    "optimal": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true,
    "permitbaremultisig": true,
    "maxdatacarriersize": 1,
    "limitclustercount": 1,
    "limitclustersize": 1,
    "optimal": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkinfo

getnetworkinfo operations.

getnetworkinfo

POST

https://btcbook.nownodes.io/

Returns various state info regarding P2P networking

Body

application/json

Returns various state info regarding P2P networking

Request payload for getnetworkinfo.

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

RPC method name

paramsArray<any>

Method parameters (not required for getnetworkinfo)

Response

200OK

Successful response with network information

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkinfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawmempool

getrawmempool operations.

getrawmempool

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawmempoolrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawmempool

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxout

gettxout operations.

gettxout

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

UTXO details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxout

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxoutproof

gettxoutproof operations.

gettxoutproof

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutproofrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<string>

JSON-RPC method parameters.

string

Response

200OK

Proof retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxoutproof

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

preciousblock

preciousblock operations.

preciousblock

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringpreciousblockrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

preciousblock

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET / Blockchain_RPCs

getbestblockhash

getbestblockhash operations.

getbestblockhash

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetbestblockhashrequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Valid response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getbestblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblock

getblock operations.

getblock

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

integer

Response

200OK

Block information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblock

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "tx": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "tx": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockchaininfo

getblockchaininfo operations.

getblockchaininfo

POST

https://btcbook.nownodes.io/

Returns an object containing various state info regarding blockchain processing.

Body

application/json

Returns an object containing various state info regarding blockchain processing.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockchaininforequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Blockchain state information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockchaininfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockcount

getblockcount operations.

getblockcount

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockcountrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Current block height retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockcount

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockhash

getblockhash operations.

getblockhash

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockhashrequired

JSON-RPC method name.

paramsArray<integer>required

Parameters:

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

Response

200OK

Block hash successfully retrieved

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockheader

getblockheader operations.

getblockheader

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockheaderrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Block header information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockheader

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockstats

getblockstats operations.

getblockstats

POST

https://btcbook.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash.

Body

application/json

Returns a variety of statistics about the block identified by its height or block hash.

Request payload for getblockstats.

jsonrpcstring1.02.0required

JSON-RPC protocol version.

methodstringgetblockstatsrequired

Name of the RPC method.

paramsArray<integer>

Parameters for the method. For getblockstats, this is an array containing a single value – either the block height (integer) or block hash (string).

idstringrequired

Request identifier. The response will echo this value. Can be any string or number.

Response

200OK

Successful block statistics retrieval.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintips

getchaintips operations.

getchaintips

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintipsrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Chain tips retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintips

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintxstats

getchaintxstats operations.

getchaintxstats

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintxstatsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

string

Response

200OK

Chain transaction statistics retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintxstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getdifficulty

getdifficulty operations.

getdifficulty

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetdifficultyrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Difficulty value returned successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getdifficulty

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolancestors

getmempoolancestors operations.

getmempoolancestors

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolancestorsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Ancestor transaction(s) retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolancestors

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempooldescendants

getmempooldescendants operations.

getmempooldescendants

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempooldescendantsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Descendant transactions retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempooldescendants

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "d1d9f8b3a3072f52befe5f74cfe74806e591a025405e75f7ce172dcc2316d904": {
      "vsize": 1,
      "weight": 800,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 1,
      "ancestorcount": 1,
      "ancestorsize": 1,
      "wtxid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
      "fees": {
        "base": 1,
        "modified": 1,
        "ancestor": 1,
        "descendant": 1
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": true,
      "unbroadcast": true
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolentry

getmempoolentry operations.

getmempoolentry

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolentryrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Mempool entry details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolentry

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolinfo

getmempoolinfo operations.

getmempoolinfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolinforequired

JSON-RPC method name.

paramsArray<any>required

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolinfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkinfo

getnetworkinfo operations.

getnetworkinfo

POST

https://btcbook.nownodes.io/

Returns various state info regarding P2P networking

Body

application/json

Returns various state info regarding P2P networking

Request payload for getnetworkinfo.

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

RPC method name

paramsArray<any>

Method parameters (not required for getnetworkinfo)

Response

200OK

Successful response with network information

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkinfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawmempool

getrawmempool operations.

getrawmempool

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawmempoolrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawmempool

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxout

gettxout operations.

gettxout

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

UTXO details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxout

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxoutproof

gettxoutproof operations.

gettxoutproof

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutproofrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<string>

JSON-RPC method parameters.

string

Response

200OK

Proof retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxoutproof

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

preciousblock

preciousblock operations.

preciousblock

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringpreciousblockrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

preciousblock

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET4 / Blockchain_RPCs

getbestblockhash

getbestblockhash operations.

getbestblockhash

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetbestblockhashrequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Valid response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getbestblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblock

getblock operations.

getblock

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

integer

Response

200OK

Block information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblock

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "tx": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "strippedsize": 200,
    "size": 227,
    "weight": 800,
    "tx": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockchaininfo

getblockchaininfo operations.

getblockchaininfo

POST

https://btcbook.nownodes.io/

Returns an object containing various state info regarding blockchain processing.

Body

application/json

Returns an object containing various state info regarding blockchain processing.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockchaininforequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

Response

200OK

Blockchain state information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockchaininfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "chain": "main",
    "blocks": 956047,
    "headers": 956047,
    "bestblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "difficulty": 126460031820548.33,
    "time": 1770000000,
    "mediantime": 1770000000,
    "verificationprogress": 0.99999,
    "initialblockdownload": false,
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "size_on_disk": 850000000000,
    "pruned": false,
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockcount

getblockcount operations.

getblockcount

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockcountrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Current block height retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockcount

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockhash

getblockhash operations.

getblockhash

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockhashrequired

JSON-RPC method name.

paramsArray<integer>required

Parameters:

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

Response

200OK

Block hash successfully retrieved

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockhash

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockheader

getblockheader operations.

getblockheader

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetblockheaderrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Block header information retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockheader

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "height": 956047,
    "version": 536870912,
    "versionHex": "20000000",
    "merkleroot": "8f837d8a16fc4b12271b30f898f22cf86566f6647381134b4035dced40d156fb",
    "time": 1770000000,
    "mediantime": 1770000000,
    "nonce": "0x0",
    "bits": "17021369",
    "difficulty": "0x2",
    "chainwork": "00000000000000000000000000000000000000012160395a966c9f28bacc7b94",
    "nTx": 1,
    "previousblockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getblockstats

getblockstats operations.

getblockstats

POST

https://btcbook.nownodes.io/

Returns a variety of statistics about the block identified by its height or block hash.

Body

application/json

Returns a variety of statistics about the block identified by its height or block hash.

Request payload for getblockstats.

jsonrpcstring1.02.0required

JSON-RPC protocol version.

methodstringgetblockstatsrequired

Name of the RPC method.

paramsArray<integer>

Parameters for the method. For getblockstats, this is an array containing a single value – either the block height (integer) or block hash (string).

idstringrequired

Request identifier. The response will echo this value. Can be any string or number.

Response

200OK

Successful block statistics retrieval.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getblockstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "avgfee": 1410,
    "avgfeerate": 10,
    "avgtxsize": 141,
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "feerate_percentiles": [
      8,
      10,
      12,
      15,
      20
    ],
    "height": 956047,
    "ins": 1,
    "maxfee": 1410,
    "maxfeerate": 10,
    "maxtxsize": 141,
    "medianfee": 1410,
    "mediantime": 1770000000,
    "mediantxsize": 141,
    "minfee": 1410,
    "minfeerate": 10,
    "mintxsize": 141,
    "outs": 2,
    "subsidy": 312500000,
    "swtotal_size": 141,
    "swtotal_weight": 561,
    "swtxs": 1,
    "time": 1770000000,
    "total_out": 312500000,
    "total_size": 141,
    "total_weight": 561,
    "totalfee": 1410,
    "txs": 1,
    "utxo_increase": 1,
    "utxo_size_inc": 172
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintips

getchaintips operations.

getchaintips

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintipsrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Chain tips retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintips

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": [
    {
      "height": 956047,
      "hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
      "branchlen": 0,
      "status": "active"
    },
    {
      "height": 956020,
      "hash": "00000000000000000001b4e19b8d3f6a5c9e2d7b1a0f1234567890abcdef1234",
      "branchlen": 2,
      "status": "valid-fork"
    }
  ],
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getchaintxstats

getchaintxstats operations.

getchaintxstats

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetchaintxstatsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

string

Response

200OK

Chain transaction statistics retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getchaintxstats

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "time": 1770000000,
    "txcount": 1200000000,
    "window_final_block_hash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "window_final_block_height": 956047,
    "window_block_count": 144,
    "window_interval": 1,
    "window_tx_count": 300000,
    "txrate": 3.5
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getdifficulty

getdifficulty operations.

getdifficulty

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetdifficultyrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

Response

200OK

Difficulty value returned successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getdifficulty

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolancestors

getmempoolancestors operations.

getmempoolancestors

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolancestorsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Ancestor transaction(s) retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolancestors

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempooldescendants

getmempooldescendants operations.

getmempooldescendants

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempooldescendantsrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Descendant transactions retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempooldescendants

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolentry

getmempoolentry operations.

getmempoolentry

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolentryrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Mempool entry details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolentry

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "vsize": 200,
    "weight": 800,
    "time": 1770000000,
    "height": 956047,
    "descendantcount": 1,
    "descendantsize": 200,
    "ancestorcount": 1,
    "ancestorsize": 200,
    "wtxid": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "fees": {
      "base": 0.00001,
      "modified": 1,
      "ancestor": 1,
      "descendant": 1
    },
    "depends": [],
    "spentby": [],
    "bip125-replaceable": true,
    "unbroadcast": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getmempoolinfo

getmempoolinfo operations.

getmempoolinfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetmempoolinforequired

JSON-RPC method name.

paramsArray<any>required

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmempoolinfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "loaded": true,
    "size": 10000,
    "bytes": 5000000,
    "usage": 10000000,
    "total_fee": 1,
    "maxmempool": 300000000,
    "mempoolminfee": 0.00001,
    "minrelaytxfee": 0.00001,
    "incrementalrelayfee": 1,
    "unbroadcastcount": 1,
    "fullrbf": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkinfo

getnetworkinfo operations.

getnetworkinfo

POST

https://btcbook.nownodes.io/

Returns various state info regarding P2P networking

Body

application/json

Returns various state info regarding P2P networking

Request payload for getnetworkinfo.

jsonrpcstringrequired

JSON-RPC version

idstringrequired

Request identifier

methodstringrequired

RPC method name

paramsArray<any>

Method parameters (not required for getnetworkinfo)

Response

200OK

Successful response with network information

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkinfo

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": null,
  "id": "curltest"
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": "curltest"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "version": 280000,
    "subversion": "/Satoshi:28.0.0/",
    "protocolversion": 70016,
    "localservices": "0000000000000409",
    "localservicesnames": [],
    "localrelay": true,
    "timeoffset": 0,
    "networkactive": true,
    "connections": 8,
    "connections_in": 1,
    "connections_out": 1,
    "networks": [],
    "relayfee": 0.00001,
    "incrementalfee": 1,
    "localaddresses": [],
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawmempool

getrawmempool operations.

getrawmempool

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawmempoolrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawmempool

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a": {
      "vsize": 141,
      "weight": 561,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000141,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    },
    "c28bfec8d3707d83615393416fc7b4d6cb35be8da8426c7c64b6be60492cc676": {
      "vsize": 225,
      "weight": 900,
      "time": 1770000000,
      "height": 956047,
      "descendantcount": 1,
      "descendantsize": 141,
      "ancestorcount": 1,
      "ancestorsize": 141,
      "wtxid": "9f0c6c9d98f1d25f8b7d4e8c3a2b1f0e1234567890abcdef1234567890abcdef",
      "fees": {
        "base": 0.0000225,
        "modified": 0.0000141,
        "ancestor": 0.0000141,
        "descendant": 0.0000141
      },
      "depends": [],
      "spentby": [],
      "bip125-replaceable": false,
      "unbroadcast": false
    }
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxout

gettxout operations.

gettxout

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

UTXO details retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxout

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "bestblock": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "value": 3.17143553,
    "scriptPubKey": {
      "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
      "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
      "hex": "0200000001...",
      "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
      "type": "0x0"
    },
    "coinbase": true
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

gettxoutproof

gettxoutproof operations.

gettxoutproof

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgettxoutproofrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<string>

JSON-RPC method parameters.

string

Response

200OK

Proof retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

gettxoutproof

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "00000020f8b8f8c61f6ad6f6d2b31c7ce4c1bb8f8b8f8c61f6ad6f6d2b31c7ce4c1bb",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

preciousblock

preciousblock operations.

preciousblock

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringpreciousblockrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

preciousblock

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

MAINNET / Mining_RPCs

getmininginfo

getmininginfo operations.

getmininginfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC version (always "1.0")

idstringrequired

Request identifier

methodstringgetmininginforequired

The RPC method name

paramsarrayrequired

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmininginfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "blocks": 956047,
    "currentblockweight": 3993816,
    "currentblocktx": 3000,
    "bits": "17021369",
    "difficulty": 126460031820548.33,
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "blockmintxfee": 1,
    "chain": "main",
    "next": {
      "height": 956047,
      "bits": "17021369",
      "difficulty": "0x2",
      "target": "0000000000000000000213690000000000000000000000000000000000000000"
    },
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "blocks": 956047,
    "currentblockweight": 3993816,
    "currentblocktx": 3000,
    "bits": "17021369",
    "difficulty": 126460031820548.33,
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "blockmintxfee": 1,
    "chain": "main",
    "next": {
      "height": 956047,
      "bits": "17021369",
      "difficulty": "0x2",
      "target": "0000000000000000000213690000000000000000000000000000000000000000"
    },
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkhashps

getnetworkhashps operations.

getnetworkhashps

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

Response

200OK

Hash rate retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkhashps

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET / Mining_RPCs

getmininginfo

getmininginfo operations.

getmininginfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC version (always "1.0")

idstringrequired

Request identifier

methodstringgetmininginforequired

The RPC method name

paramsarrayrequired

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmininginfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "blocks": 956047,
    "bits": "17021369",
    "difficulty": 126460031820548.33,
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "chain": "main",
    "next": {
      "height": 956047,
      "bits": "17021369",
      "difficulty": "0x2",
      "target": "0000000000000000000213690000000000000000000000000000000000000000"
    },
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "blocks": 956047,
    "bits": "17021369",
    "difficulty": 126460031820548.33,
    "target": "0000000000000000000213690000000000000000000000000000000000000000",
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "chain": "main",
    "next": {
      "height": 956047,
      "bits": "17021369",
      "difficulty": "0x2",
      "target": "0000000000000000000213690000000000000000000000000000000000000000"
    },
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkhashps

getnetworkhashps operations.

getnetworkhashps

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

Response

200OK

Hash rate retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkhashps

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET4 / Mining_RPCs

getmininginfo

getmininginfo operations.

getmininginfo

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC version (always "1.0")

idstringrequired

Request identifier

methodstringgetmininginforequired

The RPC method name

paramsarrayrequired

No parameters required

Response

200OK

Successful response

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getmininginfo

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "blocks": 956047,
    "difficulty": 126460031820548.33,
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "chain": "main",
    "warnings": ""
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "blocks": 956047,
    "difficulty": 126460031820548.33,
    "networkhashps": 830000000000000000000,
    "pooledtx": 10000,
    "chain": "main",
    "warnings": ""
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getnetworkhashps

getnetworkhashps operations.

getnetworkhashps

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

integer

Response

200OK

Hash rate retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getnetworkhashps

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

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

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": 1,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

MAINNET / Rawtransactions_RPCs

createrawtransaction

createrawtransaction operations.

createrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringcreaterawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<object>

Show child attributes

txidstring

Transaction ID to spend

voutinteger

Output index

JSON-RPC method parameters.

object

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

Unsigned raw transaction created successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

createrawtransaction

curl -X POST 'https://btcbook.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
      },
      0
    ]
  }'

const response = await fetch('https://btcbook.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
        },
        0
      ]
    }),
});

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
    },
    0
  ]
}

response = requests.post('https://btcbook.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
    },
    0
  ]
}

{
  "result": "02000000000100",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "02000000000100",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decoderawtransaction

decoderawtransaction operations.

decoderawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringdecoderawtransactionrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Transaction decoded successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decoderawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decodescript

decodescript operations.

decodescript

POST

https://btcbook.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

Request payload containing the documented method parameters and client request identifier.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decodescript

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawtransaction

getrawtransaction operations.

getrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Transaction retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawtransaction

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

sendrawtransaction

sendrawtransaction operations.

sendrawtransaction

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsendrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

number

JSON-RPC method parameters.

boolean

Response

200OK

Transaction accepted and broadcasted

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

sendrawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

signrawtransactionwithkey

signrawtransactionwithkey operations.

signrawtransactionwithkey

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignrawtransactionwithkeyrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signrawtransactionwithkey

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET / Rawtransactions_RPCs

createrawtransaction

createrawtransaction operations.

createrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringcreaterawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<object>

Show child attributes

txidstring

Transaction ID to spend

voutinteger

Output index

JSON-RPC method parameters.

object

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

Unsigned raw transaction created successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

createrawtransaction

curl -X POST 'https://btcbook.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
      },
      0
    ]
  }'

const response = await fetch('https://btcbook.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
        },
        0
      ]
    }),
});

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
    },
    0
  ]
}

response = requests.post('https://btcbook.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
    },
    0
  ]
}

{
  "result": "02000000000100",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "02000000000100",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decoderawtransaction

decoderawtransaction operations.

decoderawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringdecoderawtransactionrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Transaction decoded successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decoderawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decodescript

decodescript operations.

decodescript

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decodescript

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawtransaction

getrawtransaction operations.

getrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Transaction retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawtransaction

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

sendrawtransaction

sendrawtransaction operations.

sendrawtransaction

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsendrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

number

JSON-RPC method parameters.

boolean

Response

200OK

Transaction accepted and broadcasted

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

sendrawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

signrawtransactionwithkey

signrawtransactionwithkey operations.

signrawtransactionwithkey

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignrawtransactionwithkeyrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signrawtransactionwithkey

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET4 / Rawtransactions_RPCs

createrawtransaction

createrawtransaction operations.

createrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringcreaterawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

Array<object>

Show child attributes

txidstring

Transaction ID to spend

voutinteger

Output index

JSON-RPC method parameters.

object

JSON-RPC method parameters.

integer

JSON-RPC method parameters.

boolean

Response

200OK

Unsigned raw transaction created successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

createrawtransaction

curl -X POST 'https://btcbook.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
      },
      0
    ]
  }'

const response = await fetch('https://btcbook.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
        },
        0
      ]
    }),
});

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
    },
    0
  ]
}

response = requests.post('https://btcbook.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
    },
    0
  ]
}

{
  "result": "02000000000100",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "02000000000100",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decoderawtransaction

decoderawtransaction operations.

decoderawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringdecoderawtransactionrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Transaction decoded successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decoderawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

decodescript

decodescript operations.

decodescript

POST

https://btcbook.nownodes.io/

Body

application/json

Request payload containing the documented method parameters and client request identifier.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

decodescript

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "asm": "0 7086320071974eef5e72eaa01dd9096e10c03834",
    "desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#example",
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "type": "witness_v0_keyhash",
    "p2sh": "3QJmV3qfvL9SuYo34YihAf3sRCW3qSinyC"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

getrawtransaction

getrawtransaction operations.

getrawtransaction

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringgetrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

boolean

Response

200OK

Transaction retrieved successfully

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

getrawtransaction

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
    "hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
    "version": 2,
    "size": 227,
    "vsize": 200,
    "weight": 800,
    "locktime": 956046,
    "vin": [],
    "vout": [],
    "hex": "0200000001...",
    "blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
    "confirmations": 1,
    "time": 1770000000,
    "blocktime": 1
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

sendrawtransaction

sendrawtransaction operations.

sendrawtransaction

POST

https://btcbook.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

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsendrawtransactionrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

string

JSON-RPC method parameters.

number

JSON-RPC method parameters.

boolean

Response

200OK

Transaction accepted and broadcasted

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

sendrawtransaction

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

signrawtransactionwithkey

signrawtransactionwithkey operations.

signrawtransactionwithkey

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignrawtransactionwithkeyrequired

JSON-RPC method name.

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

Single entry in the params array.

One of

JSON-RPC method parameters.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signrawtransactionwithkey

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "hex": "0200000001e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a000000006a47304402204e45e16932b8af514961a1d3a1a25fdf3f4f7732e9d624c6c61548ab5fb8cd410220181522ec8eca07de4860a4acdd12909d831cc56cbbac4622082221a8768d1d09012103abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdffffffff0100e1f505000000001976a91489abcdefabbaabbaabbaabbaabbaabbaabbaabba88ac00000000",
    "complete": true,
    "errors": []
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

MAINNET / Util_RPCs

signmessagewithprivkey

signmessagewithprivkey operations.

signmessagewithprivkey

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignmessagewithprivkeyrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signmessagewithprivkey

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

validateaddress

validateaddress operations.

validateaddress

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringvalidateaddressrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Address validation result

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

validateaddress

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "isvalid": true,
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "isvalid": true,
    "address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

verifymessage

verifymessage operations.

verifymessage

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringverifymessagerequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

verifymessage

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.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": null,
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET / Util_RPCs

signmessagewithprivkey

signmessagewithprivkey operations.

signmessagewithprivkey

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignmessagewithprivkeyrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signmessagewithprivkey

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

validateaddress

validateaddress operations.

validateaddress

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringvalidateaddressrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Address validation result

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

validateaddress

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "isvalid": true,
    "address": "tb1qwntjdqmxlvt5uay6s06mjmwmsjmx6xkercxzp4",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "isvalid": true,
    "address": "tb1qwntjdqmxlvt5uay6s06mjmwmsjmx6xkercxzp4",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

verifymessage

verifymessage operations.

verifymessage

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringverifymessagerequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

verifymessage

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.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": null,
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

TESTNET4 / Util_RPCs

signmessagewithprivkey

signmessagewithprivkey operations.

signmessagewithprivkey

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringsignmessagewithprivkeyrequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

signmessagewithprivkey

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": "H8s3V4J5f7n9k2mQ6xYzExampleSignatureBase64=",
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

validateaddress

validateaddress operations.

validateaddress

POST

https://btcbook.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

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.

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringvalidateaddressrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

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

Response

200OK

Address validation result

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

validateaddress

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

const response = await fetch('https://btcbook.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://btcbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

{
  "result": {
    "isvalid": true,
    "address": "tb1qs5da9y6v4j5nk6pr9gahm665da6ln7c4kyrncn",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": {
    "isvalid": true,
    "address": "tb1qs5da9y6v4j5nk6pr9gahm665da6ln7c4kyrncn",
    "scriptPubKey": "00147086320071974eef5e72eaa01dd9096e10c03834",
    "isscript": true,
    "iswitness": true,
    "witness_version": 0,
    "witness_program": "7086320071974eef5e72eaa01dd9096e10c03834"
  },
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

verifymessage

verifymessage operations.

verifymessage

POST

https://btcbook.nownodes.io/

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

Body

application/json

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

Request payload containing the documented method parameters and client request identifier.

jsonrpcstringrequired

JSON-RPC protocol version.

idstringrequired

Client-provided request identifier echoed in the response.

methodstringverifymessagerequired

JSON-RPC method name.

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: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

verifymessage

curl -X POST 'https://btcbook.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://btcbook.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://btcbook.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": null,
  "error": null,
  "id": 1
}

{
  "result": null,
  "error": {
    "code": -3,
    "message": "Invalid parameter"
  },
  "id": 1
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "result": null,
  "error": {
    "code": -28,
    "message": "Service temporarily unavailable"
  },
  "id": "curltest"
}

Documentation

Authentication

MAINNET / Blockbook

BlockBook

Response

Authorization

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

Body

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

Parameters

Response

Authorization

BlockBook (legacy)

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response