BSC Blockbook API

v2.0.0-draft

Base URLs

https://bsc-blockbook.nownodes.ioNOWNodes BSC Blockbook endpoint.

https://bsc.nownodes.ioNOWNodes BSC JSON-RPC 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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/status'

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "BNB Smart Chain Archive",
    "network": "BNB",
    "host": "63428cd743ea",
    "version": "devel",
    "gitCommit": "3e4c0da",
    "buildTime": "2026-05-07T23:17:36+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 103223019,
    "lastBlockTime": "2026-06-09T12:26:41.876246488Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:26:42.188219498Z",
    "mempoolSize": 905243,
    "decimals": 18,
    "dbSize": 2577629015447,
    "hasFiatRates": true,
    "hasTokenFiatRates": true,
    "currentFiatRatesTime": "2026-06-09T12:21:06.936303711Z",
    "historicalFiatRatesTime": "2026-06-09T00:00:00Z",
    "historicalTokenFiatRatesTime": "2025-11-25T06:33:20.61689154Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 103223018,
    "bestBlockHash": "0xf9382b9281999d73557fb535508dc842bc4e55dee67d48ebd88c2f96ca3f6b8e",
    "difficulty": "2",
    "version": "reth/v1.10.2-95d649f/x86_64-unknown-linux-gnu"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

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

Get status from the API index handler.

GET

https://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/'

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "BNB Smart Chain Archive",
    "network": "BNB",
    "host": "63428cd743ea",
    "version": "devel",
    "gitCommit": "3e4c0da",
    "buildTime": "2026-05-07T23:17:36+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 103223019,
    "lastBlockTime": "2026-06-09T12:26:41.876246488Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-09T12:26:42.188219498Z",
    "mempoolSize": 905243,
    "decimals": 18,
    "dbSize": 2577629015447,
    "hasFiatRates": true,
    "hasTokenFiatRates": true,
    "currentFiatRatesTime": "2026-06-09T12:21:06.936303711Z",
    "historicalFiatRatesTime": "2026-06-09T00:00:00Z",
    "historicalTokenFiatRatesTime": "2025-11-25T06:33:20.61689154Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 103223018,
    "bestBlockHash": "0xf9382b9281999d73557fb535508dc842bc4e55dee67d48ebd88c2f96ca3f6b8e",
    "difficulty": "2",
    "version": "reth/v1.10.2-95d649f/x86_64-unknown-linux-gnu"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "error": "Internal error"
}

Get a block hash by height.

GET

https://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/block-index/{height}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/block/{blockId}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/rawblock/{blockId}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/block-filters/'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/tx/{txid}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/tx-specific/{txid}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/rawtx/{txid}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/sendtx/{hex}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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

Request body.

Alternative schema variant for this parameter or payload.

string

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.

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://bsc-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"0x00"'

const response = await fetch('https://bsc-blockbook.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://bsc-blockbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

Request Body

0x00

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

https://bsc-blockbook.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

BNB Smart Chain address in 0x-prefixed hexadecimal format.

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.

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.

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://bsc-blockbook.nownodes.io/api/v2/address/{address}'

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
  "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 account balance history.

GET

https://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/contract/{contract}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/estimatefee/{blocks}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/feestats/{blockId}'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/multi-tickers/'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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://bsc-blockbook.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.

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.

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://bsc-blockbook.nownodes.io/api/v2/tickers-list/'

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

const data = await response.json();

import requests

response = requests.get('https://bsc-blockbook.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"
}

MAINNET / EVM

eth_accounts

eth_accounts operations.

Ethereum method - eth_accounts

POST

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

Returns an array of addresses controlled by the client.

Body

application/json

Returns an array of addresses controlled by the client.

Request payload for Returns an array of addresses controlled by the client..

jsonrpcstringrequired

JSON-RPC version identifier

methodstringrequired

Name of the JSON-RPC method

paramsarrayrequired

No parameters are required for this method. This must be an empty array.

idintegerrequired

Unique identifier for the JSON-RPC request

Response

200OK

A list of Ethereum addresses

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_accounts

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_accounts",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_accounts",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_accounts",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [],
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_blockNumber

eth_blockNumber operations.

Ethereum method - eth_blockNumber

POST

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

Returns the number of the latest block on the chain in hexadecimal format.

Body

application/json

Returns the number of the latest block on the chain in hexadecimal format.

Request payload for Returns the number of the latest block on the chain in hexadecimal format..

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsarrayrequired

This method does not take parameters; always send an empty array.

idintegerrequired

A unique ID for the request

Response

200OK

The latest block number

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_blockNumber

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x66440da"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x66440da",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_call

eth_call operations.

Ethereum method - eth_call

POST

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

Executes a call to a contract or address and returns the result without broadcasting a transaction.

Body

application/json

Executes a call to a contract or address and returns the result without broadcasting a transaction.

Request payload for Executes a call to a contract or address and returns the result without broadcasting a transaction..

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object | string>required

The first object specifies the call transaction object. The second (optional) parameter specifies the block context.

Show child attributes

Single entry in the params array.

One of

fromstring

Address the call is sent from (optional)

tostringrequired

Target address for the call (required)

gasstring

Gas provided for the call, as hex

gasPricestring

Gas price in wei, as hex

valuestring

Amount of ETH sent, as hex (optional)

datastring

Compiled contract method call data

(Optional) Integer block number, or the string "latest", "earliest", or "pending".

string

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Result of the call

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_call

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
        "data": "0x"
      },
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
          "data": "0x"
        },
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "data": "0x"
    },
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "data": "0x"
    },
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0000000000000000000000000000000000000000015c034a4ff71562028d9a52"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0000000000000000000000000000000000000000015c034a4ff71562028d9a52",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_chainId

eth_chainId operations.

Ethereum method - eth_chainId

POST

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

Returns the hexadecimal string of the current chain ID.

Body

application/json

Returns the hexadecimal string of the current chain ID.

Request payload for Returns the hexadecimal string of the current chain ID..

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

Name of the method to call

paramsarrayrequired

This method does not require parameters. Use an empty array.

idintegerrequired

Unique identifier for the request

Response

200OK

Chain ID 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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_chainId

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x38"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x38",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_coinbase

eth_coinbase operations.

eth_coinbase

POST

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

Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).

Body

application/json

Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).

Request payload for eth_coinbase.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_coinbaserequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by eth_coinbase.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_coinbase

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_coinbase",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_coinbase",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_coinbase",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4848489f0b2bedd788c696e2d79b6b69d7484848"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_estimateGas

eth_estimateGas operations.

Estimate Gas for Transaction

POST

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

Simulates a transaction and returns an estimate of how much gas would be used.

Body

application/json

Simulates a transaction and returns an estimate of how much gas would be used.

Request payload for Estimate Gas for Transaction.

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

The method name

paramsArray<object | string>required

The transaction call object and an optional block tag.

Show child attributes

Single entry in the params array.

One of

fromstring

Address the transaction is sent from (optional)

tostringrequired

Destination address of the call

gasstring

Gas limit provided for execution (optional)

gasPricestring

Gas price in wei (optional)

valuestring

Amount of ETH to send, in hexadecimal wei (optional)

datastring

The compiled input data for the transaction (optional)

Optional block tag (e.g., "latest", "earliest", or a block number)

string

idintegerrequired

Request identifier

Response

200OK

Estimated gas amount

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate Gas for Transaction

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
        "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
        "value": "0x0"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
          "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
          "value": "0x0"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "value": "0x0"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "value": "0x0"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5208"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5208",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_feeHistory

eth_feeHistory operations.

eth_feeHistory

POST

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

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Body

application/json

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Request payload for eth_feeHistory.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

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

Parameters:

blockCount — number of blocks in the requested range.
newestBlock — highest block number in the requested range (can be "latest").
rewardPercentiles — list of percentile values to sample priority fees from each block (optional).

Show child attributes

Single entry in the params array.

Any of

Item value.

string

Item value.

integer

Array<number>

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by eth_feeHistory.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_feeHistory

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
      "0x5",
      "latest",
      [
        10,
        50,
        90
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_feeHistory",
      "params": [
        "0x5",
        "latest",
        [
          10,
          50,
          90
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x66440e0",
    "reward": [
      [
        "0x2faf082",
        "0x68e7780"
      ]
    ],
    "baseFeePerGas": [
      "0x0",
      "0x0"
    ],
    "gasUsedRatio": [
      0.3071836
    ],
    "baseFeePerBlobGas": [
      "0x1",
      "0x1"
    ],
    "blobGasUsedRatio": [
      0
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x66440e0",
    "reward": [
      [
        "0x2faf082",
        "0x68e7780"
      ]
    ],
    "baseFeePerGas": [
      "0x0",
      "0x0"
    ],
    "gasUsedRatio": [
      0.3071836
    ],
    "baseFeePerBlobGas": [
      "0x1",
      "0x1"
    ],
    "blobGasUsedRatio": [
      0
    ]
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_gasPrice

eth_gasPrice operations.

Get Suggested Gas Price

POST

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

Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.

Body

application/json

Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.

Request payload for Get Suggested Gas Price.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsarrayrequired

This method takes an empty array.

idintegerrequired

Request identifier

Response

200OK

Suggested gas price in wei

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Suggested Gas Price

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_gasPrice",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5f5e100"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5f5e100",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBalance

eth_getBalance operations.

Get ETH Balance of an Address

POST

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

Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.

Body

application/json

Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.

Request payload for Get ETH Balance of an Address.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array with 2 parameters:

Address (20-byte hex string with '0x' prefix)
Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)

idintegerrequired

Request ID

Response

200OK

Balance (in wei) as hex string

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get ETH Balance of an Address

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
      "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBalance",
      "params": [
        "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x3c68c8d25812f70c16b"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x3c68c8d25812f70c16b",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBlockByHash

eth_getBlockByHash operations.

Get block information by block hash

POST

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

Returns information about a block specified by its hash.
The second parameter determines whether full transaction objects or only transaction hashes are returned.

Body

application/json

Returns information about a block specified by its hash.
The second parameter determines whether full transaction objects or only transaction hashes are returned.

Request payload for Get block information by block hash.

jsonrpcstringrequired

JSON-RPC protocol version (always "2.0")

methodstringrequired

The JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block hash (string)
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request identifier

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block information by block hash

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
      false
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockByHash",
      "params": [
        "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
        false
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBlockByNumber

eth_getBlockByNumber operations.

Get Block by Number

POST

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

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Request payload for Get Block by Number.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request ID

Response

200OK

Block 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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Block by Number

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": [
      "0x1b4",
      false
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockByNumber",
      "params": [
        "0x1b4",
        false
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "blobGasUsed": "0x0",
    "difficulty": "0x2",
    "excessBlobGas": "0x0",
    "extraData": "0xda8301070388656239633732376288676f312e32352e39836c696e00808e16a3f8b5831b7fffb860951a988bcfb677c15e6661151c401c4dce6c7f5ec9f847df5d711a8ed9897a9196efa4294a3802515d6397d56ea6f5e10aff353dfe3edb5b78d0bcbf2990aafc25f76009b016674d61a31ad819c5c299d925b6dbd0e4e97e7fe84fbf528f8777f84c84066440c8a04c7dc622a0cd5b69940d6961488ff82a68f1710840d2cc04df5edc8a23864e1d84066440c9a001d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b680ac73ed6761c99398d08e07bf17f672db33369308723fd17fe821e83ddedf90dd3940d79fd173cf3f...truncated",
    "gasLimit": "0x3473bc0",
    "gasUsed": "0x156614a",
    "hash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "logsBloom": "0x83b64ee4207afe75285fd6dcdd1669abbcd12486a540d0e35b13b2691d540387bd9eb70cebfbdc1aef9a0f77bd87070c8f9dffd9ec19b524f5961633d32deafee595db1e0c5af57f4fa4fb39fb5989f1fed12e3f1946a823207531c9bcdb2d6ec099f861aa5b84908d35d8a1cc973be11c439c574f0a5c656320ef7a8818b7569b5be20faf38494ae7b857329f2865e699ffc4c3cc48292d987c88d0c99456ecef1d4b9389926a771b4270d9eb9ecf61ddd9cd5e6e03efc5779d0a59b89b10d1c4a427cecd2294f83bdb9c02ac7bfe0b35a40d574c2d84f561116a3f2e55e7786b50e2b7180aeaf3cfe5cb842d71c7405672b96c792fc2fa771558eace9388...truncated",
    "milliTimestamp": "0x19f17fada22",
    "miner": "0x9bb56c2b4dbe5a06d79911c9899b6f817696acfc",
    "mixHash": "0x000000000000000000000000000000000000000000000000000000000000028a",
    "nonce": "0x0000000000000000",
    "number": "0x66440ca",
    "parentBeaconBlockRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "parentHash": "0x01d15d7e6e3fcf4dd299587945118258a1d7b50bde64ad38974157a7414736b6",
    "receiptsRoot": "0x3d643544d07b05ab843bde24a07622ea0c631a5510714cce83c5e67f69a67fad",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x15520",
    "stateRoot": "0x7a4dfeecc17ac0b5bd538c88a04e1772650b22f59cdb9c21a3abb3a163aa71d4",
    "timestamp": "0x6a43942f",
    "totalDifficulty": "0xcbf94c8",
    "transactions": [
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "gas": "0xbbb0",
        "gasPrice": "0x0",
        "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
        "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
        "nonce": "0x2389357",
        "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
        "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
        "gas": "0x2dd459",
        "gasPrice": "0x2faf080",
        "hash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000005400000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000008e7914d1c30758160e000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ead7eaa08e2c557f2000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0xfd441",
        "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
        "transactionIndex": "0x1",
        "value": "0x9081e015dc5e7",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x94",
        "r": "0x9ff04a2e4f50ab35ce031888e613977335d3ccfb6f4f661da078513102a61802",
        "s": "0x1b1d3a03e0aa3e7ffefb56c51efa15fb5985d0a2b2a33e266ffb9bfdfb6606f2"
      },
      {
        "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
        "blockNumber": "0x66440ca",
        "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
        "gas": "0x2dd458",
        "gasPrice": "0x2faf080",
        "hash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
        "input": "0xc0935e2e000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000002e00000000000000000000000004848489f0b2bedd788c696e2d79b6b69d7484848000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000018a337194db54d5d8dd0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000028988c8c582bd19f7b000000000000000000000000916f992df86795f24de6c268cfb903...truncated",
        "nonce": "0x1585e0",
        "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
        "transactionIndex": "0x2",
        "value": "0x1bf5b144647ee",
        "type": "0x0",
        "chainId": "0x38",
        "v": "0x93",
        "r": "0xb024b4c469ecb52be18e4fa6f99ea42cc16f79ded01cfc3bf8de9f1188438669",
        "s": "0x583ad484685558577d01843b3d4ecfae103c10501c1185ad430958407f0a1f40"
      }
    ],
    "transactionsRoot": "0x56ddea06d9828c2d1b9c050b24be3cdd431faadccbc21f507c5d848dc083bfb1",
    "uncles": [],
    "withdrawals": [],
    "withdrawalsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBlockReceipts

eth_getBlockReceipts operations.

Get All Transaction Receipts for a Block

POST

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

Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.

Body

application/json

Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.

Request payload for Get All Transaction Receipts for a Block.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

One parameter:

Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)

idintegerrequired

Request identifier

Response

200OK

Array of transaction receipts in the block

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get All Transaction Receipts for a Block

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockReceipts",
    "params": [
      "0x66428be"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockReceipts",
      "params": [
        "0x66428be"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "0x66428be"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "0x66428be"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x8908",
      "effectiveGasPrice": "0x0",
      "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
      "gasUsed": "0x8908",
      "logs": [],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
      "transactionHash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
      "transactionIndex": "0x0",
      "type": "0x0"
    },
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x5f900",
      "effectiveGasPrice": "0x2faf080",
      "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
      "gasUsed": "0x56ff8",
      "logs": [
        {
          "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
          ],
          "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x0",
          "removed": false
        },
        {
          "address": "0x40b8129b786d766267a7a118cf8c07e31cdb6fde",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da"
          ],
          "data": "0x00000000000000000000000000000000000000000000008e7914d1c30758160e",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x1",
          "removed": false
        },
        {
          "address": "0x916f992df86795f24de6c268cfb9031fbb1155da",
          "topics": [
            "0x19b47279256b2a23a1665c810c8d55a1758940ee09377d4f8d26497a3577dc83",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
          ],
          "data": "0x00000000000000000000000000000000000000000000008e7914d1c30758160efffffffffffffffffffffffffffffffffffffffffffffff1528155f71d3aa80e00000000000000000000000000000000000000005229db2fdde5599df6c521570000000000000000000000000000000000000000000350853f6443baa143769bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa73500000000000000000000000000000000000000000000000001341fe532c880ff0000000000000000000000000000000000000000000000000000000000000000",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x2",
          "removed": false
        }
      ],
      "logsBloom": "0x02000080000000000000000000000000000004000000000040000000000000000408000000000400000000000002000000080000000000000400000000200080441000100040000001000018000000000001000008000000000000002010000000000000000000000020000000000000000000040000000000004050000004100000820020200000008001000000008001000040000000010000000000000000020000000000001400002080000000001000000008000000000000000800000000a020020000000000000000000000002004000000000000000000000200004008100000000040000000000000000000040080000100000000000000000000...truncated",
      "status": "0x1",
      "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "type": "0x0"
    },
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x87114",
      "effectiveGasPrice": "0x2faf080",
      "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
      "gasUsed": "0x27814",
      "logs": [
        {
          "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
          ],
          "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x12",
          "removed": false
        },
        {
          "address": "0x40b8129b786d766267a7a118cf8c07e31cdb6fde",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da"
          ],
          "data": "0x0000000000000000000000000000000000000000000000fbba5cc3184d7dc2d0",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x13",
          "removed": false
        },
        {
          "address": "0x916f992df86795f24de6c268cfb9031fbb1155da",
          "topics": [
            "0x19b47279256b2a23a1665c810c8d55a1758940ee09377d4f8d26497a3577dc83",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
          ],
          "data": "0x0000000000000000000000000000000000000000000000fbba5cc3184d7dc2d0ffffffffffffffffffffffffffffffffffffffffffffffe614f21db0b6f3b877000000000000000000000000000000000000000052220961646ee800000000000000000000000000000000000000000000000000000350853f6443baa143769bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa72e000000000000000000000000000000000000000000000000022068b947b04eb90000000000000000000000000000000000000000000000000000000000000000",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x14",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000020000000000000000000004000000000800800410000000400000000000080000080000010000000000000000000000000000000000000000000000000000000000000000000400000000000040100000041000008200200000000020000000000080000000000000000000000000000000000000000000000000000020000004000010000000080000000000000008001000000000020000000000000000000000000000000000000000000000000000004000000000000040004000000000000000040000000100000000000000000000...truncated",
      "status": "0x1",
      "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "type": "0x0"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x8908",
      "effectiveGasPrice": "0x0",
      "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
      "gasUsed": "0x8908",
      "logs": [],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
      "transactionHash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
      "transactionIndex": "0x0",
      "type": "0x0"
    },
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x5f900",
      "effectiveGasPrice": "0x2faf080",
      "from": "0xf9cd6dc301d648327ee7774a0f0f973275ffbffc",
      "gasUsed": "0x56ff8",
      "logs": [
        {
          "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
          ],
          "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x0",
          "removed": false
        },
        {
          "address": "0x40b8129b786d766267a7a118cf8c07e31cdb6fde",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da"
          ],
          "data": "0x00000000000000000000000000000000000000000000008e7914d1c30758160e",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x1",
          "removed": false
        },
        {
          "address": "0x916f992df86795f24de6c268cfb9031fbb1155da",
          "topics": [
            "0x19b47279256b2a23a1665c810c8d55a1758940ee09377d4f8d26497a3577dc83",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301",
            "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
          ],
          "data": "0x00000000000000000000000000000000000000000000008e7914d1c30758160efffffffffffffffffffffffffffffffffffffffffffffff1528155f71d3aa80e00000000000000000000000000000000000000005229db2fdde5599df6c521570000000000000000000000000000000000000000000350853f6443baa143769bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa73500000000000000000000000000000000000000000000000001341fe532c880ff0000000000000000000000000000000000000000000000000000000000000000",
          "blockNumber": "0x66440ca",
          "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
          "transactionIndex": "0x1",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x2",
          "removed": false
        }
      ],
      "logsBloom": "0x02000080000000000000000000000000000004000000000040000000000000000408000000000400000000000002000000080000000000000400000000200080441000100040000001000018000000000001000008000000000000002010000000000000000000000020000000000000000000040000000000004050000004100000820020200000008001000000008001000040000000010000000000000000020000000000001400002080000000001000000008000000000000000800000000a020020000000000000000000000002004000000000000000000000200004008100000000040000000000000000000040080000100000000000000000000...truncated",
      "status": "0x1",
      "to": "0x286da9568057420df90c5489e51cbb82b29f0301",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "type": "0x0"
    },
    {
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockNumber": "0x66440ca",
      "contractAddress": null,
      "cumulativeGasUsed": "0x87114",
      "effectiveGasPrice": "0x2faf080",
      "from": "0xd1e7f9693e0f1bc36b5bc4e05586390f417beab0",
      "gasUsed": "0x27814",
      "logs": [
        {
          "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
          ],
          "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x12",
          "removed": false
        },
        {
          "address": "0x40b8129b786d766267a7a118cf8c07e31cdb6fde",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680",
            "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da"
          ],
          "data": "0x0000000000000000000000000000000000000000000000fbba5cc3184d7dc2d0",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x13",
          "removed": false
        },
        {
          "address": "0x916f992df86795f24de6c268cfb9031fbb1155da",
          "topics": [
            "0x19b47279256b2a23a1665c810c8d55a1758940ee09377d4f8d26497a3577dc83",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680",
            "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
          ],
          "data": "0x0000000000000000000000000000000000000000000000fbba5cc3184d7dc2d0ffffffffffffffffffffffffffffffffffffffffffffffe614f21db0b6f3b877000000000000000000000000000000000000000052220961646ee800000000000000000000000000000000000000000000000000000350853f6443baa143769bffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffa72e000000000000000000000000000000000000000000000000022068b947b04eb90000000000000000000000000000000000000000000000000000000000000000",
          "blockNumber": "0x66440ca",
          "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
          "transactionIndex": "0x2",
          "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
          "blockTimestamp": "0x6a43942f",
          "logIndex": "0x14",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000020000000000000000000004000000000800800410000000400000000000080000080000010000000000000000000000000000000000000000000000000000000000000000000400000000000040100000041000008200200000000020000000000080000000000000000000000000000000000000000000000000000020000004000010000000080000000000000008001000000000020000000000000000000000000000000000000000000000000000004000000000000040004000000000000000040000000100000000000000000000...truncated",
      "status": "0x1",
      "to": "0x031942f26a094be40414f442a2f1295e3a5c1680",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "type": "0x0"
    }
  ],
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByHash operations.

Get Transaction Count by Block Hash

POST

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

Returns the number of transactions contained in the block with the given hash.

Body

application/json

Returns the number of transactions contained in the block with the given hash.

Request payload for Get Transaction Count by Block Hash.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block hash as a hex string (32 bytes with 0x prefix)

idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction Count by Block Hash

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByHash",
    "params": [
      "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByHash",
      "params": [
        "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x50"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x50",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber operations.

Get Transaction Count by Block Number

POST

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

Returns the number of transactions contained in the block with the given block number.

Body

application/json

Returns the number of transactions contained in the block with the given block number.

Request payload for Get Transaction Count by Block Number.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block number as a hex string (e.g. "0x10d4f" for block 69007) or
predefined block tags such as "latest", "earliest", or "pending"

idintegerrequired

Request ID

Response

200OK

Number of transactions in the block

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction Count by Block Number

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByNumber",
    "params": [
      "0x66428be"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByNumber",
      "params": [
        "0x66428be"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x66428be"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x66428be"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x50"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x50",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getCode

eth_getCode operations.

Get Contract Bytecode at Address

POST

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

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

Body

application/json

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

Request payload for Get Contract Bytecode at Address.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with two elements:

The address to get the code for (hex string, 0x-prefixed).
The block number or block tag (e.g., "latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

Contract bytecode in hex format

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Contract Bytecode at Address

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": [
      "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getCode",
      "params": [
        "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x608060405234801561001057600080fd5b506004361061012c5760003560e01c8063893d20e8116100ad578063a9059cbb11610071578063a9059cbb1461035a578063b09f126614610386578063d28d88521461038e578063dd62ed3e14610396578063f2fde38b146103c45761012c565b8063893d20e8146102dd5780638da5cb5b1461030157806395d89b4114610309578063a0712d6814610311578063a457c2d71461032e5761012c565b806332424aa3116100f457806332424aa31461025c578063395093511461026457806342966c681461029057806370a08231146102ad578063715018a6146102d35761012c565b806306fdde0314610131...truncated"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x608060405234801561001057600080fd5b506004361061012c5760003560e01c8063893d20e8116100ad578063a9059cbb11610071578063a9059cbb1461035a578063b09f126614610386578063d28d88521461038e578063dd62ed3e14610396578063f2fde38b146103c45761012c565b8063893d20e8146102dd5780638da5cb5b1461030157806395d89b4114610309578063a0712d6814610311578063a457c2d71461032e5761012c565b806332424aa3116100f457806332424aa31461025c578063395093511461026457806342966c681461029057806370a08231146102ad578063715018a6146102d35761012c565b806306fdde0314610131...truncated",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getFilterChanges

eth_getFilterChanges operations.

Get Filter Changes

POST

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

Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.

Body

application/json

Request payload for Get Filter Changes.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with a single element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

Array of log objects or transaction hashes depending on filter type

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Filter Changes

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterChanges",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getFilterChanges",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "0x16"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [],
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getFilterLogs

eth_getFilterLogs operations.

Get Filter Logs

POST

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

Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.

Body

application/json

Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.

Request payload for Get Filter Logs.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with one element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Filter Logs

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterLogs",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getFilterLogs",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getFilterLogs",
  "params": [
    "0x16"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterLogs",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
      ],
      "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
      ],
      "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
      "blockNumber": "0x66440ca",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x12",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000e94753d6e067d25e0dbe90ed782b7ea21475fc48"
      ],
      "data": "0x00000000000000000000000000000000000000000000000e088768704d71f8e5",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x4972d4a655428629fb7bf30c8e79fcb2962e9a5edc948f42b939c0b2e7c2e038",
      "transactionIndex": "0xb",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x4a",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
      ],
      "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
      ],
      "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
      "blockNumber": "0x66440ca",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x12",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000e94753d6e067d25e0dbe90ed782b7ea21475fc48"
      ],
      "data": "0x00000000000000000000000000000000000000000000000e088768704d71f8e5",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x4972d4a655428629fb7bf30c8e79fcb2962e9a5edc948f42b939c0b2e7c2e038",
      "transactionIndex": "0xb",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x4a",
      "removed": false
    }
  ],
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getLogs

eth_getLogs operations.

Get Logs

POST

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

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Body

application/json

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Request payload for Get Logs.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Parameters array with one element: the filter object.

Show child attributes

fromBlockstring

Starting block number (hex string) or "earliest", "latest", "pending".

toBlockstring

Ending block number (hex string) or "earliest", "latest", "pending".

addressstring | Array<string>

Contract address or list of addresses from which logs should originate.

topicsarray

Array of topic filters. Each topic can be a string, null, or an array of strings for OR filtering.

idintegerrequired

Request identifier.

Response

200OK

Array of log objects matching the filter

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Logs

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x66428be",
        "toBlock": "0x66428be",
        "address": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x66428be",
          "toBlock": "0x66428be",
          "address": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x66428be",
      "toBlock": "0x66428be",
      "address": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x66428be",
      "toBlock": "0x66428be",
      "address": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
      ],
      "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
      ],
      "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
      "blockNumber": "0x66440ca",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x12",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000e94753d6e067d25e0dbe90ed782b7ea21475fc48"
      ],
      "data": "0x00000000000000000000000000000000000000000000000e088768704d71f8e5",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x4972d4a655428629fb7bf30c8e79fcb2962e9a5edc948f42b939c0b2e7c2e038",
      "transactionIndex": "0xb",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x4a",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000286da9568057420df90c5489e51cbb82b29f0301"
      ],
      "data": "0x00000000000000000000000000000000000000000000000ead7eaa08e2c557f2",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x3a43f9768661978713d4f6826e8dd9e4ad8e91071576d5e5e77d8781c5847dfd",
      "transactionIndex": "0x1",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000031942f26a094be40414f442a2f1295e3a5c1680"
      ],
      "data": "0x000000000000000000000000000000000000000000000019eb0de24f490c4789",
      "blockNumber": "0x66440ca",
      "transactionHash": "0xaffcdd2d513eef7858e21ba11cb2682588016fbc8fccf1ddc07a452b64a1f786",
      "transactionIndex": "0x2",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x12",
      "removed": false
    },
    {
      "address": "0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000916f992df86795f24de6c268cfb9031fbb1155da",
        "0x000000000000000000000000e94753d6e067d25e0dbe90ed782b7ea21475fc48"
      ],
      "data": "0x00000000000000000000000000000000000000000000000e088768704d71f8e5",
      "blockNumber": "0x66440ca",
      "transactionHash": "0x4972d4a655428629fb7bf30c8e79fcb2962e9a5edc948f42b939c0b2e7c2e038",
      "transactionIndex": "0xb",
      "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
      "blockTimestamp": "0x6a43942f",
      "logIndex": "0x4a",
      "removed": false
    }
  ],
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getStorageAt

eth_getStorageAt operations.

Get Storage At

POST

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

Returns the value stored at position in the storage of the contract at address at the given blockNumber.

Body

application/json

Returns the value stored at position in the storage of the contract at address at the given blockNumber.

Request payload for Get Storage At.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array:

address: string - Contract address to query storage from.
position: string - Storage slot position (hex string).
block number: string - Block number or keywords ("latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

Storage slot value at the specified position

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Storage At

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getStorageAt",
    "params": [
      "0x1234567890abcdef1234567890abcdef12345678",
      "0x0",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getStorageAt",
      "params": [
        "0x1234567890abcdef1234567890abcdef12345678",
        "0x0",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x000000000000000000000000f68a4b64162906eff0ff6ae34e2bb1cd42fef62d"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x000000000000000000000000f68a4b64162906eff0ff6ae34e2bb1cd42fef62d",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockHashAndIndex operations.

Get Transaction by Block Hash and Index

POST

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

Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.

Body

application/json

Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.

Request payload for Get Transaction by Block Hash and Index.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

blockHash (string): The 32-byte hash of the block.
transactionIndex (string): The transaction index (hex).

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

A transaction object or null if no transaction was found.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction by Block Hash and Index

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByBlockHashAndIndex",
    "params": [
      "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockHashAndIndex",
      "params": [
        "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xc3dbd80e2bd3e8ef8cb7b218d36ae7a8b25162cd1b9967e3fb1c45992df34169",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByBlockNumberAndIndex operations.

Get Transaction by Block Number and Index

POST

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

Returns the information about a transaction using the block number and the transaction index within the block.

Body

application/json

Returns the information about a transaction using the block number and the transaction index within the block.

Request payload for Get Transaction by Block Number and Index.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

Block number in hex format (e.g., "0x5daf3b")
Transaction index in the block (e.g., "0x0")

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

A transaction object, or null if not found.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction by Block Number and Index

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByBlockNumberAndIndex",
    "params": [
      "0x66428be",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockNumberAndIndex",
      "params": [
        "0x66428be",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "0x66428be",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getTransactionByHash

eth_getTransactionByHash operations.

Get transaction by hash

POST

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

eth_getTransactionByHash JSON-RPC method on BSC mainnet.

Body

application/json

Get transaction by hash

Request payload for Get transaction by hash.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Array containing a single transaction hash

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Transaction object or null

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction by hash

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByHash",
    "params": [
      "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByHash",
      "params": [
        "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gas": "0xbbb0",
    "gasPrice": "0x0",
    "hash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "input": "0x426c6f636b206275696c74206279205075697373616e742c203438436c75620af09f8c90204578706c6f72652074686520696e667261737472756374757265206c61796572206f6620424e4220436861696e2068747470733a2f2f7777772e34382e636c75620af09f94922046756c6c2050726976616379205250432068747470733a2f2f302e34382e636c75620ae29aa1efb88f204f6666696369616c2046617374657374205075626c6963205250432068747470733a2f2f666173742e6273632d7270632e636f6d0af09f9492204f6666696369616c204d45562d50726f74656374205250432068747470733a2f2f707269766163792e6273632d7270...truncated",
    "nonce": "0x2389357",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "chainId": "0x38",
    "v": "0x94",
    "r": "0x4bc40ccc10894a47aedd4f7af8816ccc69e3e43739ca351f7f2b88eb2c1cfdb8",
    "s": "0x1cc0c432f6dda14c84ab4d746fb5d56916f5f4b17323a2f87ce8e1bac4c86532"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getTransactionCount

eth_getTransactionCount operations.

Get transaction count (nonce) for address

POST

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

eth_getTransactionCount JSON-RPC method on BSC mainnet.

Body

application/json

Get transaction count (nonce) for address

Request payload for Get transaction count (nonce) for address.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

address: The address to check for transaction count.
block: The block parameter (e.g., "latest", "earliest", "pending").

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Hex encoded nonce (transaction count)

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction count (nonce) for address

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0x742d35cc6634c0532925a3b844bc454e4438f44e",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionCount",
      "params": [
        "0x742d35cc6634c0532925a3b844bc454e4438f44e",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x238937e"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x238937e",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getTransactionReceipt

eth_getTransactionReceipt operations.

Get transaction receipt by hash

POST

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

eth_getTransactionReceipt JSON-RPC method on BSC mainnet.

Body

application/json

Get transaction receipt by hash

Request payload for Get transaction receipt by hash.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

JSON-RPC method parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Transaction receipt if mined, otherwise null

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction receipt by hash

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": [
      "0x7570c7f6e47059bf04da80670a980b803d0b44318ba4250d5af487df75703285"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionReceipt",
      "params": [
        "0x7570c7f6e47059bf04da80670a980b803d0b44318ba4250d5af487df75703285"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x7570c7f6e47059bf04da80670a980b803d0b44318ba4250d5af487df75703285"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "contractAddress": null,
    "cumulativeGasUsed": "0x8908",
    "effectiveGasPrice": "0x0",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gasUsed": "0x8908",
    "logs": [],
    "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
    "status": "0x1",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionHash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "transactionIndex": "0x0",
    "type": "0x0"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xc732842764297f3a8ecdfa81c38dcca6d7a4c9509fe162b01268ef5f826bc35c",
    "blockNumber": "0x66440ca",
    "contractAddress": null,
    "cumulativeGasUsed": "0x8908",
    "effectiveGasPrice": "0x0",
    "from": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "gasUsed": "0x8908",
    "logs": [],
    "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
    "status": "0x1",
    "to": "0x4848489f0b2bedd788c696e2d79b6b69d7484848",
    "transactionHash": "0xe28f41a5b2243fb51f673bceae59391d61b98b1977878c978d584c80c33f6cbf",
    "transactionIndex": "0x0",
    "type": "0x0"
  },
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockHashAndIndex operations.

Get uncle block by block hash and index

POST

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

eth_getUncleByBlockHashAndIndex JSON-RPC method on BSC mainnet.

Body

application/json

Get uncle block by block hash and index

Request payload for Get uncle block by block hash and index.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

blockHash: 32-byte block hash
index: the uncle index as hex (e.g., "0x0" for the first uncle)

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Uncle block object or null

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get uncle block by block hash and index

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockHashAndIndex",
    "params": [
      "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockHashAndIndex",
      "params": [
        "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getUncleByBlockNumberAndIndex

eth_getUncleByBlockNumberAndIndex operations.

Get uncle block by block number and index

POST

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

eth_getUncleByBlockNumberAndIndex JSON-RPC method on BSC mainnet.

Body

application/json

Get uncle block by block number and index

Request payload for Get uncle block by block number and index.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

blockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".
index: The uncle index as hex (e.g., "0x0" for the first uncle).

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Uncle block object or null

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get uncle block by block number and index

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockNumberAndIndex",
    "params": [
      "0x5daf3b",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockNumberAndIndex",
      "params": [
        "0x5daf3b",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": null,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockHash operations.

Get the number of uncle blocks by block hash

POST

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

eth_getUncleCountByBlockHash JSON-RPC method on BSC mainnet.

Body

application/json

Get the number of uncle blocks by block hash

Request payload for Get the number of uncle blocks by block hash.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

An array containing the block hash.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Number of uncles in the block

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the number of uncle blocks by block hash

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockHash",
    "params": [
      "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockHash",
      "params": [
        "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockHash",
  "params": [
    "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockHash",
  "params": [
    "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_getUncleCountByBlockNumber

eth_getUncleCountByBlockNumber operations.

Get the number of uncle blocks by block number

POST

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

eth_getUncleCountByBlockNumber JSON-RPC method on BSC mainnet.

Body

application/json

Get the number of uncle blocks by block number

Request payload for Get the number of uncle blocks by block number.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

An array containing the block number as a hex string.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Number of uncle blocks in the block

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the number of uncle blocks by block number

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockNumber",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockNumber",
      "params": [
        "0x10d4f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_hashrate

eth_hashrate operations.

eth_hashrate

POST

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

Returns the current mining hashrate reported by the client.

Body

application/json

Returns the current mining hashrate reported by the client.

Request payload for eth_hashrate.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_hashraterequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by eth_hashrate.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_hashrate

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_hashrate",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_hashrate",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_hashrate",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_maxPriorityFeePerGas

eth_maxPriorityFeePerGas operations.

Get recommended maxPriorityFeePerGas value

POST

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

eth_maxPriorityFeePerGas JSON-RPC method on BSC mainnet.

Body

application/json

Get recommended maxPriorityFeePerGas value

Request payload for Get recommended maxPriorityFeePerGas value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarrayrequired

No parameters are required.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Returns the suggested maxPriorityFeePerGas value

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get recommended maxPriorityFeePerGas value

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_maxPriorityFeePerGas",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5f5e100"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5f5e100",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_mining

eth_mining operations.

eth_mining

POST

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

Checks whether the Ethereum client is actively mining.

Body

application/json

Checks whether the Ethereum client is actively mining.

Request payload for eth_mining.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_miningrequired

JSON-RPC method name.

paramsarrayrequired

This method does not accept parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by eth_mining.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_mining

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_mining",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_mining",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_mining",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_newBlockFilter

eth_newBlockFilter operations.

Create a new block filter

POST

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

eth_newBlockFilter JSON-RPC method on BSC mainnet.

Body

application/json

Create a new block filter

Request payload for Create a new block filter.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

This method does not require any parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Filter ID 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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a new block filter

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newBlockFilter",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newBlockFilter",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newBlockFilter",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x8276069c5faa84f737dbf3098fa41744"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x8276069c5faa84f737dbf3098fa41744",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_newFilter

eth_newFilter operations.

Create a new log filter

POST

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

eth_newFilter JSON-RPC method on BSC mainnet.

Body

application/json

Create a new log filter

Request payload for Create a new log filter.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Array with one object describing the filter options.

Show child attributes

fromBlockstring

Starting block number or tag ("latest", "earliest", "pending").

toBlockstring

Ending block number or tag.

addressstring | Array<string> | null

Blockchain address.

topicsArray<string | Array<string>> | null

Array of topic filters. Topics are 32-byte hashes identifying events.

Show child attributes

Single entry in the topics array.

One of

The topics field.

string

Array<string>

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Filter ID 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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a new log filter

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [
      {
        "fromBlock": "latest",
        "toBlock": "latest",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_newFilter",
      "params": [
        {
          "fromBlock": "latest",
          "toBlock": "latest",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xe657658d01aa5ccb6c043838bfa4d966"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0xe657658d01aa5ccb6c043838bfa4d966",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_newPendingTransactionFilter

eth_newPendingTransactionFilter operations.

Create a filter for pending transactions

POST

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

eth_newPendingTransactionFilter JSON-RPC method on BSC mainnet.

Body

application/json

Create a filter for pending transactions

Request payload for Create a filter for pending transactions.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<any>required

No parameters required for this method

idintegerrequired

Request identifier

Response

200OK

Filter ID 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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a filter for pending transactions

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newPendingTransactionFilter",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newPendingTransactionFilter",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newPendingTransactionFilter",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5d7ab8123a6b53de13e2093b0b99aacc"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5d7ab8123a6b53de13e2093b0b99aacc",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_sendRawTransaction

eth_sendRawTransaction operations.

Send a raw signed transaction

POST

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

eth_sendRawTransaction JSON-RPC method on BSC mainnet.

Body

application/json

Send a raw signed transaction

Request payload for Send a raw signed transaction.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

paramsArray<string>required

Array containing a single signed transaction data (hex string)

idintegerrequired

Request ID

Response

200OK

Transaction successfully sent

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Send a raw signed transaction

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": [
      "0x00"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendRawTransaction",
      "params": [
        "0x00"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0x00"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0c6a6..."
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1111111111111111111111111111111111111111111111111111111111111111"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1111111111111111111111111111111111111111111111111111111111111111",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_sendTransaction

eth_sendTransaction operations.

Send a transaction using node-managed account

POST

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

eth_sendTransaction JSON-RPC method on BSC mainnet.

Body

application/json

Send a transaction using node-managed account

Request payload for Send a transaction using node-managed account.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Transaction object

Show child attributes

fromstring

Address the transaction is sent from

tostring

Address the transaction is directed to

gasstring

Gas provided for the transaction (hex)

gasPricestring

Gas price in wei (hex)

valuestring

Value sent with the transaction in wei (hex)

datastring

(Optional) Data for contract interaction

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Transaction successfully sent

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Send a transaction using node-managed account

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
        "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
        "value": "0x0"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
          "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
          "value": "0x0"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "value": "0x0"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "gas": "0x5208",
      "gasPrice": "0x3b9aca00",
      "value": "0x16345785d8a0000",
      "data": "0x"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x2222222222222222222222222222222222222222222222222222222222222222"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x2222222222222222222222222222222222222222222222222222222222222222",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_sign

eth_sign operations.

Sign arbitrary data using eth_sign

POST

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

eth_sign JSON-RPC method on BSC mainnet.

Body

application/json

Sign arbitrary data using eth_sign

Request payload for Sign arbitrary data using eth_sign.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

[address, data]

address: The account that will sign the data
data: The data to be signed (must be a hex string)

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Returns the signature of the message

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Sign arbitrary data using eth_sign

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sign",
    "params": [
      "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "0x68656c6c6f"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sign",
      "params": [
        "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
        "0x68656c6c6f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sign",
  "params": [
    "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
    "0x68656c6c6f"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sign",
  "params": [
    "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
    "0x68656c6c6f20776f726c64"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x3333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x3333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333333",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_signTransaction

eth_signTransaction operations.

eth_signTransaction

POST

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

Signs a transaction locally with the private key of the specified account.

Body

application/json

Signs a transaction locally with the private key of the specified account.

Request payload for eth_signTransaction.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_signTransactionrequired

JSON-RPC method name.

paramsArray<object>required

Array with a single object representing the transaction to sign.

Show child attributes

fromstringrequired

The address of the account that will sign the transaction.

tostring

The destination address of the transaction.

gasstring

Gas limit for the transaction, as a hex string.

gasPricestring

Gas price in wei, as a hex string.

valuestring

Amount of wei to send, as a hex string.

datastring

Data payload of the transaction, hex encoded.

noncestring

Nonce of the transaction, as a hex string.

chainIdinteger

The chain ID to protect against replay attacks.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by eth_signTransaction.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_signTransaction

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
        "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
        "value": "0x0"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
          "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
          "value": "0x0"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "value": "0x0"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0xf8469e78c3d90b6f473ad703bf5375bebfbda7a2",
      "to": "0x1266c6be60392a8ff346e8d5eccd3e69dd9c5f20",
      "value": "0x0"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_syncing

eth_syncing operations.

Check if node is syncing

POST

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

eth_syncing JSON-RPC method on BSC mainnet.

Body

application/json

Check if node is syncing

Request payload for Check if node is syncing.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarrayrequired

Must be an empty array.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Returns sync status object or false

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Check if node is syncing

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_syncing",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

eth_uninstallFilter

eth_uninstallFilter operations.

Uninstall an existing filter

POST

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

eth_uninstallFilter JSON-RPC method on BSC mainnet.

Body

application/json

Uninstall an existing filter

Request payload for Uninstall an existing filter.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

JSON-RPC method parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Success or failure of the uninstall operation

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Uninstall an existing filter

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_uninstallFilter",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_uninstallFilter",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_uninstallFilter",
  "params": [
    "0x16"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_uninstallFilter",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

net_listening

net_listening operations.

net_listening

POST

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

Checks if the client is listening for network connections.

Body

application/json

Checks if the client is listening for network connections.

Request payload for net_listening.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_listeningrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by net_listening.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_listening

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_listening",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_listening",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_listening",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true,
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

net_peerCount

net_peerCount operations.

net_peerCount

POST

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

Returns the number of peers currently connected to the client.

Body

application/json

Returns the number of peers currently connected to the client.

Request payload for net_peerCount.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_peerCountrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by net_peerCount.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_peerCount

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_peerCount",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_peerCount",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_peerCount",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x42"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x42",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

net_version

net_version operations.

net_version

POST

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

Returns the current network ID of the Ethereum client.

Body

application/json

Returns the current network ID of the Ethereum client.

Request payload for net_version.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_versionrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by net_version.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_version

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_version",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "56"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "56",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

web3_clientVersion

web3_clientVersion operations.

web3_clientVersion

POST

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

Returns the current Ethereum client version.

Body

application/json

Returns the current Ethereum client version.

Request payload for web3_clientVersion.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringweb3_clientVersionrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by web3_clientVersion.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

web3_clientVersion

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "web3_clientVersion",
    "params": [],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Geth/v1.7.2-ce498e9d-20260325/linux-amd64/go1.25.8"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Geth/v1.7.2-ce498e9d-20260325/linux-amd64/go1.25.8",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

web3_sha3

web3_sha3 operations.

web3_sha3

POST

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

Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.

Body

application/json

Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.

Request payload for web3_sha3.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringweb3_sha3required

JSON-RPC method name.

paramsArray<string>required

Array containing a single hex-encoded data string to hash.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Response returned by web3_sha3.

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

JSON-RPC method or upstream error

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

web3_sha3

curl -X POST 'https://bsc-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "web3_sha3",
    "params": [
      "0x68656c6c6f20776f726c64"
    ],
    "id": 1
  }'

const response = await fetch('https://bsc-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "web3_sha3",
      "params": [
        "0x68656c6c6f20776f726c64"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "web3_sha3",
  "params": [
    "0x68656c6c6f20776f726c64"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "web3_sha3",
  "params": [
    "0x68656c6c6f20776f726c64"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1c8aff950685c2ed4bc3174f3472287b56d9517b9c948127319a09a7a36deac8",
  "error": {
    "code": -32005,
    "message": "service temporarily unavailable"
  }
}

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

MAINNET / EVM

eth_accounts

Body

Response

Authorization

eth_blockNumber

Body

Response

Authorization

eth_call

Body

Response

Authorization

eth_chainId

Body

Response

Authorization

eth_coinbase

Body

Response

Authorization