Blockbook API

v2.0.0-draft

Base URLs

https://eth-blockbook.nownodes.io

https://eth-archive.nownodes.ioNOWNodes Ethereum JSON-RPC endpoint.

https://eth-archive.nownodes.ioNOWNodes Ethereum archive JSON-RPC endpoint.

https://eth.nownodes.ioNOWNodes Ethereum JSON-RPC endpoint.

https://ethbook-sepolia.nownodes.io

https://eth-sepolia.nownodes.ioNOWNodes Ethereum 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

API Key: api-key in header

MAINNET / Blockbook

BlockBook

BlockBook operations.

Get Blockbook and backend status.

GET

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

default

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

Authorization

api-keyAuthapiKey in header

Get Blockbook and backend status.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Ethereum",
    "network": "ETH",
    "host": "590bffbc5ac8",
    "version": "devel",
    "gitCommit": "3e4c0da",
    "buildTime": "2026-05-07T23:17:36+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 25287726,
    "lastBlockTime": "2026-06-10T14:44:38.210052807Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-10T14:44:43.357838686Z",
    "mempoolSize": 40800,
    "decimals": 18,
    "dbSize": 664325729987,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-06-10T14:44:02.492083622Z",
    "historicalFiatRatesTime": "2026-06-10T00:00:00Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 25287726,
    "bestBlockHash": "0xf459cc1ac739ce1385962167e3d7ed27e610000b1d9f198b065d4c2408149dcd",
    "difficulty": "0",
    "version": "reth/v2.2.0-88505c7/x86_64-unknown-linux-gnu"
  }
}

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

Get status from the API index handler.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get status from the API index handler.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Ethereum",
    "network": "ETH",
    "host": "590bffbc5ac8",
    "version": "devel",
    "gitCommit": "3e4c0da",
    "buildTime": "2026-05-07T23:17:36+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 25287726,
    "lastBlockTime": "2026-06-10T14:44:38.210052807Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-10T14:44:43.357838686Z",
    "mempoolSize": 40800,
    "decimals": 18,
    "dbSize": 664325729987,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-06-10T14:44:02.492083622Z",
    "historicalFiatRatesTime": "2026-06-10T00:00:00Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 25287726,
    "bestBlockHash": "0xf459cc1ac739ce1385962167e3d7ed27e610000b1d9f198b065d4c2408149dcd",
    "difficulty": "0",
    "version": "reth/v2.2.0-88505c7/x86_64-unknown-linux-gnu"
  }
}

{
  "error": "Internal error"
}

Get a block hash by height.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a block hash by height.

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

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

Get a block by height or hash.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

pageinteger>= 1query

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

Response

200OK

Block details.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a block by height or hash.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "0xf9a4df322bd51ccaec6e0f3b70ee707314e087882d35cf3805003f3652d0d912",
  "previousBlockHash": "786a1f9f38493d32fd9f9c104d748490a070bc74a83809103bcadd93ae98288f",
  "nextBlockHash": "151615691b209de41dda4798a07e62db8429488554077552ccb1c4f8c7e9f57a",
  "height": 2648059,
  "confirmations": 47,
  "size": 951,
  "time": 1553096617,
  "version": "6422787",
  "merkleRoot": "6783f6083788c4f69b8af23bd2e4a194cf36ac34d590dfd97e510fe7aebc72c8",
  "nonce": "0",
  "bits": "1a063f3b",
  "difficulty": "2685605.260733312",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 2,
  "txs": [
    {
      "txid": "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9",
      "version": 2,
      "lockTime": 0,
      "vin": [
        {
          "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc",
          "vout": 1,
          "sequence": 4294967293,
          "n": 0,
          "addresses": [
            "bc1qmgwnfjlda4ns3g6g3yz74w6scnn9yu2ts82yyc"
          ],
          "isAddress": true,
          "isOwn": false,
          "value": "10106300",
          "hex": "",
          "asm": "",
          "coinbase": ""
        }
      ],
      "vout": [
        {
          "value": "175000",
          "n": 0,
          "spent": false,
          "spentTxId": "",
          "spentIndex": 0,
          "spentHeight": 0,
          "hex": "76a914ecc999d554eaa3efa5e871c28f58b549c36ec51788ac",
          "asm": "",
          "addresses": [
            "1Nb1ykSD7J5k4RFjJQGsrD9gxBE6jzfNa9"
          ],
          "isAddress": true,
          "isOwn": false,
          "type": ""
        }
      ],
      "blockHash": "0xf9a4df322bd51ccaec6e0f3b70ee707314e087882d35cf3805003f3652d0d912",
      "blockHeight": 2648059,
      "confirmations": 47,
      "confirmationETABlocks": 0,
      "confirmationETASeconds": 0,
      "blockTime": 1553096617,
      "size": 0,
      "vsize": 0,
      "value": "1000100000000",
      "valueIn": "0",
      "fees": "0",
      "hex": "",
      "rbf": false,
      "coinSpecificData": null,
      "chainExtraData": {
        "payloadType": "tron",
        "payload": "0x0"
      },
      "tokenTransfers": [
        {
          "standard": "ERC20",
          "from": "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775",
          "to": "0x3B685307C8611AFb2A9E83EBc8743dc20480716E",
          "contract": "0x4E15361FD6b4BB609Fa63C81A2be19d873717870",
          "name": "Fantom Token",
          "symbol": "FTM",
          "decimals": 18,
          "value": "15362368338194882707417",
          "multiTokenValues": []
        }
      ],
      "ethereumSpecific": {
        "type": 0,
        "createdContract": "",
        "status": 1,
        "error": "",
        "nonce": 505,
        "gasLimit": 550941,
        "gasUsed": 434686,
        "gasPrice": "44035608242",
        "maxPriorityFeePerGas": "44035608243",
        "maxFeePerGas": "44035608244",
        "baseFeePerGas": "2035608244",
        "l1Fee": 0,
        "l1FeeScalar": "",
        "l1GasPrice": "",
        "l1GasUsed": 0,
        "data": "0xac9650d800000000000000000000",
        "parsedData": {
          "methodId": "0xfa2b068f",
          "name": "Mint",
          "function": "mint(address, uint256, uint32, bytes32[], address)",
          "params": [
            {
              "type": "address",
              "values": [
                "0xa5fD1Da088598e88ba731B0E29AECF0BC2A31F82"
              ]
            }
          ]
        },
        "internalTransfers": []
      },
      "addressAliases": {}
    }
  ],
  "addressAliases": {}
}

{
  "error": "Block not found"
}

Get raw block hex.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

Response

200OK

Raw block data.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get raw block hex.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Block not found"
}

Get compact block filters.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get compact block filters.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid scriptType"
}

Get a normalized transaction.

GET

https://eth-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 hash to retrieve. Use a transaction hash that exists in this Blockbook network.

spendingbooleanquery

Include spending transaction metadata for UTXO outputs when available.

Response

200OK

Normalized transaction.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a normalized transaction.

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

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

const data = await response.json();

import requests

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

{
  "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc",
  "version": 2,
  "lockTime": 860729,
  "vin": [
    {
      "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc",
      "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": "0xf9a4df322bd51ccaec6e0f3b70ee707314e087882d35cf3805003f3652d0d912",
  "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"
    }
  }
}

{
  "error": "Transaction not found"
}

Get blockchain-specific transaction JSON.

GET

https://eth-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 hash to retrieve. Use a transaction hash that exists in this Blockbook network.

Response

200OK

Chain-specific transaction payload.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get blockchain-specific transaction JSON.

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

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

const data = await response.json();

import requests

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

"0x0"

{
  "error": "Transaction not found"
}

Get raw transaction hex.

GET

https://eth-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 hash to retrieve. Use a transaction hash that exists in this Blockbook network.

Response

200OK

Raw transaction hex as a JSON string.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get raw transaction hex.

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

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

const data = await response.json();

import requests

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

"02000000000101662a2fc609ddb4eb..."

{
  "error": "Transaction not found"
}

Broadcast a raw transaction using the path.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Broadcast a raw transaction using the path.

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

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

const data = await response.json();

import requests

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

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Broadcast a raw transaction using the request body.

POST

https://eth-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

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.

Alternative schema variant for this parameter or payload.

string

Response

200OK

Broadcast result.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Broadcast a raw transaction using the request body.

curl -X POST 'https://eth-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"02000000000101662a..."'

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

const data = await response.json();

import requests

payload = "02000000000101662a..."

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

Request Body

02000000000101662a...

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

https://eth-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

Ethereum 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.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get address/account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
  "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
}

{
  "error": "Address not found"
}

Get account balance history.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get account balance history.

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

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

const data = await response.json();

import requests

response = requests.get('https://eth-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
    }
  }
]

{
  "error": "Invalid descriptor"
}

Get contract metadata.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get contract metadata.

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

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

const data = await response.json();

import requests

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

{
  "error": "Contract not found"
}

Estimate a fee target.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Estimate a fee target.

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

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

const data = await response.json();

import requests

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

{
  "result": "0.00002460"
}

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

Get fee statistics for a block.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

Response

200OK

Fee statistics.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get fee statistics for a block.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Block not found"
}

Get current or historical fiat rates.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get current or historical fiat rates.

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

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

const data = await response.json();

import requests

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

{
  "error": "Invalid currency"
}

Get fiat rates for multiple timestamps.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get fiat rates for multiple timestamps.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid timestamp"
}

Get currencies available for a timestamp.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get currencies available for a timestamp.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid timestamp"
}

TESTNET / BlockBook

BlockBook

BlockBook operations.

Get Blockbook and backend status.

GET

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

default

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

Authorization

api-keyAuthapiKey in header

Get Blockbook and backend status.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Ethereum",
    "network": "ETH",
    "host": "ac68e4f1082f",
    "version": "devel",
    "gitCommit": "a3886155",
    "buildTime": "2025-03-05T16:32:57+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 11030324,
    "lastBlockTime": "2026-06-10T14:48:50.02533586Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-10T14:48:54.724766128Z",
    "mempoolSize": 62540,
    "decimals": 18,
    "dbSize": 130185534994,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-06-10T14:48:01.698602083Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "testnet 11155111",
    "blocks": 11030324,
    "bestBlockHash": "0xbebe9f22e399743f4e9b107ff98051b9349313f2b4adbd9dfda656d25aa51921",
    "difficulty": "0",
    "version": "Geth/v1.17.3-stable-117e067f/linux-amd64/go1.25.10"
  }
}

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

Get status from the API index handler.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get status from the API index handler.

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

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

const data = await response.json();

import requests

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

{
  "blockbook": {
    "coin": "Ethereum",
    "network": "ETH",
    "host": "ac68e4f1082f",
    "version": "devel",
    "gitCommit": "a3886155",
    "buildTime": "2025-03-05T16:32:57+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 11030324,
    "lastBlockTime": "2026-06-10T14:48:50.02533586Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-06-10T14:48:54.724766128Z",
    "mempoolSize": 62540,
    "decimals": 18,
    "dbSize": 130185534994,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-06-10T14:48:01.698602083Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "testnet 11155111",
    "blocks": 11030324,
    "bestBlockHash": "0xbebe9f22e399743f4e9b107ff98051b9349313f2b4adbd9dfda656d25aa51921",
    "difficulty": "0",
    "version": "Geth/v1.17.3-stable-117e067f/linux-amd64/go1.25.10"
  }
}

{
  "error": "Internal error"
}

Get a block hash by height.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a block hash by height.

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "0000000000000000000b7b8574bc6fd285825ec2dbcbeca149121fc05b0c828c"
}

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

Get a block by height or hash.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

pageinteger>= 1query

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

Response

200OK

Block details.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a block by height or hash.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "hash": "0x6532453abc08471410b10af7896c775485c5e9c1f49ee0b380f9014f9c6017a3",
  "previousBlockHash": "786a1f9f38493d32fd9f9c104d748490a070bc74a83809103bcadd93ae98288f",
  "nextBlockHash": "151615691b209de41dda4798a07e62db8429488554077552ccb1c4f8c7e9f57a",
  "height": 2648059,
  "confirmations": 47,
  "size": 951,
  "time": 1553096617,
  "version": "6422787",
  "merkleRoot": "6783f6083788c4f69b8af23bd2e4a194cf36ac34d590dfd97e510fe7aebc72c8",
  "nonce": "0",
  "bits": "1a063f3b",
  "difficulty": "2685605.260733312",
  "tx": [
    "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9"
  ],
  "txCount": 2,
  "txs": [
    {
      "txid": "2b9fc57aaa8d01975631a703b0fc3f11d70671953fc769533b8078a04d029bf9",
      "version": 2,
      "lockTime": 0,
      "vin": [
        {
          "txid": "0x7414554fb4e5c5acd1fa14643de8aab45d7217a1ecb2d25817c74e5e19fdae3b",
          "vout": 1,
          "sequence": 4294967293,
          "n": 0,
          "addresses": [
            "bc1qmgwnfjlda4ns3g6g3yz74w6scnn9yu2ts82yyc"
          ],
          "isAddress": true,
          "isOwn": false,
          "value": "10106300",
          "hex": "",
          "asm": "",
          "coinbase": ""
        }
      ],
      "vout": [
        {
          "value": "175000",
          "n": 0,
          "spent": false,
          "spentTxId": "",
          "spentIndex": 0,
          "spentHeight": 0,
          "hex": "76a914ecc999d554eaa3efa5e871c28f58b549c36ec51788ac",
          "asm": "",
          "addresses": [
            "1Nb1ykSD7J5k4RFjJQGsrD9gxBE6jzfNa9"
          ],
          "isAddress": true,
          "isOwn": false,
          "type": ""
        }
      ],
      "blockHash": "0x6532453abc08471410b10af7896c775485c5e9c1f49ee0b380f9014f9c6017a3",
      "blockHeight": 2648059,
      "confirmations": 47,
      "confirmationETABlocks": 0,
      "confirmationETASeconds": 0,
      "blockTime": 1553096617,
      "size": 0,
      "vsize": 0,
      "value": "1000100000000",
      "valueIn": "0",
      "fees": "0",
      "hex": "",
      "rbf": false,
      "coinSpecificData": null,
      "chainExtraData": {
        "payloadType": "tron",
        "payload": "0x0"
      },
      "tokenTransfers": [
        {
          "standard": "ERC20",
          "from": "0xd446089cf19C3D3Eb1743BeF3A852293Fd2C7775",
          "to": "0x3B685307C8611AFb2A9E83EBc8743dc20480716E",
          "contract": "0x4E15361FD6b4BB609Fa63C81A2be19d873717870",
          "name": "Fantom Token",
          "symbol": "FTM",
          "decimals": 18,
          "value": "15362368338194882707417",
          "multiTokenValues": []
        }
      ],
      "ethereumSpecific": {
        "type": 0,
        "createdContract": "",
        "status": 1,
        "error": "",
        "nonce": 505,
        "gasLimit": 550941,
        "gasUsed": 434686,
        "gasPrice": "44035608242",
        "maxPriorityFeePerGas": "44035608243",
        "maxFeePerGas": "44035608244",
        "baseFeePerGas": "2035608244",
        "l1Fee": 0,
        "l1FeeScalar": "",
        "l1GasPrice": "",
        "l1GasUsed": 0,
        "data": "0xac9650d800000000000000000000",
        "parsedData": {
          "methodId": "0xfa2b068f",
          "name": "Mint",
          "function": "mint(address, uint256, uint32, bytes32[], address)",
          "params": [
            {
              "type": "address",
              "values": [
                "0xa5fD1Da088598e88ba731B0E29AECF0BC2A31F82"
              ]
            }
          ]
        },
        "internalTransfers": []
      },
      "addressAliases": {}
    }
  ],
  "addressAliases": {}
}

{
  "error": "Block not found"
}

Get raw block hex.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

Response

200OK

Raw block data.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get raw block hex.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Block not found"
}

Get compact block filters.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get compact block filters.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid scriptType"
}

Get a normalized transaction.

GET

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

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

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

Parameters

txidstringrequiredpath

Transaction hash to retrieve. Use a transaction hash that exists in this Blockbook network.

spendingbooleanquery

Include spending transaction metadata for UTXO outputs when available.

Response

200OK

Normalized transaction.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get a normalized transaction.

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

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

const data = await response.json();

import requests

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

{
  "txid": "0x7414554fb4e5c5acd1fa14643de8aab45d7217a1ecb2d25817c74e5e19fdae3b",
  "version": 2,
  "lockTime": 860729,
  "vin": [
    {
      "txid": "0x7414554fb4e5c5acd1fa14643de8aab45d7217a1ecb2d25817c74e5e19fdae3b",
      "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": "0x6532453abc08471410b10af7896c775485c5e9c1f49ee0b380f9014f9c6017a3",
  "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"
    }
  }
}

{
  "error": "Transaction not found"
}

Get blockchain-specific transaction JSON.

GET

https://eth-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 hash to retrieve. Use a transaction hash that exists in this Blockbook network.

Response

200OK

Chain-specific transaction payload.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get blockchain-specific transaction JSON.

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

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

const data = await response.json();

import requests

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

"0x0"

{
  "error": "Transaction not found"
}

Get raw transaction hex.

GET

https://eth-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 hash to retrieve. Use a transaction hash that exists in this Blockbook network.

Response

200OK

Raw transaction hex as a JSON string.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get raw transaction hex.

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

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

const data = await response.json();

import requests

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

"02000000000101662a2fc609ddb4eb..."

{
  "error": "Transaction not found"
}

Broadcast a raw transaction using the path.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Broadcast a raw transaction using the path.

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

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

const data = await response.json();

import requests

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

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Broadcast a raw transaction using the request body.

POST

https://eth-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

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.

Alternative schema variant for this parameter or payload.

string

Response

200OK

Broadcast result.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Broadcast a raw transaction using the request body.

curl -X POST 'https://eth-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: text/plain' \
  -d '"02000000000101662a..."'

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

const data = await response.json();

import requests

payload = "02000000000101662a..."

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

Request Body

02000000000101662a...

{
  "result": "7c3be24063f268aaa1ed81b64776798f56088757641a34fb156c4f51ed2e9d25"
}

{
  "error": "Invalid transaction hex"
}

Get address/account details.

GET

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

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

Ethereum 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.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get address/account details.

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

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

const data = await response.json();

import requests

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

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 1000,
  "address": "0xde0b295669a9fd93d5f28d9ec85e40f4cb697bae",
  "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
}

{
  "error": "Address not found"
}

Get account balance history.

GET

https://eth-blockbook.nownodes.io/api/v2/balancehistory/{descriptor}

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

Parameters

descriptorstringrequiredpath

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

frominteger<int64>query

Unix timestamp lower bound.

tointeger<int64>query

Unix timestamp upper bound.

fiatcurrencystringquery

Optional fiat currency code to include in rates.

groupByinteger>= 1query

Aggregation interval in seconds. Defaults to 3600.

gapinteger[0, 10000]query

XPUB/address derivation gap limit.

Response

200OK

Balance history points.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get account balance history.

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

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

const data = await response.json();

import requests

response = requests.get('https://eth-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
    }
  }
]

{
  "error": "Invalid descriptor"
}

Get contract metadata.

GET

https://eth-blockbook.nownodes.io/api/v2/contract/{contract}

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

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

Parameters

contractstringrequiredpath

Smart contract address.

currencystringquery

Secondary currency code for rates.

protocolsArray<string>query

Optional protocol enrichments, comma-separated or repeated.

Response

200OK

Contract metadata.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get contract metadata.

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

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

const data = await response.json();

import requests

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

{
  "error": "Contract not found"
}

Estimate a fee target.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Estimate a fee target.

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

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

const data = await response.json();

import requests

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

{
  "result": "0.00002460"
}

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

Get fee statistics for a block.

GET

https://eth-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

blockIdinteger | stringrequiredpath

Block identifier. Pass either a block height or a block hash.

Response

200OK

Fee statistics.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get fee statistics for a block.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Block not found"
}

Get current or historical fiat rates.

GET

https://eth-blockbook.nownodes.io/api/v2/tickers

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

Parameters

currencystringquery

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

timestampinteger<int64>query

Unix timestamp for historical rates.

blockstringquery

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

tokenstringquery

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

Response

200OK

Fiat rate ticker.

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get current or historical fiat rates.

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

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

const data = await response.json();

import requests

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

{
  "error": "Invalid currency"
}

Get fiat rates for multiple timestamps.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get fiat rates for multiple timestamps.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid timestamp"
}

Get currencies available for a timestamp.

GET

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

default

Public API error.

Authorization

api-keyAuthapiKey in header

Get currencies available for a timestamp.

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid timestamp"
}

MAINNET / DEBUG

debug_getBadBlocks

debug_getBadBlocks operations.

debug_getBadBlocks

POST

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

Get bad blocks

Body

application/json

Get bad blocks

Request payload for debug_getBadBlocks.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

List of bad blocks

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

debug_getBadBlocks

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_getTrieFlushInterval

debug_getTrieFlushInterval operations.

Get trie flush interval

POST

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

Retrieves the current value of in-memory trie flush interval

Body

application/json

Retrieves the current value of in-memory trie flush interval

Request payload for Get trie flush interval.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

JSON-RPC method parameters.

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Current trie flush interval value

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Get trie flush interval

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_storageRangeAt

debug_storageRangeAt operations.

Get contract storage range

POST

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

Returns the contract storage for the specified range at a given block and transaction index

Body

application/json

Returns the contract storage for the specified range at a given block and transaction index

Request payload for Get contract storage range.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string | integer>required

JSON-RPC method parameters.

Show child attributes

Single JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

integer

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Contract storage range data

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Get contract storage range

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_storageRangeAt",
  "params": [
    "0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
    0,
    "0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_storageRangeAt",
  "params": [
    "0x76f64c40d6493cf00426be2eecdaf3f968768619bfb21ce6c57921be497ab3f7",
    0,
    "0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid string length at line 1 column 4"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_traceBlockByHash

debug_traceBlockByHash operations.

Trace block by hash

POST

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

Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer

Body

application/json

Returns the possible tracing result number by executing all transactions in the block specified by the block hash with a tracer

Request payload for Trace block by hash.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string | object>required

JSON-RPC method parameters.

Show child attributes

Single JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

object

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Block transaction traces by hash

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace block by hash

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByHash",
  "params": [
    "0x97b49e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "result": {
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gas": "0xe4e1c0",
        "gasUsed": "0x78c13",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "gas": "0xe06d9f",
            "gasUsed": "0x6b2b5",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "calls": [
              {
                "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
                "gas": "0xdcd3ee",
                "gasUsed": "0x69a32",
                "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                    "gas": "0xd9433a",
                    "gasUsed": "0x67c2d",
                    "to": "0x56767eb2e3197a1dfa030faad4a65cf38e807c81",
                    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
                    "calls": [
                      {
                        "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                        "gas": "0xd5499b",
                        "gasUsed": "0x5d20c",
                        "to": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                        "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002e000000000000000000000000000000000000000000000000000000000000060200000000000000000000000000000000000000000000000000000000000000002ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bad...truncated",
                        "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                        "calls": [
                          {
                            "from": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                            "gas": "0xd1c11c",
                            "gasUsed": "0x59cb9",
                            "to": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                            "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002c2ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bade7e6e9172f147416f3680b6ce3a7117702c7e0ca0e0bcf1cd2230c725f2b6e9bfd149c792c04dc7bb3315d5eb581de7d8c8739369aa86e8e6c014f5f41d449bc...truncated",
                            "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                            "calls": [
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce5668",
                                "gasUsed": "0x1f4",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                                "type": "STATICCALL"
                              },
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce41d7",
                                "gasUsed": "0x1f4",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                                "type": "STATICCALL"
                              },
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce3ea6",
                                "gasUsed": "0xfd0",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000202ecf8d02c3edaa9b147d5abe0809838f29ffa920dc64b03eb48283364c89339530644e72e131a029b85045b68181585d2833e84879b9709143e1f593efffffff30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x0988e5c16ad5da7741e92833e70d9b024a5770a4687c16e348bc31696ad01ff5",
                                "type": "STATICCALL"
                              }
                            ],
                            "type": "STATICCALL"
                          }
                        ],
                        "type": "STATICCALL"
                      }
                    ],
                    "value": "0x0",
                    "type": "DELEGATECALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "DELEGATECALL"
          }
        ],
        "value": "0x0",
        "type": "CALL"
      },
      "txHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd"
    },
    {
      "result": {
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gas": "0x921bd",
        "gasUsed": "0x6be09",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x82fdb",
            "gasUsed": "0x5da6",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0xd0e30db0",
            "value": "0xf43fc2c04ee0000",
            "type": "CALL"
          },
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x7badb",
            "gasUsed": "0x164ef",
            "to": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000928ca80cfc20000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "output": "0xfffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc20000",
            "calls": [
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x6f8e8",
                "gasUsed": "0x7773",
                "to": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
                "input": "0xa9059cbb0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca0000000000000000000000000000000000000000000007048b86bb9cbe4db9ad",
                "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "value": "0x0",
                "type": "CALL"
              },
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x67fec",
                "gasUsed": "0x9e6",
                "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "input": "0x70a08231000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "output": "0x0000000000000000000000000000000000000000000000009bce30d6cc1de6ea",
                "type": "STATICCALL"
              },
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x6730b",
                "gasUsed": "0x244e",
                "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                "input": "0xfa461e33fffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc200000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                    "gas": "0x64d1d",
                    "gasUsed": "0x17ae",
                    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "input": "0xa9059cbb000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c30000000000000000000000000000000000000000000000000928ca80cfc20000",
                    "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                    "value": "0x0",
                    "type": "CALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          },
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x6420a",
            "gasUsed": "0x16ed1",
            "to": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000003d0ff0b013b800000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "output": "0x00000000000000000000000000000000000000000000000003d0ff0b013b8000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffe60cf1cb",
            "calls": [
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x5a5f7",
                "gasUsed": "0xa281",
                "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "input": "0xa9059cbb0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca0000000000000000000000000000000000000000000000000000000019f30e35",
                "value": "0x0",
                "type": "CALL"
              },
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x50317",
                "gasUsed": "0x9e6",
                "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "input": "0x70a0823100000000000000000000000011b815efb8f581194ae79006d24e0d814b7697f6",
                "output": "0x00000000000000000000000000000000000000000000014e83c5c334d85bf9d1",
                "type": "STATICCALL"
              },
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x4f636",
                "gasUsed": "0x2414",
                "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                "input": "0xfa461e3300000000000000000000000000000000000000000000000003d0ff0b013b8000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffe60cf1cb0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                    "gas": "0x4d674",
                    "gasUsed": "0x17ae",
                    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "input": "0xa9059cbb00000000000000000000000011b815efb8f581194ae79006d24e0d814b7697f600000000000000000000000000000000000000000000000003d0ff0b013b8000",
                    "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                    "value": "0x0",
                    "type": "CALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          }
        ],
        "value": "0xf43fc2c04ee0000",
        "type": "CALL"
      },
      "txHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1"
    },
    {
      "result": {
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gas": "0x3d0900",
        "gasUsed": "0xae459",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x3adcd2",
            "gasUsed": "0x9e6",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "output": "0x0000000000000000000000000000000000000000000000001caee39d8b565d45",
            "type": "STATICCALL"
          },
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x3abaa4",
            "gasUsed": "0xbd1b3",
            "to": "0x111111125421ca6dc452d289314280a0f8842a65",
            "input": "0xf497df754a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
            "output": "0x00000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8bd0ecbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1",
            "calls": [
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x39bab1",
                "gasUsed": "0xbb8",
                "to": "0x0000000000000000000000000000000000000001",
                "input": "0xbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1000000000000000000000000000000000000000000000000000000000000001bd8dde6ed6a9d1fd3222270d1cfab5cb763cdb431f8a6ebe4bd5446ef8a47ff8e279a82f2f5783a7e24c0a43623059cb7907d1d6e6577a4d56839a83d6cc0605d",
                "output": "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
                "type": "STATICCALL"
              },
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x398575",
                "gasUsed": "0xb1f",
                "to": "0xc0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e",
                "input": "0xd7ff8a804a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
                "output": "0x000000000000000000000000000000000000000000000000000000000c8bd0ec",
                "type": "STATICCALL"
              },
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x391e69",
                "gasUsed": "0x81b2",
                "to": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
                "input": "0x23b872dd0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a830000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c400000000000000000000000000000000000000000000017b7883c06916600000",
                "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          },
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x2f1694",
            "gasUsed": "0x216",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "output": "0x0000000000000000000000000000000000000000000000001cd9a42e95ac1e8e",
            "type": "STATICCALL"
          }
        ],
        "value": "0x428c069b",
        "type": "CALL"
      },
      "txHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_traceBlockByNumber

debug_traceBlockByNumber operations.

Trace block by number

POST

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

Returns the tracing result by executing all transactions in the block specified by number with a tracer

Body

application/json

Returns the tracing result by executing all transactions in the block specified by number with a tracer

Request payload for Trace block by number.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string | object>required

JSON-RPC method parameters.

Show child attributes

Single JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

object

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Block transaction traces by number

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace block by number

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "0xccde12",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "0xccde12",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "result": {
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gas": "0xe4e1c0",
        "gasUsed": "0x78c13",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "gas": "0xe06d9f",
            "gasUsed": "0x6b2b5",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "calls": [
              {
                "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
                "gas": "0xdcd3ee",
                "gasUsed": "0x69a32",
                "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                    "gas": "0xd9433a",
                    "gasUsed": "0x67c2d",
                    "to": "0x56767eb2e3197a1dfa030faad4a65cf38e807c81",
                    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
                    "calls": [
                      {
                        "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                        "gas": "0xd5499b",
                        "gasUsed": "0x5d20c",
                        "to": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                        "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002e000000000000000000000000000000000000000000000000000000000000060200000000000000000000000000000000000000000000000000000000000000002ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bad...truncated",
                        "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                        "calls": [
                          {
                            "from": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                            "gas": "0xd1c11c",
                            "gasUsed": "0x59cb9",
                            "to": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                            "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002c2ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bade7e6e9172f147416f3680b6ce3a7117702c7e0ca0e0bcf1cd2230c725f2b6e9bfd149c792c04dc7bb3315d5eb581de7d8c8739369aa86e8e6c014f5f41d449bc...truncated",
                            "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                            "calls": [
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce5668",
                                "gasUsed": "0x1f4",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                                "type": "STATICCALL"
                              },
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce41d7",
                                "gasUsed": "0x1f4",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                                "type": "STATICCALL"
                              },
                              {
                                "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                                "gas": "0xce3ea6",
                                "gasUsed": "0xfd0",
                                "to": "0x0000000000000000000000000000000000000005",
                                "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000202ecf8d02c3edaa9b147d5abe0809838f29ffa920dc64b03eb48283364c89339530644e72e131a029b85045b68181585d2833e84879b9709143e1f593efffffff30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                                "output": "0x0988e5c16ad5da7741e92833e70d9b024a5770a4687c16e348bc31696ad01ff5",
                                "type": "STATICCALL"
                              }
                            ],
                            "type": "STATICCALL"
                          }
                        ],
                        "type": "STATICCALL"
                      }
                    ],
                    "value": "0x0",
                    "type": "DELEGATECALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "DELEGATECALL"
          }
        ],
        "value": "0x0",
        "type": "CALL"
      },
      "txHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd"
    },
    {
      "result": {
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gas": "0x921bd",
        "gasUsed": "0x6be09",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x82fdb",
            "gasUsed": "0x5da6",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0xd0e30db0",
            "value": "0xf43fc2c04ee0000",
            "type": "CALL"
          },
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x7badb",
            "gasUsed": "0x164ef",
            "to": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000928ca80cfc20000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "output": "0xfffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc20000",
            "calls": [
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x6f8e8",
                "gasUsed": "0x7773",
                "to": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
                "input": "0xa9059cbb0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca0000000000000000000000000000000000000000000007048b86bb9cbe4db9ad",
                "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "value": "0x0",
                "type": "CALL"
              },
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x67fec",
                "gasUsed": "0x9e6",
                "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "input": "0x70a08231000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "output": "0x0000000000000000000000000000000000000000000000009bce30d6cc1de6ea",
                "type": "STATICCALL"
              },
              {
                "from": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
                "gas": "0x6730b",
                "gasUsed": "0x244e",
                "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                "input": "0xfa461e33fffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc200000000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                    "gas": "0x64d1d",
                    "gasUsed": "0x17ae",
                    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "input": "0xa9059cbb000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c30000000000000000000000000000000000000000000000000928ca80cfc20000",
                    "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                    "value": "0x0",
                    "type": "CALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          },
          {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "gas": "0x6420a",
            "gasUsed": "0x16ed1",
            "to": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000003d0ff0b013b800000000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "output": "0x00000000000000000000000000000000000000000000000003d0ff0b013b8000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffe60cf1cb",
            "calls": [
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x5a5f7",
                "gasUsed": "0xa281",
                "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                "input": "0xa9059cbb0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca0000000000000000000000000000000000000000000000000000000019f30e35",
                "value": "0x0",
                "type": "CALL"
              },
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x50317",
                "gasUsed": "0x9e6",
                "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                "input": "0x70a0823100000000000000000000000011b815efb8f581194ae79006d24e0d814b7697f6",
                "output": "0x00000000000000000000000000000000000000000000014e83c5c334d85bf9d1",
                "type": "STATICCALL"
              },
              {
                "from": "0x11b815efb8f581194ae79006d24e0d814b7697f6",
                "gas": "0x4f636",
                "gasUsed": "0x2414",
                "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                "input": "0xfa461e3300000000000000000000000000000000000000000000000003d0ff0b013b8000ffffffffffffffffffffffffffffffffffffffffffffffffffffffffe60cf1cb0000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
                    "gas": "0x4d674",
                    "gasUsed": "0x17ae",
                    "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                    "input": "0xa9059cbb00000000000000000000000011b815efb8f581194ae79006d24e0d814b7697f600000000000000000000000000000000000000000000000003d0ff0b013b8000",
                    "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                    "value": "0x0",
                    "type": "CALL"
                  }
                ],
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          }
        ],
        "value": "0xf43fc2c04ee0000",
        "type": "CALL"
      },
      "txHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1"
    },
    {
      "result": {
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gas": "0x3d0900",
        "gasUsed": "0xae459",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x3adcd2",
            "gasUsed": "0x9e6",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "output": "0x0000000000000000000000000000000000000000000000001caee39d8b565d45",
            "type": "STATICCALL"
          },
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x3abaa4",
            "gasUsed": "0xbd1b3",
            "to": "0x111111125421ca6dc452d289314280a0f8842a65",
            "input": "0xf497df754a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
            "output": "0x00000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8bd0ecbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1",
            "calls": [
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x39bab1",
                "gasUsed": "0xbb8",
                "to": "0x0000000000000000000000000000000000000001",
                "input": "0xbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1000000000000000000000000000000000000000000000000000000000000001bd8dde6ed6a9d1fd3222270d1cfab5cb763cdb431f8a6ebe4bd5446ef8a47ff8e279a82f2f5783a7e24c0a43623059cb7907d1d6e6577a4d56839a83d6cc0605d",
                "output": "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
                "type": "STATICCALL"
              },
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x398575",
                "gasUsed": "0xb1f",
                "to": "0xc0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e",
                "input": "0xd7ff8a804a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
                "output": "0x000000000000000000000000000000000000000000000000000000000c8bd0ec",
                "type": "STATICCALL"
              },
              {
                "from": "0x111111125421ca6dc452d289314280a0f8842a65",
                "gas": "0x391e69",
                "gasUsed": "0x81b2",
                "to": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
                "input": "0x23b872dd0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a830000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c400000000000000000000000000000000000000000000017b7883c06916600000",
                "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "value": "0x0",
                "type": "CALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          },
          {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "gas": "0x2f1694",
            "gasUsed": "0x216",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "output": "0x0000000000000000000000000000000000000000000000001cd9a42e95ac1e8e",
            "type": "STATICCALL"
          }
        ],
        "value": "0x428c069b",
        "type": "CALL"
      },
      "txHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_traceCall

debug_traceCall operations.

Trace call execution

POST

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

Returns the number of possible tracing result by executing an eth call within the context of the given block execution

Body

application/json

Returns the number of possible tracing result by executing an eth call within the context of the given block execution

Request payload for Trace call execution.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object | string>required

JSON-RPC method parameters.

Show child attributes

Single JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

object

Single JSON-RPC parameter value accepted by this method.

string

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Call execution trace

400Bad Request

Bad Request

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace call execution

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "debug_traceCall",
    "params": [
      {
        "from": null,
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
      },
      "latest"
    ],
    "id": 1
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceCall",
  "params": [
    {
      "from": None,
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
    },
    "latest"
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceCall",
  "params": [
    {
      "from": null,
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "data": "0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"
    },
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gas": "0xffffffffffffffff",
    "gasUsed": "0x6e02",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "input": "0x",
    "error": "execution reverted",
    "calls": [
      {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "gas": "0xfbffffffffff941c",
        "gasUsed": "0x44",
        "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
        "input": "0x",
        "error": "execution reverted",
        "value": "0x0",
        "type": "DELEGATECALL"
      }
    ],
    "value": "0x0",
    "type": "CALL"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

debug_traceTransaction

debug_traceTransaction operations.

Trace transaction execution

POST

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

Returns all traces of a given transaction

Body

application/json

Returns all traces of a given transaction

Request payload for Trace transaction execution.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string | object>required

JSON-RPC method parameters.

Show child attributes

Single JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

object

idintegerrequired

Client-provided request identifier echoed in the response.

Response

200OK

Successful trace 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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Trace transaction execution

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_traceTransaction",
  "params": [
    "0x9e63085271890a141297039b3b711913699f1ee4db1acb667ad7ce304772036b",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gas": "0xe4e1c0",
    "gasUsed": "0x78c13",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "calls": [
      {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "gas": "0xe06d9f",
        "gasUsed": "0x6b2b5",
        "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "calls": [
          {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "gas": "0xdcd3ee",
            "gasUsed": "0x69a32",
            "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "calls": [
              {
                "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                "gas": "0xd9433a",
                "gasUsed": "0x67c2d",
                "to": "0x56767eb2e3197a1dfa030faad4a65cf38e807c81",
                "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
                "calls": [
                  {
                    "from": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
                    "gas": "0xd5499b",
                    "gasUsed": "0x5d20c",
                    "to": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                    "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002e000000000000000000000000000000000000000000000000000000000000060200000000000000000000000000000000000000000000000000000000000000002ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bad...truncated",
                    "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                    "calls": [
                      {
                        "from": "0x5e7cf1c310f9e0bf8dbfe70d5cc8021a2109d0ae",
                        "gas": "0xd1c11c",
                        "gasUsed": "0x59cb9",
                        "to": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                        "input": "0xb864f5a9000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000001000000004660b8738f590acc36439146a7adc4975edec1a17fe72f146bb162bc000000000000000000000000000000000000000000000000000000000000002c2ca66b1d3162f197e79b4b730567cea51016a2817180e4adae6bade7e6e9172f147416f3680b6ce3a7117702c7e0ca0e0bcf1cd2230c725f2b6e9bfd149c792c04dc7bb3315d5eb581de7d8c8739369aa86e8e6c014f5f41d449bc...truncated",
                        "output": "0x0000000000000000000000000000000000000000000000000000000000000001",
                        "calls": [
                          {
                            "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                            "gas": "0xce5668",
                            "gasUsed": "0x1f4",
                            "to": "0x0000000000000000000000000000000000000005",
                            "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                            "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                            "type": "STATICCALL"
                          },
                          {
                            "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                            "gas": "0xce41d7",
                            "gasUsed": "0x1f4",
                            "to": "0x0000000000000000000000000000000000000005",
                            "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000201674e08033af5a4287cfeb37b79ed7f674367566339be5658fc93555d6ab4b9e000000000000000000000000000000000000000000000000000000000100000030644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                            "output": "0x07ab806ae89defecdd3ad307f43f7744f4d5b5aa27b5da2311dc75f015d32e8e",
                            "type": "STATICCALL"
                          },
                          {
                            "from": "0x08513a4646d1bc8c348c67a3680bb19626e7f13f",
                            "gas": "0xce3ea6",
                            "gasUsed": "0xfd0",
                            "to": "0x0000000000000000000000000000000000000005",
                            "input": "0x0000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000202ecf8d02c3edaa9b147d5abe0809838f29ffa920dc64b03eb48283364c89339530644e72e131a029b85045b68181585d2833e84879b9709143e1f593efffffff30644e72e131a029b85045b68181585d2833e84879b9709143e1f593f0000001",
                            "output": "0x0988e5c16ad5da7741e92833e70d9b024a5770a4687c16e348bc31696ad01ff5",
                            "type": "STATICCALL"
                          }
                        ],
                        "type": "STATICCALL"
                      }
                    ],
                    "type": "STATICCALL"
                  }
                ],
                "value": "0x0",
                "type": "DELEGATECALL"
              }
            ],
            "value": "0x0",
            "type": "CALL"
          }
        ],
        "value": "0x0",
        "type": "DELEGATECALL"
      }
    ],
    "value": "0x0",
    "type": "CALL"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

MAINNET / ERIGON

erigon_forks

erigon_forks operations.

Get Ethereum network fork information

POST

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

The erigon_forks method returns information about Ethereum network forks.

This Erigon-specific method provides details about hard forks including:

Genesis block hash
Block numbers where height-based forks occurred
Timestamps where time-based forks occurred

This is useful for understanding the Ethereum network upgrade history and for applications that need to handle different fork behaviors.

Body

application/json

The erigon_forks method returns information about Ethereum network forks.

This Erigon-specific method provides details about hard forks including:

Genesis block hash
Block numbers where height-based forks occurred
Timestamps where time-based forks occurred

This is useful for understanding the Ethereum network upgrade history and for applications that need to handle different fork behaviors.

Request payload for Get Ethereum network fork information.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringerigon_forksrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<any>required

Empty parameters array

Response

200OK

Successful forks information response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get Ethereum network fork information

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "erigon_forks",
  "id": 5,
  "params": []
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "erigon_forks",
  "id": 5,
  "params": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

{
  "jsonrpc": "2.0",
  "id": 5,
  "error": {
    "code": -32602,
    "message": "Invalid parameters",
    "data": "Method not expecting parameters"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 5,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Method not supported"
  }
}

erigon_getHeaderByHash

erigon_getHeaderByHash operations.

Get block header by hash

POST

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

The erigon_getHeaderByHash method returns the block header for the specified block hash.

This Erigon-specific method provides detailed header information including:

Block metadata (number, hash, parent hash)
Timestamp and difficulty
Gas usage and limits
Miner/validator information
State root and transaction roots

This method is useful for blockchain analysis and verifying block information.

Body

application/json

The erigon_getHeaderByHash method returns the block header for the specified block hash.

This Erigon-specific method provides detailed header information including:

Block metadata (number, hash, parent hash)
Timestamp and difficulty
Gas usage and limits
Miner/validator information
State root and transaction roots

This method is useful for blockchain analysis and verifying block information.

Request payload for Get block header by hash.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringerigon_getHeaderByHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing block hash

Response

200OK

Successful block header response

400Bad Request

Invalid request parameters

401Unauthorized

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

404Not Found

Block not found

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block header by hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "erigon_getHeaderByHash",
  "id": 1,
  "params": [
    "0xe05c06583c7764449a6faa62ecb9860a788d887ec2aa0c7b4cdfba61889904e7"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid block hash",
    "data": "Block hash must be 32 bytes"
  }
}

Unknown API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Block not found",
    "data": "Block with specified hash does not exist"
  }
}

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Method not supported"
  }
}

erigon_getHeaderByNumber

erigon_getHeaderByNumber operations.

Get block header by number

POST

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

The erigon_getHeaderByNumber method returns the block header for the specified block number.

This Erigon-specific method provides detailed header information including:

Block metadata (number, hash, parent hash)
Timestamp and difficulty
Gas usage and limits
Miner information
State root and transaction roots

This method is useful for blockchain analysis and retrieving historical block data.

Body

application/json

The erigon_getHeaderByNumber method returns the block header for the specified block number.

This Erigon-specific method provides detailed header information including:

Block metadata (number, hash, parent hash)
Timestamp and difficulty
Gas usage and limits
Miner information
State root and transaction roots

This method is useful for blockchain analysis and retrieving historical block data.

Request payload for Get block header by number.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringerigon_getHeaderByNumberrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing block number or block tag

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Block number in hexadecimal format

string

Block tag specifying which block to retrieve

stringlatestearliestpendingsafefinalized

Response

200OK

Successful block header response

400Bad Request

Invalid request parameters

401Unauthorized

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

404Not Found

Block not found

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block header by number

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "erigon_getHeaderByNumber",
    "id": 7,
    "params": [
      "0x12d687"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "erigon_getHeaderByNumber",
  "id": 7,
  "params": [
    "0x12d687"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "erigon_getHeaderByNumber",
  "id": 7,
  "params": [
    "0x12d687"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "parentHash": "0x302492d53eaabcfc87a6a455267795739dfaaff8829b58db4206c22093334613",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0xfb74767c1ce1aada0a0e114441173b57f8c1571b",
    "stateRoot": "0x3f58591d542193842f1b69e246665f85a0081b426fd6a02cadfd2dd1ace3dbab",
    "transactionsRoot": "0x4743871848d5e277b4e45a0cd5287d1652d484d4ed0c968355e526654931babe",
    "receiptsRoot": "0xaa3d080713295cf6ed97939d4b7b21494105e9c3499b550bc87453711ec6b866",
    "logsBloom": "0xbffbf7eff5ff1ffdbddeafb7e31cd5fb3ffc2d61afb75975fc73531975fdbdfe767eddffbaceee7ddbbf7b5b7ddfcfd5eafaf1b7ff47fee6cbffb3f3bf7e9fb4dfbdba9bf6fabfbfeddfed2cb57ffbfef6fbfede13799f7fbdf2dffffcce6fbdfbf21fef7ffacd53f7fecbd777d6dfdbbb3b7ce9b79ffff67ffb95d6bf9d36fb9379ae3ff7ef4fef9dffbfee17b37e2fd6bffe37d7bf5deeedbd8ed9f5fc5fe97ff7a32dffbe667bfe78bbfd7cd89ddfb3dfefcdffdd26557ef77feabee9ede7f3f9fc463ad6cfd7eaa595fffa7f7cc5794df2ff1e3fe09ef67fbfb70bb5fed7273a7ea8f37647c78eebfcfea8eebafaff6ffdb4c7ac7decd79cc37b57bf7d...truncated",
    "difficulty": "0x0",
    "number": "0x184077b",
    "gasLimit": "0x3938700",
    "gasUsed": "0x162058d",
    "timestamp": "0x6a4399ab",
    "extraData": "0x457572656b612028657572656b616275696c6465722e78797a29",
    "mixHash": "0x72595eb2f8c6cdd802689b0c807ddab09210908a1f8a2ec750a430752b9a2809",
    "nonce": "0x0000000000000000",
    "baseFeePerGas": "0x414f705",
    "withdrawalsRoot": "0xa151dcbfa3957218d375674c55d70f57a6c610054507ff6ea97c461f3f21268f",
    "blobGasUsed": "0x0",
    "excessBlobGas": "0xa90f452",
    "parentBeaconBlockRoot": "0xc759c962467c20468e4613486c8e396f3e5aad4e57036ed2bc000e633e80f2f1",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "size": "0x21c3a"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 7,
  "error": {
    "code": -32602,
    "message": "Invalid block number",
    "data": "Block number must be hexadecimal"
  }
}

Unknown API_key

{
  "jsonrpc": "2.0",
  "id": 7,
  "error": {
    "code": -32602,
    "message": "Block not found",
    "data": "Block with specified number does not exist"
  }
}

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 7,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Method not supported"
  }
}

erigon_getLogsByHash

erigon_getLogsByHash operations.

Get transaction logs by transaction hash

POST

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

The erigon_getLogsByHash method returns all logs generated by a specific transaction.

This Erigon-specific method provides detailed log information for a transaction including:

Contract addresses that emitted logs
Log topics and data
Block information
Transaction position and log index

This method is useful for analyzing smart contract events and debugging transactions.

Body

application/json

The erigon_getLogsByHash method returns all logs generated by a specific transaction.

This Erigon-specific method provides detailed log information for a transaction including:

Contract addresses that emitted logs
Log topics and data
Block information
Transaction position and log index

This method is useful for analyzing smart contract events and debugging transactions.

Request payload for Get transaction logs by transaction hash.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringerigon_getLogsByHashrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing transaction hash

Response

200OK

Successful transaction logs response

400Bad Request

Invalid request parameters

401Unauthorized

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

404Not Found

Transaction not found or no logs

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get transaction logs by transaction hash

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "erigon_getLogsByHash",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "Method not found"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid transaction hash",
    "data": "Transaction hash must be 32 bytes"
  }
}

Unknown API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Transaction not found or no logs",
    "data": "No transaction found with the specified hash"
  }
}

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Method not supported"
  }
}

trace_block

trace_block operations.

Get traces for all transactions in a block

POST

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

The trace_block method returns all traces produced in a specific block.

This method provides detailed execution traces for every transaction in the block, including contract calls, value transfers, and reward transactions.

Body

application/json

The trace_block method returns all traces produced in a specific block.

This method provides detailed execution traces for every transaction in the block, including contract calls, value transfers, and reward transactions.

Request payload for Get traces for all transactions in a block.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_blockrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing block identifier

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Block number in hexadecimal format

string

Block tag specifying which block to trace

stringlatestearliestpendingsafefinalized

Response

200OK

Successful block traces response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get traces for all transactions in a block

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_block",
    "id": 15,
    "params": [
      "0xC5D9F"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_block",
  "id": 15,
  "params": [
    "0xC5D9F"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_block",
  "id": 15,
  "params": [
    "0xC5D9F"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "callType": "call",
        "gas": "0xe41ae0",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x6d023",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    },
    {
      "action": {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "callType": "delegatecall",
        "gas": "0xe06d9f",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x6b2b5",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [
        0
      ],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    },
    {
      "action": {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "callType": "call",
        "gas": "0xdcd3ee",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x69a32",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [
        0,
        0
      ],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 15,
  "error": {
    "code": -32602,
    "message": "Invalid block number",
    "data": "Block not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 15,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

trace_call

trace_call operations.

trace_call

POST

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

Execute a new message call immediately without creating a transaction on the blockchain. This method allows debugging of contract calls by simulating execution and returning detailed trace information. It's particularly useful for testing and debugging smart contract interactions without spending gas.

Body

application/json

Request payload for trace_call.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_callrequired

The JSON-RPC method name

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

Parameters for the trace_call method

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

fromstring

The address the transaction is sent from (20 bytes, hex encoded with 0x prefix). Optional for contract creation transactions.

tostring

The address the transaction is directed to (20 bytes, hex encoded with 0x prefix). Required for message calls, omitted for contract creation.

gasstring

The gas limit for the transaction (hex encoded). Maximum amount of gas units the call can consume.

gasPricestring

The gas price in wei (hex encoded). Amount of wei per gas unit.

valuestring

The value transferred in wei (hex encoded). Amount of ether to send with the call.

datastring

The compiled code of a contract OR hash of the invoked method signature and encoded parameters. Hex encoded data (function selector + ABI encoded arguments).

Array<string>tracevmTracestateDiff

The block number or block identifier. Can be "latest", "earliest", "pending", or a specific block number (hex encoded).

string

idintegerrequired

Request identifier used to match the response with the request.

Response

200OK

Successfully executed trace call and returned detailed trace information

400Bad Request

Bad request - invalid parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

trace_call

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_call",
    "params": [
      {
        "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
        "to": "0x06af07097c9eeb7fd685c692751d5c66db49c215",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0xde0b6b3a7640000",
        "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e0000000000000000000000000000000000000000000000000000000000000001"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_call",
      "params": [
        {
          "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
          "to": "0x06af07097c9eeb7fd685c692751d5c66db49c215",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0xde0b6b3a7640000",
          "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e0000000000000000000000000000000000000000000000000000000000000001"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_call",
  "params": [
    {
      "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
      "to": "0x06af07097c9eeb7fd685c692751d5c66db49c215",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0xde0b6b3a7640000",
      "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e0000000000000000000000000000000000000000000000000000000000000001"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_call",
  "params": [
    {
      "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
      "to": "0x06af07097c9eeb7fd685c692751d5c66db49c215",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0xde0b6b3a7640000",
      "data": "0xa9059cbb000000000000000000000000742d35cc6634c0532925a3b844bc454e4438f44e0000000000000000000000000000000000000000000000000000000000000001"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "type": "call",
        "action": {
          "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
          "callType": "call",
          "gas": "0xffffffffffffadf7",
          "input": "0x",
          "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
          "value": "0x0"
        },
        "error": "Reverted",
        "result": {
          "gasUsed": "0x1bfa",
          "output": "0x"
        },
        "subtraces": 1,
        "traceAddress": []
      },
      {
        "type": "call",
        "action": {
          "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
          "callType": "delegatecall",
          "gas": "0xfbffffffffff941c",
          "input": "0x",
          "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
          "value": "0x0"
        },
        "error": "Reverted",
        "result": {
          "gasUsed": "0x44",
          "output": "0x"
        },
        "subtraces": 0,
        "traceAddress": [
          0
        ]
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "execution reverted"
  }
}

trace_callMany

trace_callMany operations.

Execute multiple call traces

POST

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

The trace_callMany method allows executing multiple call operations in a single request and returns the full trace of each call execution. This is useful for debugging and analyzing multiple transaction calls.

Body

application/json

Request payload for Execute multiple call traces.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

Method parameters. params[0] is an array of call sets. Each call set is an array of call items. A call item is a 2-element array: [callObject, traceTypes]. params[1] is the block tag.

idintegerrequired

Client-provided request identifier.

Response

200OK

Response returned by trace_callMany.

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Execute multiple call traces

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_callMany",
    "params": [
      [
        [
          [
            {
              "from": "0x0000000000000000000000000000000000000000",
              "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
              "value": "0x0"
            }
          ],
          [
            "trace"
          ]
        ]
      ],
      "latest"
    ],
    "id": 11
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_callMany",
      "params": [
        [
          [
            [
              {
                "from": "0x0000000000000000000000000000000000000000",
                "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
                "value": "0x0"
              }
            ],
            [
              "trace"
            ]
          ]
        ],
        "latest"
      ],
      "id": 11
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_callMany",
  "params": [
    [
      [
        [
          {
            "from": "0x0000000000000000000000000000000000000000",
            "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "value": "0x0"
          }
        ],
        [
          "trace"
        ]
      ]
    ],
    "latest"
  ],
  "id": 11
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_callMany",
  "params": [
    [
      [
        [
          {
            "from": "0x0000000000000000000000000000000000000000",
            "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "value": "0x0"
          }
        ],
        [
          "trace"
        ]
      ]
    ],
    "latest"
  ],
  "id": 11
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
            "callType": "call",
            "gas": "0xffffffffffffadf7",
            "input": "0x",
            "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "value": "0x0"
          },
          "error": "Reverted",
          "result": {
            "gasUsed": "0x1bfa",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "delegatecall",
            "gas": "0xfbffffffffff941c",
            "input": "0x",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "value": "0x0"
          },
          "error": "Reverted",
          "result": {
            "gasUsed": "0x44",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        }
      ],
      "vmTrace": null
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected a sequence at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 11,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Missing required field 'from'"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 11,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "out of gas"
  }
}

Execute multiple call traces

POST

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

Body

application/json

Request payload for Execute multiple call traces.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_callManyrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

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

Array containing call configurations and block parameter

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Array<Array<object> | Array<string>>

Block parameter specifying which block to execute against

stringlatestearliestpendingsafefinalized

Response

200OK

Successful trace 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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Execute multiple call traces

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_callMany",
    "id": 11,
    "params": [
      [
        [
          {
            "from": "0x0000000000000000000000000000000000000000",
            "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
            "value": "0x0"
          }
        ],
        [
          "trace"
        ]
      ],
      "latest"
    ]
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_callMany",
      "id": 11,
      "params": [
        [
          [
            {
              "from": "0x0000000000000000000000000000000000000000",
              "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
              "value": "0x0"
            }
          ],
          [
            "trace"
          ]
        ],
        "latest"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_callMany",
  "id": 11,
  "params": [
    [
      [
        {
          "from": "0x0000000000000000000000000000000000000000",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "value": "0x0"
        }
      ],
      [
        "trace"
      ]
    ],
    "latest"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_callMany",
  "id": 11,
  "params": [
    [
      [
        {
          "from": "0x0000000000000000000000000000000000000000",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "value": "0x0"
        }
      ],
      [
        "trace"
      ]
    ],
    "latest"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
            "callType": "call",
            "gas": "0xffffffffffffadf7",
            "input": "0x",
            "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "value": "0x0"
          },
          "error": "Reverted",
          "result": {
            "gasUsed": "0x1bfa",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "delegatecall",
            "gas": "0xfbffffffffff941c",
            "input": "0x",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "value": "0x0"
          },
          "error": "Reverted",
          "result": {
            "gasUsed": "0x44",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        }
      ],
      "vmTrace": null
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected a sequence at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected a sequence at line 1 column 19"
  }
}

trace_filter

trace_filter operations.

Filter traces by criteria

POST

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

The trace_filter method returns traces matching specified filter criteria.

This method allows filtering traces by block range, fromAddress, toAddress, and other criteria. It's useful for finding specific transactions or calls across multiple blocks.

Body

application/json

The trace_filter method returns traces matching specified filter criteria.

This method allows filtering traces by block range, fromAddress, toAddress, and other criteria. It's useful for finding specific transactions or calls across multiple blocks.

Request payload for Filter traces by criteria.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_filterrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<object>required

Array containing filter object

Show child attributes

fromBlockstring

Starting block number for filtering (hex encoded)

toBlockstring

Ending block number for filtering (hex encoded)

fromAddressArray<string>

Array of sender addresses to filter by

toAddressArray<string>

Array of recipient addresses to filter by

afterinteger

Offset after which traces should be returned

countinteger

Number of traces to return

Response

200OK

Successful trace filter response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Filter traces by criteria

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_filter",
    "id": 1,
    "params": {
      "fromBlock": "0xC5D9F",
      "toBlock": "0xC5DA5",
      "fromAddress": [
        "0xacd472dde54aaed9f82cc8d4ea597100729ba82e",
        "0x63a9975ba31b0b9626b34300f7f627147df1f526"
      ],
      "toAddress": [
        "0x7de5aba7de728950c92c57d08e20d4077161f12f"
      ]
    }
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_filter",
      "id": 1,
      "params": {
        "fromBlock": "0xC5D9F",
        "toBlock": "0xC5DA5",
        "fromAddress": [
          "0xacd472dde54aaed9f82cc8d4ea597100729ba82e",
          "0x63a9975ba31b0b9626b34300f7f627147df1f526"
        ],
        "toAddress": [
          "0x7de5aba7de728950c92c57d08e20d4077161f12f"
        ]
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "id": 1,
  "params": {
    "fromBlock": "0xC5D9F",
    "toBlock": "0xC5DA5",
    "fromAddress": [
      "0xacd472dde54aaed9f82cc8d4ea597100729ba82e",
      "0x63a9975ba31b0b9626b34300f7f627147df1f526"
    ],
    "toAddress": [
      "0x7de5aba7de728950c92c57d08e20d4077161f12f"
    ]
  }
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "id": 1,
  "params": {
    "fromBlock": "0xC5D9F",
    "toBlock": "0xC5DA5",
    "fromAddress": [
      "0xacd472dde54aaed9f82cc8d4ea597100729ba82e",
      "0x63a9975ba31b0b9626b34300f7f627147df1f526"
    ],
    "toAddress": [
      "0x7de5aba7de728950c92c57d08e20d4077161f12f"
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "callType": "call",
        "gas": "0xe41ae0",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x6d023",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TraceFilter at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid filter parameters",
    "data": "Block range too large"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

trace_get

trace_get operations.

Get specific trace by transaction hash and trace address

POST

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

The trace_get method returns a specific trace from a transaction by its hash and trace address.

This method is useful for retrieving detailed information about a specific call within a transaction, especially for complex transactions with multiple internal calls.

Body

application/json

The trace_get method returns a specific trace from a transaction by its hash and trace address.

This method is useful for retrieving detailed information about a specific call within a transaction, especially for complex transactions with multiple internal calls.

Request payload for Get specific trace by transaction hash and trace address.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_getrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | Array<integer>>required

Array containing transaction hash and trace address

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Hash of the transaction containing the trace

string

Array<integer>

Response

200OK

Successful trace response

400Bad Request

Invalid request parameters

401Unauthorized

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

404Not Found

Trace not found

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get specific trace by transaction hash and trace address

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_get",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      0,
      1
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "action": {
      "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
      "callType": "call",
      "gas": "0xe41ae0",
      "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
      "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
      "value": "0x0"
    },
    "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": 25429883,
    "result": {
      "gasUsed": "0x6d023",
      "output": "0x"
    },
    "subtraces": 1,
    "traceAddress": [],
    "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "transactionPosition": 0,
    "type": "call"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid transaction hash",
    "data": "Transaction not found"
  }
}

Unknown API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Trace not found",
    "data": "No trace found for the specified address"
  }
}

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

trace_replayBlockTransactions

trace_replayBlockTransactions operations.

Replay transactions from a block

POST

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

The trace_replayBlockTransactions method replays all transactions in a block and returns the requested traces for each transaction.

This method is useful for analyzing all transactions in a specific block and understanding their execution paths and state changes.

Body

application/json

The trace_replayBlockTransactions method replays all transactions in a block and returns the requested traces for each transaction.

This method is useful for analyzing all transactions in a specific block and understanding their execution paths and state changes.

Request payload for Replay transactions from a block.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_replayBlockTransactionsrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

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

Array containing block identifier and trace types

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Block number in hexadecimal format

string

Block tag specifying which block to replay

stringlatestearliestpendingsafefinalized

Array<string>tracevmTracestateDiff

Response

200OK

Successful block transactions replay response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Replay transactions from a block

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_replayBlockTransactions",
    "id": 13,
    "params": [
      "0xC5D9F",
      [
        "trace",
        "stateDiff"
      ]
    ]
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_replayBlockTransactions",
      "id": 13,
      "params": [
        "0xC5D9F",
        [
          "trace",
          "stateDiff"
        ]
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "id": 13,
  "params": [
    "0xC5D9F",
    [
      "trace",
      "stateDiff"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "id": 13,
  "params": [
    "0xC5D9F",
    [
      "trace",
      "stateDiff"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
            "callType": "call",
            "gas": "0xe41ae0",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x6d023",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "delegatecall",
            "gas": "0xe06d9f",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x6b2b5",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
            "callType": "call",
            "gas": "0xdcd3ee",
            "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x69a32",
            "output": "0x"
          },
          "subtraces": 1,
          "traceAddress": [
            0,
            0
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd"
    },
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
            "callType": "call",
            "gas": "0x87c49",
            "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
            "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "value": "0xf43fc2c04ee0000"
          },
          "result": {
            "gasUsed": "0x74f85",
            "output": "0x"
          },
          "subtraces": 8,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "callType": "call",
            "gas": "0x82fdb",
            "input": "0xd0e30db0",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "value": "0xf43fc2c04ee0000"
          },
          "result": {
            "gasUsed": "0x5da6",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "callType": "call",
            "gas": "0x7badb",
            "input": "0x128acb080000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000928ca80cfc20000000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000800000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fc...truncated",
            "to": "0xba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x164ef",
            "output": "0xfffffffffffffffffffffffffffffffffffffffffffff8fb7479446341b246530000000000000000000000000000000000000000000000000928ca80cfc20000"
          },
          "subtraces": 4,
          "traceAddress": [
            1
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1"
    },
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "type": "call",
          "action": {
            "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
            "callType": "call",
            "gas": "0x3bd858",
            "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
            "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "value": "0x428c069b"
          },
          "result": {
            "gasUsed": "0xc2191",
            "output": "0x"
          },
          "subtraces": 4,
          "traceAddress": []
        },
        {
          "type": "call",
          "action": {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "callType": "staticcall",
            "gas": "0x3adcd2",
            "input": "0x70a082310000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4",
            "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0x9e6",
            "output": "0x0000000000000000000000000000000000000000000000001caee39d8b565d45"
          },
          "subtraces": 0,
          "traceAddress": [
            0
          ]
        },
        {
          "type": "call",
          "action": {
            "from": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
            "callType": "call",
            "gas": "0x3abaa4",
            "input": "0xf497df754a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83000000000000000000000000c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e00000000000000000000000094a8b4ee5cd64c79d0ee816f467ea73009f51aa0000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8235a04e00000000000000000000000000000008006a44737d0000000000...truncated",
            "to": "0x111111125421ca6dc452d289314280a0f8842a65",
            "value": "0x0"
          },
          "result": {
            "gasUsed": "0xbd1b3",
            "output": "0x00000000000000000000000000000000000000000000017b7883c06916600000000000000000000000000000000000000000000000000000000000000c8bd0ecbd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb1"
          },
          "subtraces": 5,
          "traceAddress": [
            1
          ]
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 13,
  "error": {
    "code": -32602,
    "message": "Invalid block number",
    "data": "Block 0x12345 not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 13,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

trace_replayTransaction

trace_replayTransaction operations.

Replay a transaction

POST

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

The trace_replayTransaction method replays a transaction and returns the execution traces.

This method is useful for debugging and analyzing specific transactions that have already been mined.

Body

application/json

The trace_replayTransaction method replays a transaction and returns the execution traces.

This method is useful for debugging and analyzing specific transactions that have already been mined.

Request payload for Replay a transaction.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_replayTransactionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | Array<string>>required

Array containing transaction hash and trace types

Show child attributes

Single JSON-RPC parameter value accepted by this method.

One of

Hash of the transaction to replay

string

Array<string>tracevmTracestateDiff

Response

200OK

Successful transaction replay response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Replay a transaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_replayTransaction",
    "id": 1,
    "params": [
      "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
      [
        "trace",
        "stateDiff",
        "vmTrace"
      ]
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayTransaction",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      "trace",
      "stateDiff",
      "vmTrace"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_replayTransaction",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a",
    [
      "trace",
      "stateDiff",
      "vmTrace"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "type": "call",
        "action": {
          "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
          "callType": "call",
          "gas": "0xe41ae0",
          "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
          "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
          "value": "0x0"
        },
        "result": {
          "gasUsed": "0x6d023",
          "output": "0x"
        },
        "subtraces": 1,
        "traceAddress": []
      },
      {
        "type": "call",
        "action": {
          "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
          "callType": "delegatecall",
          "gas": "0xe06d9f",
          "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
          "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
          "value": "0x0"
        },
        "result": {
          "gasUsed": "0x6b2b5",
          "output": "0x"
        },
        "subtraces": 1,
        "traceAddress": [
          0
        ]
      },
      {
        "type": "call",
        "action": {
          "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
          "callType": "call",
          "gas": "0xdcd3ee",
          "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
          "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
          "value": "0x0"
        },
        "result": {
          "gasUsed": "0x69a32",
          "output": "0x"
        },
        "subtraces": 1,
        "traceAddress": [
          0,
          0
        ]
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid transaction hash",
    "data": "Transaction not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

trace_transaction

trace_transaction operations.

Get all traces for a specific transaction

POST

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

The trace_transaction method returns all traces produced by a specific transaction.

This method provides the complete execution trace of a transaction, including all internal calls, delegate calls, and contract creations that occurred during the transaction execution.

Body

application/json

The trace_transaction method returns all traces produced by a specific transaction.

This method provides the complete execution trace of a transaction, including all internal calls, delegate calls, and contract creations that occurred during the transaction execution.

Request payload for Get all traces for a specific transaction.

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringtrace_transactionrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string>required

Array containing transaction hash

Response

200OK

Successful transaction traces response

400Bad Request

Invalid request parameters

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get all traces for a specific transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "trace_transaction",
  "id": 1,
  "params": [
    "0x3a02f0e98ae5f67cbb64fc22ae778a4262068ec1d60d4d458adca01e8306f81a"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "callType": "call",
        "gas": "0xe41ae0",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x6d023",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    },
    {
      "action": {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "callType": "delegatecall",
        "gas": "0xe06d9f",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0x6cb28384f21b18924fa312aa2e10d4e813e66263",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x6b2b5",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [
        0
      ],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    },
    {
      "action": {
        "from": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "callType": "call",
        "gas": "0xdcd3ee",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "to": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
        "value": "0x0"
      },
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": 25429883,
      "result": {
        "gasUsed": "0x69a32",
        "output": "0x"
      },
      "subtraces": 1,
      "traceAddress": [
        0,
        0
      ],
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionPosition": 0,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid transaction hash",
    "data": "Transaction not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "Execution error",
    "data": "Tracing not supported on this node"
  }
}

MAINNET / ERIGON / reth_trace_swagger_method_files

trace_block

trace_block operations.

Get traces for all transactions in a block

POST

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

Returns all localized transaction traces created in the specified block.

Body

application/json

Returns all localized transaction traces created in the specified block.

Request payload for trace_block.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_blockrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<BlockIdentifier>required

Parameters: block identifier.

Show child attributes

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Get traces for all transactions in a block

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_block",
  "params": [
    "0x2ed119"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "callType": "call",
        "from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
        "gas": "0x13e99",
        "input": "0x16c72721",
        "to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
        "value": "0x0"
      },
      "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
      "blockNumber": 3068185,
      "result": {
        "gasUsed": "0x183",
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
      },
      "subtraces": 0,
      "traceAddress": [
        0
      ],
      "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
      "transactionPosition": 2,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_call

trace_call operations.

Execute a call and return requested traces

POST

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

Executes the given transaction call locally and returns the requested trace outputs. The transaction object omits nonce, the trace type array can include trace, vmTrace, and stateDiff, and optional block, state override, and block override parameters can be supplied.

Body

application/json

Request payload for trace_call.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_callrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

Parameters: transaction object, trace types, optional block identifier, optional state overrides, optional block overrides.

Show child attributes

trace_call positional parameter.

One of

fromstring

Optional sender address used as the caller for the traced transaction.

tostring

Optional recipient address or contract address. Omit for contract creation calls.

gasstring

Optional gas limit encoded as a hexadecimal quantity.

gasPricestring

Optional gas price encoded as a hexadecimal quantity.

valuestring

Optional amount of wei to transfer, encoded as a hexadecimal quantity.

datastring

Optional input data for the call, encoded as hex bytes.

inputstring

Optional alias for call data, encoded as hex bytes.

Array<TraceType>tracevmTracestateDiff

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Map of account addresses to temporary account-state overrides used for the trace.

StateOverrides

numberstring

Overridden block number encoded as a hexadecimal quantity.

timestampstring

Overridden block timestamp encoded as a hexadecimal quantity.

baseFeestring

Overridden base fee per gas encoded as a hexadecimal quantity.

gasLimitstring

Overridden block gas limit encoded as a hexadecimal quantity.

coinbasestring

Overridden block coinbase address.

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Execute a call and return requested traces

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_call",
    "id": 1,
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
        "value": "0x186a0"
      },
      [
        "trace"
      ],
      "latest"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_call",
  "id": 1,
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "value": "0x186a0"
    },
    [
      "trace"
    ],
    "latest"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_call",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "value": "0x186a0"
    },
    [
      "trace"
    ],
    "latest"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "action": {
          "callType": "call",
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "gas": "0x1dcd12f8",
          "input": "0x",
          "value": "0x186a0"
        },
        "result": {
          "gasUsed": "0x0",
          "output": "0x"
        },
        "subtraces": 0,
        "traceAddress": [],
        "type": "call"
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_callMany

trace_callMany operations.

Execute multiple call traces on the same block context

POST

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

Performs multiple call traces on top of the same block. Each call is executed after the previous calls in the list, so call n observes state changes made by calls 0 through n-1.

Body

application/json

Performs multiple call traces on top of the same block. Each call is executed after the previous calls in the list, so call n observes state changes made by calls 0 through n-1.

Request payload for trace_callMany.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_callManyrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<Array<Array<any>> | string | string>required

Parameters: call trace list and optional block identifier.

Show child attributes

trace_callMany positional parameter.

One of

Array<Array<any>>

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Execute multiple call traces on the same block context

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_callMany",
    "id": 1,
    "params": [
      [
        [
          {
            "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
            "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "value": "0x186a0"
          },
          [
            "trace"
          ]
        ],
        [
          {
            "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
            "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "value": "0x186a0"
          },
          [
            "trace"
          ]
        ]
      ],
      "latest"
    ]
  }'

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_callMany",
  "id": 1,
  "params": [
    [
      [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "value": "0x186a0"
        },
        [
          "trace"
        ]
      ],
      [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "value": "0x186a0"
        },
        [
          "trace"
        ]
      ]
    ],
    "latest"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_callMany",
  "params": [
    [
      [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "value": "0x186a0"
        },
        [
          "trace"
        ]
      ],
      [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "value": "0x186a0"
        },
        [
          "trace"
        ]
      ]
    ],
    "latest"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "action": {
            "callType": "call",
            "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
            "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "gas": "0x1dcd12f8",
            "input": "0x",
            "value": "0x186a0"
          },
          "result": {
            "gasUsed": "0x0",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [],
          "type": "call"
        }
      ],
      "vmTrace": null
    },
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "action": {
            "callType": "call",
            "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
            "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "gas": "0x1dcd12f8",
            "input": "0x",
            "value": "0x186a0"
          },
          "result": {
            "gasUsed": "0x0",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [],
          "type": "call"
        }
      ],
      "vmTrace": null
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_filter

trace_filter operations.

Return traces matching an address and block filter

POST

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

Returns localized transaction traces matching the supplied filter. The filter can constrain the block range, sender addresses, recipient addresses, offset, and result count.

Body

application/json

Returns localized transaction traces matching the supplied filter. The filter can constrain the block range, sender addresses, recipient addresses, offset, and result count.

Request payload for trace_filter.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_filterrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<TraceFilter>required

Parameters: trace filter object.

Show child attributes

fromBlockstring | string

Ethereum block identifier accepted by the trace API.

toBlockstring | string

Ethereum block identifier accepted by the trace API.

fromAddressArray<string>

Return traces sent from these addresses.

toAddressArray<string>

Return traces sent to these addresses.

afterinteger

Offset trace number to start from.

countinteger

Maximum number of traces to return.

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Return traces matching an address and block filter

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_filter",
    "id": 1,
    "params": [
      {
        "fromBlock": "0x2ed0c4",
        "toBlock": "0x2ed128",
        "toAddress": [
          "0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
        ],
        "after": 1000,
        "count": 100
      }
    ]
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_filter",
      "id": 1,
      "params": [
        {
          "fromBlock": "0x2ed0c4",
          "toBlock": "0x2ed128",
          "toAddress": [
            "0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
          ],
          "after": 1000,
          "count": 100
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_filter",
  "id": 1,
  "params": [
    {
      "fromBlock": "0x2ed0c4",
      "toBlock": "0x2ed128",
      "toAddress": [
        "0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
      ],
      "after": 1000,
      "count": 100
    }
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_filter",
  "params": [
    {
      "fromBlock": "0x2ed0c4",
      "toBlock": "0x2ed128",
      "toAddress": [
        "0x8bbB73BCB5d553B5A556358d27625323Fd781D37"
      ],
      "after": 1000,
      "count": 100
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "callType": "call",
        "from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
        "gas": "0x13e99",
        "input": "0x16c72721",
        "to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
        "value": "0x0"
      },
      "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
      "blockNumber": 3068185,
      "result": {
        "gasUsed": "0x183",
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
      },
      "subtraces": 0,
      "traceAddress": [
        0
      ],
      "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
      "transactionPosition": 2,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_get

trace_get operations.

Return a trace at a specific position in a transaction

POST

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

Returns a single localized transaction trace from a transaction hash and trace address index path.

Body

application/json

Returns a single localized transaction trace from a transaction hash and trace address index path.

Request payload for trace_get.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_getrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string | Array<string>>required

Parameters: transaction hash and trace address indices.

Show child attributes

trace_get positional parameter.

One of

Transaction hash containing the requested trace.

string

Array<string>

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Return a trace at a specific position in a transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_get",
  "params": [
    "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
    [
      "0x0"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "action": {
      "callType": "call",
      "from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
      "gas": "0x13e99",
      "input": "0x16c72721",
      "to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
      "value": "0x0"
    },
    "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
    "blockNumber": 3068185,
    "result": {
      "gasUsed": "0x183",
      "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
    },
    "subtraces": 0,
    "traceAddress": [
      0
    ],
    "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
    "transactionPosition": 2,
    "type": "call"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_replayBlockTransactions

trace_replayBlockTransactions operations.

Replay all transactions in a block and return requested traces

POST

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

Replays every transaction in the selected block and returns the requested trace outputs for each transaction.

Body

application/json

Replays every transaction in the selected block and returns the requested trace outputs for each transaction.

Request payload for trace_replayBlockTransactions.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_replayBlockTransactionsrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string | string | Array<TraceType>>required

Parameters: block identifier and trace types.

Show child attributes

trace_replayBlockTransactions positional parameter.

One of

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Array<TraceType>tracevmTracestateDiff

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Replay all transactions in a block and return requested traces

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayBlockTransactions",
  "id": 1,
  "params": [
    "0x2ed119",
    [
      "trace"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_replayBlockTransactions",
  "params": [
    "0x2ed119",
    [
      "trace"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "output": "0x",
      "stateDiff": null,
      "trace": [
        {
          "action": {
            "callType": "call",
            "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
            "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
            "gas": "0x1dcd12f8",
            "input": "0x",
            "value": "0x186a0"
          },
          "result": {
            "gasUsed": "0x0",
            "output": "0x"
          },
          "subtraces": 0,
          "traceAddress": [],
          "type": "call"
        }
      ],
      "vmTrace": null,
      "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_replayTransaction

trace_replayTransaction operations.

Replay one transaction and return requested traces

POST

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

Replays a historical transaction by transaction hash and returns the requested trace outputs.

Body

application/json

Replays a historical transaction by transaction hash and returns the requested trace outputs.

Request payload for trace_replayTransaction.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_replayTransactionrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string | Array<TraceType>>required

Parameters: transaction hash and trace types.

Show child attributes

trace_replayTransaction positional parameter.

One of

Transaction hash to replay.

string

Array<TraceType>tracevmTracestateDiff

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Replay one transaction and return requested traces

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_replayTransaction",
  "id": 1,
  "params": [
    "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
    [
      "trace"
    ]
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_replayTransaction",
  "params": [
    "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
    [
      "trace"
    ]
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "action": {
          "callType": "call",
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "gas": "0x1dcd12f8",
          "input": "0x",
          "value": "0x186a0"
        },
        "result": {
          "gasUsed": "0x0",
          "output": "0x"
        },
        "subtraces": 0,
        "traceAddress": [],
        "type": "call"
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_transaction

trace_transaction operations.

Return all traces of one transaction

POST

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

Returns all localized transaction traces produced by the transaction identified by the supplied hash.

Body

application/json

Returns all localized transaction traces produced by the transaction identified by the supplied hash.

Request payload for trace_transaction.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_transactionrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string>required

Parameters: transaction hash.

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Return all traces of one transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_transaction",
  "params": [
    "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "action": {
        "callType": "call",
        "from": "0x1c39ba39e4735cb65978d4db400ddd70a72dc750",
        "gas": "0x13e99",
        "input": "0x16c72721",
        "to": "0x2bd2326c993dfaef84f696526064ff22eba5b362",
        "value": "0x0"
      },
      "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
      "blockNumber": 3068185,
      "result": {
        "gasUsed": "0x183",
        "output": "0x0000000000000000000000000000000000000000000000000000000000000001"
      },
      "subtraces": 0,
      "traceAddress": [
        0
      ],
      "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
      "transactionPosition": 2,
      "type": "call"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_blockOpcodeGas

Return opcode gas usage for every transaction in a block

POST

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

Returns EVM opcode gas usage aggregated per opcode for each transaction in the selected block.

Body

application/json

Returns EVM opcode gas usage aggregated per opcode for each transaction in the selected block.

Request payload for trace_blockOpcodeGas.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_blockOpcodeGasrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<BlockIdentifier>required

Parameters: block identifier.

Show child attributes

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Return opcode gas usage for every transaction in a block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add",
    "blockNumber": 3068185,
    "transactions": [
      {
        "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
        "opcodeGas": [
          {
            "opcode": "PUSH1",
            "count": 10,
            "gasUsed": 30
          },
          {
            "opcode": "CALL",
            "count": 1,
            "gasUsed": 700
          }
        ]
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_rawTransaction

Trace a raw transaction without broadcasting it

POST

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

Traces a raw signed transaction as if eth_sendRawTransaction were called, but does not submit the transaction to the network.

Body

application/json

Traces a raw signed transaction as if eth_sendRawTransaction were called, but does not submit the transaction to the network.

Request payload for trace_rawTransaction.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_rawTransactionrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string | Array<TraceType> | string | string>required

Parameters: raw transaction, trace types, optional block identifier.

Show child attributes

trace_rawTransaction positional parameter.

One of

Raw signed transaction encoded as hex bytes.

string

Array<TraceType>tracevmTracestateDiff

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Trace a raw transaction without broadcasting it

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_rawTransaction",
  "id": 1,
  "params": [
    "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
    [
      "trace"
    ],
    "latest"
  ]
}

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_rawTransaction",
  "params": [
    "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
    [
      "trace"
    ],
    "latest"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "action": {
          "callType": "call",
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "gas": "0x1dcd12f8",
          "input": "0x",
          "value": "0x186a0"
        },
        "result": {
          "gasUsed": "0x0",
          "output": "0x"
        },
        "subtraces": 0,
        "traceAddress": [],
        "type": "call"
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

trace_transactionOpcodeGas

Return opcode gas usage for one transaction

POST

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

Returns EVM opcode gas usage aggregated per opcode for a single transaction. The order of opcode entries is not significant.

Body

application/json

Returns EVM opcode gas usage aggregated per opcode for a single transaction. The order of opcode entries is not significant.

Request payload for trace_transactionOpcodeGas.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_transactionOpcodeGasrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

paramsArray<string>required

Parameters: transaction hash.

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Return opcode gas usage for one transaction

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_transactionOpcodeGas",
  "params": [
    "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transactionHash": "0x17104ac9d3312d8c136b7f44d4b8b47852618065ebfa534bd2d3b5ef218ca1f3",
    "opcodeGas": [
      {
        "opcode": "PUSH1",
        "count": 10,
        "gasUsed": 30
      },
      {
        "opcode": "CALL",
        "count": 1,
        "gasUsed": 700
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

MAINNET / EVM-ERIGON

eth_accounts

eth_accounts operations.

Ethereum method - eth_accounts

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_accounts

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

const response = await fetch('https://eth-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://eth-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 params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_blockNumber

eth_blockNumber operations.

Ethereum method - eth_blockNumber

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_blockNumber

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

const response = await fetch('https://eth-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://eth-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": "0x184077e"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_call

eth_call operations.

Ethereum method - eth_call

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_call

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

eth_chainId

eth_chainId operations.

Ethereum method - eth_chainId

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_chainId

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

const response = await fetch('https://eth-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://eth-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": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_coinbase

eth_coinbase operations.

eth_coinbase

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_coinbase

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "unimplemented"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "unimplemented"
  }
}

eth_estimateGas

eth_estimateGas operations.

Estimate Gas for Transaction

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Estimate Gas for Transaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

eth_feeHistory

eth_feeHistory operations.

eth_feeHistory

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_feeHistory

curl -X POST 'https://eth-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://eth-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://eth-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": {
    "baseFeePerGas": [
      "0x3f75cd7",
      "0x3fce294",
      "0x3f4dbd7"
    ],
    "gasUsedRatio": [
      0.52175545,
      0.4685514666666667,
      0.2561402
    ],
    "baseFeePerBlobGas": [
      "0x3b33de",
      "0x3b33de",
      "0x3cc5cb"
    ],
    "blobGasUsedRatio": [
      0,
      0.3333333333333333,
      0
    ],
    "oldestBlock": "0x184077c",
    "reward": [
      [
        "0x1e61c",
        "0x1dcd6500"
      ],
      [
        "0x525523",
        "0xef1f877"
      ],
      [
        "0x1fc56b2",
        "0x13b8e5d3"
      ]
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a 8 byte hex string at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a 8 byte hex string at line 1 column 19"
  }
}

eth_gasPrice

eth_gasPrice operations.

Get Suggested Gas Price

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Suggested Gas Price

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

const response = await fetch('https://eth-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://eth-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": "0x3b888b6"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_getBalance

eth_getBalance operations.

Get ETH Balance of an Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x4f090b18c4891915"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getBlockByHash

eth_getBlockByHash operations.

Get Block by Hash

POST

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

Returns the block information for the specified block hash. 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 hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Request payload for Get Block by Hash.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Hash

curl -X POST 'https://eth-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://eth-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://eth-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": {
    "hash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "parentHash": "0x302492d53eaabcfc87a6a455267795739dfaaff8829b58db4206c22093334613",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0xfb74767c1ce1aada0a0e114441173b57f8c1571b",
    "stateRoot": "0x3f58591d542193842f1b69e246665f85a0081b426fd6a02cadfd2dd1ace3dbab",
    "transactionsRoot": "0x4743871848d5e277b4e45a0cd5287d1652d484d4ed0c968355e526654931babe",
    "receiptsRoot": "0xaa3d080713295cf6ed97939d4b7b21494105e9c3499b550bc87453711ec6b866",
    "logsBloom": "0xbffbf7eff5ff1ffdbddeafb7e31cd5fb3ffc2d61afb75975fc73531975fdbdfe767eddffbaceee7ddbbf7b5b7ddfcfd5eafaf1b7ff47fee6cbffb3f3bf7e9fb4dfbdba9bf6fabfbfeddfed2cb57ffbfef6fbfede13799f7fbdf2dffffcce6fbdfbf21fef7ffacd53f7fecbd777d6dfdbbb3b7ce9b79ffff67ffb95d6bf9d36fb9379ae3ff7ef4fef9dffbfee17b37e2fd6bffe37d7bf5deeedbd8ed9f5fc5fe97ff7a32dffbe667bfe78bbfd7cd89ddfb3dfefcdffdd26557ef77feabee9ede7f3f9fc463ad6cfd7eaa595fffa7f7cc5794df2ff1e3fe09ef67fbfb70bb5fed7273a7ea8f37647c78eebfcfea8eebafaff6ffdb4c7ac7decd79cc37b57bf7d...truncated",
    "difficulty": "0x0",
    "number": "0x184077b",
    "gasLimit": "0x3938700",
    "gasUsed": "0x162058d",
    "timestamp": "0x6a4399ab",
    "extraData": "0x457572656b612028657572656b616275696c6465722e78797a29",
    "mixHash": "0x72595eb2f8c6cdd802689b0c807ddab09210908a1f8a2ec750a430752b9a2809",
    "nonce": "0x0000000000000000",
    "baseFeePerGas": "0x414f705",
    "withdrawalsRoot": "0xa151dcbfa3957218d375674c55d70f57a6c610054507ff6ea97c461f3f21268f",
    "blobGasUsed": "0x0",
    "excessBlobGas": "0xa90f452",
    "parentBeaconBlockRoot": "0xc759c962467c20468e4613486c8e396f3e5aad4e57036ed2bc000e633e80f2f1",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "size": "0x21c3a",
    "uncles": [],
    "transactions": [
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x1023",
        "gas": "0xe4e1c0",
        "maxFeePerGas": "0x2540be400",
        "maxPriorityFeePerGas": "0x2540be400",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "value": "0x0",
        "accessList": [],
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
        "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
        "yParity": "0x1",
        "v": "0x1",
        "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x0",
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gasPrice": "0x2540be400",
        "blockTimestamp": "0x6a4399ab"
      },
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x425",
        "gas": "0x921bd",
        "maxFeePerGas": "0x1e3871f7",
        "maxPriorityFeePerGas": "0x1a0b0394",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "value": "0xf43fc2c04ee0000",
        "accessList": [],
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "r": "0x7aead194f13cba03a6383e92d4fce25db742b57b4f28c1417d811defe7b27359",
        "s": "0x1afb2f537d0d62d463e31fefe0c8575f9a376b7e4a8ca50694604ec2e93de77",
        "yParity": "0x0",
        "v": "0x0",
        "hash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x1",
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gasPrice": "0x1e1ffa99",
        "blockTimestamp": "0x6a4399ab"
      },
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x3342",
        "gas": "0x3d0900",
        "maxFeePerGas": "0x5302c65",
        "maxPriorityFeePerGas": "0x989680",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "value": "0x428c069b",
        "accessList": [],
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "r": "0xdf437116eb31983d0f4c7fa4eaf438cf02235e72289fed903901715e5c109e29",
        "s": "0x26adc1ab18d4308d5a6a83f9893a6b4befcff6f71b67369e7654adf61331d6fe",
        "yParity": "0x0",
        "v": "0x0",
        "hash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x2",
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gasPrice": "0x4ad8d85",
        "blockTimestamp": "0x6a4399ab"
      }
    ],
    "withdrawals": [
      {
        "index": "0x8018a9b",
        "validatorIndex": "0xbee76",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde9c77"
      },
      {
        "index": "0x8018a9c",
        "validatorIndex": "0xbee77",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xdebe81"
      },
      {
        "index": "0x8018a9d",
        "validatorIndex": "0xbee78",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde6be6"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getBlockByNumber

eth_getBlockByNumber operations.

Get Block by Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Number

curl -X POST 'https://eth-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://eth-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://eth-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": {
    "hash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "parentHash": "0x302492d53eaabcfc87a6a455267795739dfaaff8829b58db4206c22093334613",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "miner": "0xfb74767c1ce1aada0a0e114441173b57f8c1571b",
    "stateRoot": "0x3f58591d542193842f1b69e246665f85a0081b426fd6a02cadfd2dd1ace3dbab",
    "transactionsRoot": "0x4743871848d5e277b4e45a0cd5287d1652d484d4ed0c968355e526654931babe",
    "receiptsRoot": "0xaa3d080713295cf6ed97939d4b7b21494105e9c3499b550bc87453711ec6b866",
    "logsBloom": "0xbffbf7eff5ff1ffdbddeafb7e31cd5fb3ffc2d61afb75975fc73531975fdbdfe767eddffbaceee7ddbbf7b5b7ddfcfd5eafaf1b7ff47fee6cbffb3f3bf7e9fb4dfbdba9bf6fabfbfeddfed2cb57ffbfef6fbfede13799f7fbdf2dffffcce6fbdfbf21fef7ffacd53f7fecbd777d6dfdbbb3b7ce9b79ffff67ffb95d6bf9d36fb9379ae3ff7ef4fef9dffbfee17b37e2fd6bffe37d7bf5deeedbd8ed9f5fc5fe97ff7a32dffbe667bfe78bbfd7cd89ddfb3dfefcdffdd26557ef77feabee9ede7f3f9fc463ad6cfd7eaa595fffa7f7cc5794df2ff1e3fe09ef67fbfb70bb5fed7273a7ea8f37647c78eebfcfea8eebafaff6ffdb4c7ac7decd79cc37b57bf7d...truncated",
    "difficulty": "0x0",
    "number": "0x184077b",
    "gasLimit": "0x3938700",
    "gasUsed": "0x162058d",
    "timestamp": "0x6a4399ab",
    "extraData": "0x457572656b612028657572656b616275696c6465722e78797a29",
    "mixHash": "0x72595eb2f8c6cdd802689b0c807ddab09210908a1f8a2ec750a430752b9a2809",
    "nonce": "0x0000000000000000",
    "baseFeePerGas": "0x414f705",
    "withdrawalsRoot": "0xa151dcbfa3957218d375674c55d70f57a6c610054507ff6ea97c461f3f21268f",
    "blobGasUsed": "0x0",
    "excessBlobGas": "0xa90f452",
    "parentBeaconBlockRoot": "0xc759c962467c20468e4613486c8e396f3e5aad4e57036ed2bc000e633e80f2f1",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "size": "0x21c3a",
    "uncles": [],
    "transactions": [
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x1023",
        "gas": "0xe4e1c0",
        "maxFeePerGas": "0x2540be400",
        "maxPriorityFeePerGas": "0x2540be400",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "value": "0x0",
        "accessList": [],
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
        "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
        "yParity": "0x1",
        "v": "0x1",
        "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x0",
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gasPrice": "0x2540be400",
        "blockTimestamp": "0x6a4399ab"
      },
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x425",
        "gas": "0x921bd",
        "maxFeePerGas": "0x1e3871f7",
        "maxPriorityFeePerGas": "0x1a0b0394",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "value": "0xf43fc2c04ee0000",
        "accessList": [],
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "r": "0x7aead194f13cba03a6383e92d4fce25db742b57b4f28c1417d811defe7b27359",
        "s": "0x1afb2f537d0d62d463e31fefe0c8575f9a376b7e4a8ca50694604ec2e93de77",
        "yParity": "0x0",
        "v": "0x0",
        "hash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x1",
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gasPrice": "0x1e1ffa99",
        "blockTimestamp": "0x6a4399ab"
      },
      {
        "type": "0x2",
        "chainId": "0x1",
        "nonce": "0x3342",
        "gas": "0x3d0900",
        "maxFeePerGas": "0x5302c65",
        "maxPriorityFeePerGas": "0x989680",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "value": "0x428c069b",
        "accessList": [],
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "r": "0xdf437116eb31983d0f4c7fa4eaf438cf02235e72289fed903901715e5c109e29",
        "s": "0x26adc1ab18d4308d5a6a83f9893a6b4befcff6f71b67369e7654adf61331d6fe",
        "yParity": "0x0",
        "v": "0x0",
        "hash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "transactionIndex": "0x2",
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gasPrice": "0x4ad8d85",
        "blockTimestamp": "0x6a4399ab"
      }
    ],
    "withdrawals": [
      {
        "index": "0x8018a9b",
        "validatorIndex": "0xbee76",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde9c77"
      },
      {
        "index": "0x8018a9c",
        "validatorIndex": "0xbee77",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xdebe81"
      },
      {
        "index": "0x8018a9d",
        "validatorIndex": "0xbee78",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde6be6"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

eth_getBlockReceipts

eth_getBlockReceipts operations.

Get All Transaction Receipts for a Block

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get All Transaction Receipts for a Block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "type": "0x2",
      "status": "0x1",
      "cumulativeGasUsed": "0x78c13",
      "logs": [
        {
          "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
          "topics": [
            "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
            "0x00000000000000000000000000000000000000000000000000000000000010ca",
            "0x00000000000000000000000000000000000000000000000000000000000010cb"
          ],
          "data": "0x",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
          "transactionIndex": "0x0",
          "logIndex": "0x0",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000020000000000000000000000200000000000000000000000200000000000000000000000000008000000000001000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000010000800000000000000000000000000000000000800000000000000100000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000...truncated",
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionIndex": "0x0",
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "gasUsed": "0x78c13",
      "effectiveGasPrice": "0x2540be400",
      "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
      "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
      "contractAddress": null
    },
    {
      "type": "0x2",
      "status": "0x1",
      "cumulativeGasUsed": "0xe4a1c",
      "logs": [
        {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "topics": [
            "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000f43fc2c04ee0000",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "logIndex": "0x1",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca"
          ],
          "data": "0x0000000000000000000000000000000000000000000007048b86bb9cbe4db9ad",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "logIndex": "0x2",
          "removed": false
        },
        {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "0x000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000928ca80cfc20000",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "logIndex": "0x3",
          "removed": false
        }
      ],
      "logsBloom": "0x0000000000000000000000000000000000000040000400000000000000000000040000002a0000000810000000000100020000000e00200000800000000000000004000000000008000000080004000000000010000000200000100080004000000008000020000000400000000000000800000000000000000000900008000000010008004001000004080000000000000000010000000004000000001000000000000000000000000000801000000000010000000000000000040000000000400008020000080000000000000008000000004000000000000000000000000200002000000000000040000000000000004000000000004000080010000000...truncated",
      "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
      "transactionIndex": "0x1",
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "gasUsed": "0x6be09",
      "effectiveGasPrice": "0x1e1ffa99",
      "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
      "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
      "contractAddress": null
    },
    {
      "type": "0x2",
      "status": "0x1",
      "cumulativeGasUsed": "0x192e75",
      "logs": [
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x00000000000000000000000000000000000000000000017b7883c06916600000",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "logIndex": "0x12",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x0000000000000000000000000000000000000000000000012302bfbf4a2c7c4b",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "logIndex": "0x13",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x000000000000000000000000000000000000000000000087c0bc23a9e4f95c34",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockNumber": "0x184077b",
          "blockTimestamp": "0x6a4399ab",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "logIndex": "0x14",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000100010000000000000000000000004000000000000000000400801800000008020000000000080000000100020020000800200000010000000000000000000000000008080000080000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000100008000000210000006000000001080002000000000000040100000000140080009008000000000000002000000010800000000000010000000000000020000000080020400000020000020000000000000000000000000000000000100400000000000000002000000000400000100000000000004000000000000000000000000000...truncated",
      "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
      "transactionIndex": "0x2",
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "gasUsed": "0xae459",
      "effectiveGasPrice": "0x4ad8d85",
      "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
      "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
      "contractAddress": null
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix at line 1 column 19"
  }
}

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByHash operations.

Get Transaction Count by Block Hash

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber operations.

Get Transaction Count by Block Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

eth_getCode

eth_getCode operations.

Get Contract Bytecode at Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Contract Bytecode at Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x60806040523661001357610011610017565b005b6100115b61001f6102a0565b73ffffffffffffffffffffffffffffffffffffffff1633036102965760607fffffffff000000000000000000000000000000000000000000000000000000005f35167fc9a6301a000000000000000000000000000000000000000000000000000000008101610097576100906102df565b915061028e565b7fb0e10d7a000000000000000000000000000000000000000000000000000000007fffffffff000000000000000000000000000000000000000000000000000000008216016100e857610090610332565b7f70d7c6900000000000000000000000000000000000...truncated"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getFilterChanges

eth_getFilterChanges operations.

Get Filter Changes

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Changes

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

const response = await fetch('https://eth-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://eth-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": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "filter not found"
  }
}

eth_getFilterLogs

eth_getFilterLogs operations.

Get Filter Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Logs

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

const response = await fetch('https://eth-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://eth-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": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "filter not found"
  }
}

eth_getLogs

eth_getLogs operations.

Get Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Logs

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1b4",
        "toBlock": "0x1f4",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          [
            "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
            "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
          ]
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x1b4",
          "toBlock": "0x1f4",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            null,
            [
              "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
              "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
            ]
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
      "topics": [
        "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
        "0x00000000000000000000000000000000000000000000000000000000000010ca",
        "0x00000000000000000000000000000000000000000000000000000000000010cb"
      ],
      "data": "0x",
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "blockTimestamp": "0x6a4399ab",
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionIndex": "0x0",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected Filter object at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected Filter object at line 1 column 19"
  }
}

eth_getStorageAt

eth_getStorageAt operations.

Get Storage At

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Storage At

curl -X POST 'https://eth-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://eth-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://eth-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": "0x0000000000000000000000000000000000000000000000000000000000000001"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockHashAndIndex operations.

Get Transaction by Block Hash and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Hash and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x1023",
    "gas": "0xe4e1c0",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "value": "0x0",
    "accessList": [],
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1",
    "v": "0x1",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "transactionIndex": "0x0",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gasPrice": "0x2540be400",
    "blockTimestamp": "0x6a4399ab"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByBlockNumberAndIndex operations.

Get Transaction by Block Number and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Number and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x1023",
    "gas": "0xe4e1c0",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "value": "0x0",
    "accessList": [],
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1",
    "v": "0x1",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "transactionIndex": "0x0",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gasPrice": "0x2540be400",
    "blockTimestamp": "0x6a4399ab"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

eth_getTransactionByHash

eth_getTransactionByHash operations.

Get transaction by hash

POST

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

Executes the eth_getTransactionByHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction by hash

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

const response = await fetch('https://eth-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://eth-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": {
    "type": "0x2",
    "chainId": "0x1",
    "nonce": "0x1023",
    "gas": "0xe4e1c0",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "value": "0x0",
    "accessList": [],
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1",
    "v": "0x1",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "transactionIndex": "0x0",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gasPrice": "0x2540be400",
    "blockTimestamp": "0x6a4399ab"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getTransactionCount

eth_getTransactionCount operations.

Get transaction count (nonce) for address

POST

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

Executes the eth_getTransactionCount JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction count (nonce) for address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x170a"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getTransactionReceipt

eth_getTransactionReceipt operations.

Get transaction receipt by hash

POST

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

Executes the eth_getTransactionReceipt JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction receipt by hash

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": {
    "type": "0x2",
    "status": "0x1",
    "cumulativeGasUsed": "0x78c13",
    "logs": [
      {
        "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
        "topics": [
          "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
          "0x00000000000000000000000000000000000000000000000000000000000010ca",
          "0x00000000000000000000000000000000000000000000000000000000000010cb"
        ],
        "data": "0x",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "transactionIndex": "0x0",
        "logIndex": "0x0",
        "removed": false
      }
    ],
    "logsBloom": "0x000000000000000000000000000000000000000020000000000000000000000200000000000000000000000200000000000000000000000000008000000000001000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000010000800000000000000000000000000000000000800000000000000100000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000...truncated",
    "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "transactionIndex": "0x0",
    "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "gasUsed": "0x78c13",
    "effectiveGasPrice": "0x2540be400",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "contractAddress": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockHashAndIndex operations.

Get uncle block by block hash and index

POST

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

Executes the eth_getUncleByBlockHashAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block hash and index

curl -X POST 'https://eth-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://eth-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://eth-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 params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getUncleByBlockNumberAndIndex

eth_getUncleByBlockNumberAndIndex operations.

Get uncle block by block number and index

POST

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

Executes the eth_getUncleByBlockNumberAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block number and index

curl -X POST 'https://eth-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://eth-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://eth-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 params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockHash operations.

Get the number of uncle blocks by block hash

POST

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

Executes the eth_getUncleCountByBlockHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block hash

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

const response = await fetch('https://eth-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://eth-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 params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_getUncleCountByBlockNumber

eth_getUncleCountByBlockNumber operations.

Get the number of uncle blocks by block number

POST

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

Executes the eth_getUncleCountByBlockNumber JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block number

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

const response = await fetch('https://eth-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://eth-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 params",
    "data": "hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "hex string without 0x prefix"
  }
}

eth_hashrate

eth_hashrate operations.

eth_hashrate

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_hashrate

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

const response = await fetch('https://eth-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://eth-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 params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_maxPriorityFeePerGas

eth_maxPriorityFeePerGas operations.

Get recommended maxPriorityFeePerGas value

POST

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

Executes the eth_maxPriorityFeePerGas JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get recommended maxPriorityFeePerGas value

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

const response = await fetch('https://eth-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://eth-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": "0x16c95"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_mining

eth_mining operations.

eth_mining

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_mining

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "unimplemented"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "unimplemented"
  }
}

eth_newBlockFilter

eth_newBlockFilter operations.

Create a new block filter

POST

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

Executes the eth_newBlockFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new block filter

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

const response = await fetch('https://eth-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://eth-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": "0x10"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_newFilter

eth_newFilter operations.

Create a new log filter

POST

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

Executes the eth_newFilter JSON-RPC method on Ethereum through NOWNodes.

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

Ethereum address.

topicsArray<string | Array<string>> | null

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

Show child attributes

Topics item.

One of

Topics item.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new log filter

curl -X POST 'https://eth-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://eth-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://eth-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": "0x11"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected Filter object at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected Filter object at line 1 column 19"
  }
}

eth_newPendingTransactionFilter

eth_newPendingTransactionFilter operations.

Create a filter for pending transactions

POST

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

Executes the eth_newPendingTransactionFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a filter for pending transactions

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

const response = await fetch('https://eth-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://eth-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": "0x12"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected a boolean at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected a boolean at line 1 column 19"
  }
}

eth_sendRawTransaction

eth_sendRawTransaction operations.

Send a raw signed transaction

POST

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

Executes the eth_sendRawTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a raw signed transaction

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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 params",
    "data": "invalid value: string \"not-a-valid-param\", expected a valid hex string at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a valid hex string at line 1 column 19"
  }
}

eth_sendRawTransactionSync

eth_sendRawTransactionSync operations.

Send raw transaction (synchronous)

POST

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

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Body

application/json

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Request payload for Send raw transaction (synchronous).

jsonrpcstring

JSON-RPC protocol version.

methodstring

JSON-RPC method name.

paramsArray<string>

Array containing one parameter - the signed transaction data in hex format (0x-prefixed)

idinteger

Client-provided request identifier echoed in the response.

Response

200OK

Successful response with transaction receipt. Returns the transaction receipt if the transaction was successfully mined.

400Bad Request

Invalid request or transaction data

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Transaction execution failed

Authorization

api-keyAuthapiKey in header

Send raw transaction (synchronous)

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransactionSync",
  "params": [
    "0xf86c808504a817c800825208943535353535353535353535353535353535353535880de0b6b3a76400008025a028ef61340bd939bc2195fe537567866003e1a15d3c71ff63e1590620aa636276a067cbe9d8997f761aecb703304b3800ccf555c9f3dc64214b297fb1966a3b6d83"
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a valid hex string at line 1 column 19"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "transaction failed: insufficient funds for gas * price + value"
  }
}

eth_sendTransaction

eth_sendTransaction operations.

Send a transaction using node-managed account

POST

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

Executes the eth_sendTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a transaction using node-managed account

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
        "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "gas": "0x5208",
        "gasPrice": "0x3b9aca00",
        "value": "0x16345785d8a0000",
        "data": "0x"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00",
          "value": "0x16345785d8a0000",
          "data": "0x"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x3333333333333333333333333333333333333333333333333333333333333333"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

eth_sign

eth_sign operations.

Sign arbitrary data using eth_sign

POST

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

Executes the eth_sign JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Sign arbitrary data using eth_sign

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "odd number of digits at line 1 column 19"
  }
}

eth_signTransaction

eth_signTransaction operations.

eth_signTransaction

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_signTransaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "value": "0xde0b6b3a7640000",
        "data": "0x",
        "nonce": "0x1",
        "chainId": 1
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
          "gas": "0x5208",
          "gasPrice": "0x4a817c800",
          "value": "0xde0b6b3a7640000",
          "data": "0x",
          "nonce": "0x1",
          "chainId": 1
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid type: string \"not-a-valid-param\", expected struct TransactionRequest at line 1 column 19"
  }
}

eth_syncing

eth_syncing operations.

Check if node is syncing

POST

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

Executes the eth_syncing JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Check if node is syncing

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

const response = await fetch('https://eth-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://eth-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 params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

eth_uninstallFilter

eth_uninstallFilter operations.

Uninstall an existing filter

POST

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

Executes the eth_uninstallFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Uninstall an existing filter

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

const response = await fetch('https://eth-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://eth-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": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

net_listening

net_listening operations.

net_listening

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_listening

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

const response = await fetch('https://eth-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://eth-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 params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

net_peerCount

net_peerCount operations.

net_peerCount

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_peerCount

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

const response = await fetch('https://eth-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://eth-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": "0x64"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

net_version

net_version operations.

net_version

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_version

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

const response = await fetch('https://eth-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://eth-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": "1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

web3_clientVersion

web3_clientVersion operations.

web3_clientVersion

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_clientVersion

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

const response = await fetch('https://eth-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://eth-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": "reth/v2.3.0-9384bc5/x86_64-unknown-linux-gnu"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

web3_sha3

web3_sha3 operations.

web3_sha3

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_sha3

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a valid hex string at line 1 column 19"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "invalid value: string \"not-a-valid-param\", expected a valid hex string at line 1 column 19"
  }
}

MAINNET / EVM

eth_accounts

eth_accounts operations.

Ethereum method - eth_accounts

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_accounts

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_blockNumber

eth_blockNumber operations.

Ethereum method - eth_blockNumber

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_blockNumber

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

const response = await fetch('https://eth-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://eth-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": "0x1840782"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_call

eth_call operations.

Ethereum method - eth_call

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_call

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_chainId

eth_chainId operations.

Ethereum method - eth_chainId

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_chainId

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

const response = await fetch('https://eth-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://eth-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": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_coinbase

eth_coinbase operations.

eth_coinbase

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_coinbase

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_coinbase does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_coinbase does not exist/is not available"
  }
}

eth_estimateGas

eth_estimateGas operations.

Estimate Gas for Transaction

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Estimate Gas for Transaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_feeHistory

eth_feeHistory operations.

eth_feeHistory

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_feeHistory

curl -X POST 'https://eth-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://eth-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://eth-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": "0x184077f",
    "reward": [
      [
        "0x518ef",
        "0x14370bd"
      ],
      [
        "0x1e61c",
        "0x449bf75"
      ],
      [
        "0xf4240",
        "0x46a9fa3"
      ]
    ],
    "baseFeePerGas": [
      "0x3b71c21",
      "0x413f67b",
      "0x3beb9e8"
    ],
    "gasUsedRatio": [
      0.8905035333333333,
      0.17341125,
      0.8817176333333333
    ],
    "baseFeePerBlobGas": [
      "0x3cc5cb",
      "0x3486b8",
      "0x351e68"
    ],
    "blobGasUsedRatio": [
      0.047619047619047616,
      0.14285714285714285,
      0.3333333333333333
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid hex or decimal integer \"not-a-valid-param\""
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid hex or decimal integer \"not-a-valid-param\""
  }
}

eth_gasPrice

eth_gasPrice operations.

Get Suggested Gas Price

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Suggested Gas Price

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

const response = await fetch('https://eth-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://eth-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": "0x41ba419"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_getBalance

eth_getBalance operations.

Get ETH Balance of an Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x4f090b18c4891915"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getBlockByHash

eth_getBlockByHash operations.

Get Block by Hash

POST

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

Returns the block information for the specified block hash. 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 hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Request payload for Get Block by Hash.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Hash

curl -X POST 'https://eth-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://eth-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://eth-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": "0x414f705",
    "blobGasUsed": "0x0",
    "difficulty": "0x0",
    "excessBlobGas": "0xa90f452",
    "extraData": "0x457572656b612028657572656b616275696c6465722e78797a29",
    "gasLimit": "0x3938700",
    "gasUsed": "0x162058d",
    "hash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "logsBloom": "0xbffbf7eff5ff1ffdbddeafb7e31cd5fb3ffc2d61afb75975fc73531975fdbdfe767eddffbaceee7ddbbf7b5b7ddfcfd5eafaf1b7ff47fee6cbffb3f3bf7e9fb4dfbdba9bf6fabfbfeddfed2cb57ffbfef6fbfede13799f7fbdf2dffffcce6fbdfbf21fef7ffacd53f7fecbd777d6dfdbbb3b7ce9b79ffff67ffb95d6bf9d36fb9379ae3ff7ef4fef9dffbfee17b37e2fd6bffe37d7bf5deeedbd8ed9f5fc5fe97ff7a32dffbe667bfe78bbfd7cd89ddfb3dfefcdffdd26557ef77feabee9ede7f3f9fc463ad6cfd7eaa595fffa7f7cc5794df2ff1e3fe09ef67fbfb70bb5fed7273a7ea8f37647c78eebfcfea8eebafaff6ffdb4c7ac7decd79cc37b57bf7d...truncated",
    "miner": "0xfb74767c1ce1aada0a0e114441173b57f8c1571b",
    "mixHash": "0x72595eb2f8c6cdd802689b0c807ddab09210908a1f8a2ec750a430752b9a2809",
    "nonce": "0x0000000000000000",
    "number": "0x184077b",
    "parentBeaconBlockRoot": "0xc759c962467c20468e4613486c8e396f3e5aad4e57036ed2bc000e633e80f2f1",
    "parentHash": "0x302492d53eaabcfc87a6a455267795739dfaaff8829b58db4206c22093334613",
    "receiptsRoot": "0xaa3d080713295cf6ed97939d4b7b21494105e9c3499b550bc87453711ec6b866",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x21c3a",
    "stateRoot": "0x3f58591d542193842f1b69e246665f85a0081b426fd6a02cadfd2dd1ace3dbab",
    "timestamp": "0x6a4399ab",
    "transactions": [
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gas": "0xe4e1c0",
        "gasPrice": "0x2540be400",
        "maxFeePerGas": "0x2540be400",
        "maxPriorityFeePerGas": "0x2540be400",
        "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "nonce": "0x1023",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x1",
        "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
        "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
        "yParity": "0x1"
      },
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gas": "0x921bd",
        "gasPrice": "0x1e1ffa99",
        "maxFeePerGas": "0x1e3871f7",
        "maxPriorityFeePerGas": "0x1a0b0394",
        "hash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "nonce": "0x425",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "transactionIndex": "0x1",
        "value": "0xf43fc2c04ee0000",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x0",
        "r": "0x7aead194f13cba03a6383e92d4fce25db742b57b4f28c1417d811defe7b27359",
        "s": "0x1afb2f537d0d62d463e31fefe0c8575f9a376b7e4a8ca50694604ec2e93de77",
        "yParity": "0x0"
      },
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gas": "0x3d0900",
        "gasPrice": "0x4ad8d85",
        "maxFeePerGas": "0x5302c65",
        "maxPriorityFeePerGas": "0x989680",
        "hash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "nonce": "0x3342",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "transactionIndex": "0x2",
        "value": "0x428c069b",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x0",
        "r": "0xdf437116eb31983d0f4c7fa4eaf438cf02235e72289fed903901715e5c109e29",
        "s": "0x26adc1ab18d4308d5a6a83f9893a6b4befcff6f71b67369e7654adf61331d6fe",
        "yParity": "0x0"
      }
    ],
    "transactionsRoot": "0x4743871848d5e277b4e45a0cd5287d1652d484d4ed0c968355e526654931babe",
    "uncles": [],
    "withdrawals": [
      {
        "index": "0x8018a9b",
        "validatorIndex": "0xbee76",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde9c77"
      },
      {
        "index": "0x8018a9c",
        "validatorIndex": "0xbee77",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xdebe81"
      },
      {
        "index": "0x8018a9d",
        "validatorIndex": "0xbee78",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde6be6"
      }
    ],
    "withdrawalsRoot": "0xa151dcbfa3957218d375674c55d70f57a6c610054507ff6ea97c461f3f21268f"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getBlockByNumber

eth_getBlockByNumber operations.

Get Block by Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Number

curl -X POST 'https://eth-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://eth-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://eth-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": "0x414f705",
    "blobGasUsed": "0x0",
    "difficulty": "0x0",
    "excessBlobGas": "0xa90f452",
    "extraData": "0x457572656b612028657572656b616275696c6465722e78797a29",
    "gasLimit": "0x3938700",
    "gasUsed": "0x162058d",
    "hash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "logsBloom": "0xbffbf7eff5ff1ffdbddeafb7e31cd5fb3ffc2d61afb75975fc73531975fdbdfe767eddffbaceee7ddbbf7b5b7ddfcfd5eafaf1b7ff47fee6cbffb3f3bf7e9fb4dfbdba9bf6fabfbfeddfed2cb57ffbfef6fbfede13799f7fbdf2dffffcce6fbdfbf21fef7ffacd53f7fecbd777d6dfdbbb3b7ce9b79ffff67ffb95d6bf9d36fb9379ae3ff7ef4fef9dffbfee17b37e2fd6bffe37d7bf5deeedbd8ed9f5fc5fe97ff7a32dffbe667bfe78bbfd7cd89ddfb3dfefcdffdd26557ef77feabee9ede7f3f9fc463ad6cfd7eaa595fffa7f7cc5794df2ff1e3fe09ef67fbfb70bb5fed7273a7ea8f37647c78eebfcfea8eebafaff6ffdb4c7ac7decd79cc37b57bf7d...truncated",
    "miner": "0xfb74767c1ce1aada0a0e114441173b57f8c1571b",
    "mixHash": "0x72595eb2f8c6cdd802689b0c807ddab09210908a1f8a2ec750a430752b9a2809",
    "nonce": "0x0000000000000000",
    "number": "0x184077b",
    "parentBeaconBlockRoot": "0xc759c962467c20468e4613486c8e396f3e5aad4e57036ed2bc000e633e80f2f1",
    "parentHash": "0x302492d53eaabcfc87a6a455267795739dfaaff8829b58db4206c22093334613",
    "receiptsRoot": "0xaa3d080713295cf6ed97939d4b7b21494105e9c3499b550bc87453711ec6b866",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x21c3a",
    "stateRoot": "0x3f58591d542193842f1b69e246665f85a0081b426fd6a02cadfd2dd1ace3dbab",
    "timestamp": "0x6a4399ab",
    "transactions": [
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
        "gas": "0xe4e1c0",
        "gasPrice": "0x2540be400",
        "maxFeePerGas": "0x2540be400",
        "maxPriorityFeePerGas": "0x2540be400",
        "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
        "nonce": "0x1023",
        "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
        "transactionIndex": "0x0",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x1",
        "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
        "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
        "yParity": "0x1"
      },
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
        "gas": "0x921bd",
        "gasPrice": "0x1e1ffa99",
        "maxFeePerGas": "0x1e3871f7",
        "maxPriorityFeePerGas": "0x1a0b0394",
        "hash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
        "input": "0x3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a0000000000000000000000000000000000000000000000000000000006a43a07c00000000000000000000000000000000000000000000000000000000000000070b00001000100400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000700000000000000000000000000000000000000000000000000000000000000e0000000000000000000000000000000000000000000000000000000...truncated",
        "nonce": "0x425",
        "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
        "transactionIndex": "0x1",
        "value": "0xf43fc2c04ee0000",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x0",
        "r": "0x7aead194f13cba03a6383e92d4fce25db742b57b4f28c1417d811defe7b27359",
        "s": "0x1afb2f537d0d62d463e31fefe0c8575f9a376b7e4a8ca50694604ec2e93de77",
        "yParity": "0x0"
      },
      {
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockNumber": "0x184077b",
        "blockTimestamp": "0x6a4399ab",
        "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
        "gas": "0x3d0900",
        "gasPrice": "0x4ad8d85",
        "maxFeePerGas": "0x5302c65",
        "maxPriorityFeePerGas": "0x989680",
        "hash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
        "input": "0x00000000000000000000000008d1838831881f8017000000000381724bb3b0a34bff2302a2104c0d111111125421ca6dc452d289314280a0f8842a650203000004bd1db316d60b3fa5919fdc02e64f633da5d01174b62b35198beef55dcc282bb14a82836d00fa80f500290f2b9ada619686666d95781288cee9df6758b4fd4b4a4fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83c0dfdb9e7a392c3dbbe7c6fbe8fbc1789c9fe05e94a8b4ee5cd64c79d0ee816f467ea73009f51aa0dac17f958d2ee523a2206206994597c13d831ec700000000000000000000000000000000000000000000017b7883c069166000000000000000000000000000000000...truncated",
        "nonce": "0x3342",
        "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
        "transactionIndex": "0x2",
        "value": "0x428c069b",
        "type": "0x2",
        "accessList": [],
        "chainId": "0x1",
        "v": "0x0",
        "r": "0xdf437116eb31983d0f4c7fa4eaf438cf02235e72289fed903901715e5c109e29",
        "s": "0x26adc1ab18d4308d5a6a83f9893a6b4befcff6f71b67369e7654adf61331d6fe",
        "yParity": "0x0"
      }
    ],
    "transactionsRoot": "0x4743871848d5e277b4e45a0cd5287d1652d484d4ed0c968355e526654931babe",
    "uncles": [],
    "withdrawals": [
      {
        "index": "0x8018a9b",
        "validatorIndex": "0xbee76",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde9c77"
      },
      {
        "index": "0x8018a9c",
        "validatorIndex": "0xbee77",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xdebe81"
      },
      {
        "index": "0x8018a9d",
        "validatorIndex": "0xbee78",
        "address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
        "amount": "0xde6be6"
      }
    ],
    "withdrawalsRoot": "0xa151dcbfa3957218d375674c55d70f57a6c610054507ff6ea97c461f3f21268f"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getBlockReceipts

eth_getBlockReceipts operations.

Get All Transaction Receipts for a Block

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get All Transaction Receipts for a Block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "contractAddress": null,
      "cumulativeGasUsed": "0x78c13",
      "effectiveGasPrice": "0x2540be400",
      "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
      "gasUsed": "0x78c13",
      "logs": [
        {
          "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
          "topics": [
            "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
            "0x00000000000000000000000000000000000000000000000000000000000010ca",
            "0x00000000000000000000000000000000000000000000000000000000000010cb"
          ],
          "data": "0x",
          "blockNumber": "0x184077b",
          "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
          "transactionIndex": "0x0",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x0",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000020000000000000000000000200000000000000000000000200000000000000000000000000008000000000001000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000010000800000000000000000000000000000000000800000000000000100000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionIndex": "0x0",
      "type": "0x2"
    },
    {
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "contractAddress": null,
      "cumulativeGasUsed": "0xe4a1c",
      "effectiveGasPrice": "0x1e1ffa99",
      "from": "0xb935b1af63e91b8dec285fb587a8598cd1a5fcc6",
      "gasUsed": "0x6be09",
      "logs": [
        {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "topics": [
            "0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000f43fc2c04ee0000",
          "blockNumber": "0x184077b",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x1",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca"
          ],
          "data": "0x0000000000000000000000000000000000000000000007048b86bb9cbe4db9ad",
          "blockNumber": "0x184077b",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x2",
          "removed": false
        },
        {
          "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
            "0x000000000000000000000000ba2a013b29631d3277bbbce80c970d06c1bda0c3"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000928ca80cfc20000",
          "blockNumber": "0x184077b",
          "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
          "transactionIndex": "0x1",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x3",
          "removed": false
        }
      ],
      "logsBloom": "0x0000000000000000000000000000000000000040000400000000000000000000040000002a0000000810000000000100020000000e00200000800000000000000004000000000008000000080004000000000010000000200000100080004000000008000020000000400000000000000800000000000000000000900008000000010008004001000004080000000000000000010000000004000000001000000000000000000000000000801000000000010000000000000000040000000000400008020000080000000000000008000000004000000000000000000000000200002000000000000040000000000000004000000000004000080010000000...truncated",
      "status": "0x1",
      "to": "0x4c82d1fbfe28c977cbb58d8c7ff8fcf9f70a2cca",
      "transactionHash": "0x40561190924b023d926c68cb1f40db894c57f204fbb023537c273bd2e0c183e1",
      "transactionIndex": "0x1",
      "type": "0x2"
    },
    {
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockNumber": "0x184077b",
      "contractAddress": null,
      "cumulativeGasUsed": "0x192e75",
      "effectiveGasPrice": "0x4ad8d85",
      "from": "0xcbc76807fdc08e28ad16ec905a10205f9092bbe9",
      "gasUsed": "0xae459",
      "logs": [
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x00000000000000000000000000000000000000000000017b7883c06916600000",
          "blockNumber": "0x184077b",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x12",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x0000000000000000000000000000000000000000000000012302bfbf4a2c7c4b",
          "blockNumber": "0x184077b",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x13",
          "removed": false
        },
        {
          "address": "0x94a8b4ee5cd64c79d0ee816f467ea73009f51aa0",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x0000000000000000000000004fa1fef43a89cdb9d3c56a2b534bacf0c7d07a83",
            "0x0000000000000000000000006745024462abf2c049f54b381c4ad4a8c8d999c4"
          ],
          "data": "0x000000000000000000000000000000000000000000000087c0bc23a9e4f95c34",
          "blockNumber": "0x184077b",
          "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
          "transactionIndex": "0x2",
          "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
          "blockTimestamp": "0x6a4399ab",
          "logIndex": "0x14",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000100010000000000000000000000004000000000000000000400801800000008020000000000080000000100020020000800200000010000000000000000000000000008080000080000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000100008000000210000006000000001080002000000000000040100000000140080009008000000000000002000000010800000000000010000000000000020000000080020400000020000020000000000000000000000000000000000100400000000000000002000000000400000100000000000004000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x6745024462abf2c049f54b381c4ad4a8c8d999c4",
      "transactionHash": "0x55c3a615ef55ebff58b2d27f3354d381af9de729507d78849a61938b29b04649",
      "transactionIndex": "0x2",
      "type": "0x2"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByHash operations.

Get Transaction Count by Block Hash

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber operations.

Get Transaction Count by Block Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getCode

eth_getCode operations.

Get Contract Bytecode at Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Contract Bytecode at Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x60806040523661001357610011610017565b005b6100115b61001f6102a0565b73ffffffffffffffffffffffffffffffffffffffff1633036102965760607fffffffff000000000000000000000000000000000000000000000000000000005f35167fc9a6301a000000000000000000000000000000000000000000000000000000008101610097576100906102df565b915061028e565b7fb0e10d7a000000000000000000000000000000000000000000000000000000007fffffffff000000000000000000000000000000000000000000000000000000008216016100e857610090610332565b7f70d7c6900000000000000000000000000000000000...truncated"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getFilterChanges

eth_getFilterChanges operations.

Get Filter Changes

POST

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

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Changes

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

const response = await fetch('https://eth-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://eth-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": -32000,
    "message": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

eth_getFilterLogs

eth_getFilterLogs operations.

Get Filter Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Logs

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

const response = await fetch('https://eth-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://eth-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": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

eth_getLogs

eth_getLogs operations.

Get Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Logs

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1b4",
        "toBlock": "0x1f4",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          [
            "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
            "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
          ]
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x1b4",
          "toBlock": "0x1f4",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            null,
            [
              "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
              "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
            ]
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
      "topics": [
        "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
        "0x00000000000000000000000000000000000000000000000000000000000010ca",
        "0x00000000000000000000000000000000000000000000000000000000000010cb"
      ],
      "data": "0x",
      "blockNumber": "0x184077b",
      "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
      "transactionIndex": "0x0",
      "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
      "blockTimestamp": "0x6a4399ab",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

eth_getStorageAt

eth_getStorageAt operations.

Get Storage At

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Storage At

curl -X POST 'https://eth-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://eth-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://eth-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": "0x0000000000000000000000000000000000000000000000000000000000000001"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockHashAndIndex operations.

Get Transaction by Block Hash and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Hash and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "blockTimestamp": "0x6a4399ab",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gas": "0xe4e1c0",
    "gasPrice": "0x2540be400",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "nonce": "0x1023",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x2",
    "accessList": [],
    "chainId": "0x1",
    "v": "0x1",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByBlockNumberAndIndex operations.

Get Transaction by Block Number and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Number and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "blockTimestamp": "0x6a4399ab",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gas": "0xe4e1c0",
    "gasPrice": "0x2540be400",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "nonce": "0x1023",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x2",
    "accessList": [],
    "chainId": "0x1",
    "v": "0x1",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getTransactionByHash

eth_getTransactionByHash operations.

Get transaction by hash

POST

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

Executes the eth_getTransactionByHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction by hash

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

const response = await fetch('https://eth-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://eth-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": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "blockTimestamp": "0x6a4399ab",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gas": "0xe4e1c0",
    "gasPrice": "0x2540be400",
    "maxFeePerGas": "0x2540be400",
    "maxPriorityFeePerGas": "0x2540be400",
    "hash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "input": "0x9271e4500000000000000000000000000583ef2b6416cb7b287406438b940e4d99680c5b00000000000000000000000000000000000000000000000000000000000010cb00000000000000000000000000000000000000000000000000000000000010cb000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000008810100000000000000000000000000000000000000000000000000000000000010ca828529425c9991fd291d973a9c91e2ef05b7a86f5b540902c50943c0c2b29b840000000000000000000000000000000000000000000000000000...truncated",
    "nonce": "0x1023",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x2",
    "accessList": [],
    "chainId": "0x1",
    "v": "0x1",
    "r": "0x8dc3c18f20b381e890a39cdf7b978861c8410e29e7c986672dad5d6af297cca5",
    "s": "0x6a90bcf60c159962c8c0ad56c02812e73124be90e433dc7892fbdb087212f5fa",
    "yParity": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getTransactionCount

eth_getTransactionCount operations.

Get transaction count (nonce) for address

POST

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

Executes the eth_getTransactionCount JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction count (nonce) for address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x170a"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getTransactionReceipt

eth_getTransactionReceipt operations.

Get transaction receipt by hash

POST

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

Executes the eth_getTransactionReceipt JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction receipt by hash

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
    "blockNumber": "0x184077b",
    "contractAddress": null,
    "cumulativeGasUsed": "0x78c13",
    "effectiveGasPrice": "0x2540be400",
    "from": "0x0b6f2116323c12ee731de6818e41861561bcd44c",
    "gasUsed": "0x78c13",
    "logs": [
      {
        "address": "0x0583ef2b6416cb7b287406438b940e4d99680c5b",
        "topics": [
          "0x22c9005dd88c18b552a1cd7e8b3b937fcde9ca69213c1f658f54d572e4877a81",
          "0x00000000000000000000000000000000000000000000000000000000000010ca",
          "0x00000000000000000000000000000000000000000000000000000000000010cb"
        ],
        "data": "0x",
        "blockNumber": "0x184077b",
        "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
        "transactionIndex": "0x0",
        "blockHash": "0x512f5b3b7f2c1943aa1abf30a5b4a3e600832b773168236de3f282fb635c6ffe",
        "blockTimestamp": "0x6a4399ab",
        "logIndex": "0x0",
        "removed": false
      }
    ],
    "logsBloom": "0x000000000000000000000000000000000000000020000000000000000000000200000000000000000000000200000000000000000000000000008000000000001000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000010000800000000000000000000000000000000000800000000000000100000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000...truncated",
    "status": "0x1",
    "to": "0xe28cac160c2a79dfa1fbd2169ac5fa5d061cf186",
    "transactionHash": "0x3ed0ce61d1c07b0db202321a7340f390df0f5fa698c5fcad3acf53a5b41615cd",
    "transactionIndex": "0x0",
    "type": "0x2"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockHashAndIndex operations.

Get uncle block by block hash and index

POST

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

Executes the eth_getUncleByBlockHashAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block hash and index

curl -X POST 'https://eth-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://eth-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://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleByBlockNumberAndIndex

eth_getUncleByBlockNumberAndIndex operations.

Get uncle block by block number and index

POST

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

Executes the eth_getUncleByBlockNumberAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block number and index

curl -X POST 'https://eth-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://eth-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://eth-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 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockHash operations.

Get the number of uncle blocks by block hash

POST

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

Executes the eth_getUncleCountByBlockHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block hash

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

const response = await fetch('https://eth-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://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleCountByBlockNumber

eth_getUncleCountByBlockNumber operations.

Get the number of uncle blocks by block number

POST

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

Executes the eth_getUncleCountByBlockNumber JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block number

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

const response = await fetch('https://eth-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://eth-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 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_hashrate

eth_hashrate operations.

eth_hashrate

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_hashrate

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_hashrate does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_hashrate does not exist/is not available"
  }
}

eth_maxPriorityFeePerGas

eth_maxPriorityFeePerGas operations.

Get recommended maxPriorityFeePerGas value

POST

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

Executes the eth_maxPriorityFeePerGas JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get recommended maxPriorityFeePerGas value

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

const response = await fetch('https://eth-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://eth-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": "0x16c95"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_mining

eth_mining operations.

eth_mining

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_mining

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_mining does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_mining does not exist/is not available"
  }
}

eth_newBlockFilter

eth_newBlockFilter operations.

Create a new block filter

POST

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

Executes the eth_newBlockFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new block filter

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

const response = await fetch('https://eth-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://eth-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": "0x10"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_newFilter

eth_newFilter operations.

Create a new log filter

POST

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

Executes the eth_newFilter JSON-RPC method on Ethereum through NOWNodes.

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

Ethereum address.

topicsArray<string | Array<string>> | null

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

Show child attributes

Topics item.

One of

Topics item.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new log filter

curl -X POST 'https://eth-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://eth-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://eth-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": "0x11"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

eth_newPendingTransactionFilter

eth_newPendingTransactionFilter operations.

Create a filter for pending transactions

POST

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

Executes the eth_newPendingTransactionFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a filter for pending transactions

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

const response = await fetch('https://eth-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://eth-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": "0x12"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type bool"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type bool"
  }
}

eth_sendRawTransaction

eth_sendRawTransaction operations.

Send a raw signed transaction

POST

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

Executes the eth_sendRawTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a raw signed transaction

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

eth_sendRawTransactionSync

eth_sendRawTransactionSync operations.

Send raw transaction (synchronous)

POST

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

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Body

application/json

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Request payload for Send raw transaction (synchronous).

jsonrpcstring

JSON-RPC protocol version.

methodstring

JSON-RPC method name.

paramsArray<string>

Array containing one parameter - the signed transaction data in hex format (0x-prefixed)

idinteger

Client-provided request identifier echoed in the response.

Response

200OK

Successful response with transaction receipt. Returns the transaction receipt if the transaction was successfully mined.

400Bad Request

Invalid request or transaction data

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Transaction execution failed

Authorization

api-keyAuthapiKey in header

Send raw transaction (synchronous)

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransactionSync",
  "params": [
    "0xf86c808504a817c800825208943535353535353535353535353535353535353535880de0b6b3a76400008025a028ef61340bd939bc2195fe537567866003e1a15d3c71ff63e1590620aa636276a067cbe9d8997f761aecb703304b3800ccf555c9f3dc64214b297fb1966a3b6d83"
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "transaction failed: insufficient funds for gas * price + value"
  }
}

eth_sendTransaction

eth_sendTransaction operations.

Send a transaction using node-managed account

POST

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

Executes the eth_sendTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a transaction using node-managed account

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
        "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "gas": "0x5208",
        "gasPrice": "0x3b9aca00",
        "value": "0x16345785d8a0000",
        "data": "0x"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00",
          "value": "0x16345785d8a0000",
          "data": "0x"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x3333333333333333333333333333333333333333333333333333333333333333"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_sign

eth_sign operations.

Sign arbitrary data using eth_sign

POST

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

Executes the eth_sign JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Sign arbitrary data using eth_sign

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_signTransaction

eth_signTransaction operations.

eth_signTransaction

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_signTransaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "value": "0xde0b6b3a7640000",
        "data": "0x",
        "nonce": "0x1",
        "chainId": 1
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
          "gas": "0x5208",
          "gasPrice": "0x4a817c800",
          "value": "0xde0b6b3a7640000",
          "data": "0x",
          "nonce": "0x1",
          "chainId": 1
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_syncing

eth_syncing operations.

Check if node is syncing

POST

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

Executes the eth_syncing JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Check if node is syncing

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_uninstallFilter

eth_uninstallFilter operations.

Uninstall an existing filter

POST

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

Executes the eth_uninstallFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Uninstall an existing filter

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

const response = await fetch('https://eth-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://eth-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": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

net_listening

net_listening operations.

net_listening

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_listening

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

net_peerCount

net_peerCount operations.

net_peerCount

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_peerCount

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

const response = await fetch('https://eth-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://eth-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": "0x1f"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

net_version

net_version operations.

net_version

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_version

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

const response = await fetch('https://eth-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://eth-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": "1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

web3_clientVersion

web3_clientVersion operations.

web3_clientVersion

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_clientVersion

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

const response = await fetch('https://eth-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://eth-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.17.3-stable-117e067f/linux-amd64/go1.25.10"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

web3_sha3

web3_sha3 operations.

web3_sha3

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_sha3

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

TESTNET / EVM

eth_accounts

eth_accounts operations.

Ethereum method - eth_accounts

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_accounts

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_blockNumber

eth_blockNumber operations.

Ethereum method - eth_blockNumber

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_blockNumber

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

const response = await fetch('https://eth-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://eth-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": "0xaa78db"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_call

eth_call operations.

Ethereum method - eth_call

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_call

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_chainId

eth_chainId operations.

Ethereum method - eth_chainId

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_chainId

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

const response = await fetch('https://eth-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://eth-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": "0xaa36a7"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_coinbase

eth_coinbase operations.

eth_coinbase

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_coinbase

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_coinbase does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_coinbase does not exist/is not available"
  }
}

eth_estimateGas

eth_estimateGas operations.

Estimate Gas for Transaction

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Estimate Gas for Transaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_feeHistory

eth_feeHistory operations.

eth_feeHistory

POST

https://eth-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 JSON-RPC parameter value accepted by this method.

Any of

Single JSON-RPC parameter value accepted by this method.

string

Single JSON-RPC parameter value accepted by this method.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_feeHistory

curl -X POST 'https://eth-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://eth-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://eth-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": "0xaa78d8",
    "reward": [
      [
        "0xf4240",
        "0xb4e070d"
      ],
      [
        "0x6587c6e",
        "0x5435ae61"
      ],
      [
        "0xf4240",
        "0x4a3f28bc"
      ]
    ],
    "baseFeePerGas": [
      "0x4248c0e1",
      "0x4423c89f",
      "0x41edd477"
    ],
    "gasUsedRatio": [
      0.6119776313787498,
      0.37022225,
      0.45405803333333333
    ],
    "baseFeePerBlobGas": [
      "0x3b4f5dd",
      "0x3d1c68d",
      "0x3dcce33"
    ],
    "blobGasUsedRatio": [
      0.38095238095238093,
      0.14285714285714285,
      0.2857142857142857
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid hex or decimal integer \"not-a-valid-param\""
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid hex or decimal integer \"not-a-valid-param\""
  }
}

eth_gasPrice

eth_gasPrice operations.

Get Suggested Gas Price

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Suggested Gas Price

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

const response = await fetch('https://eth-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://eth-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": "0x413b3d12"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_getBalance

eth_getBalance operations.

Get ETH Balance of an Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0xb8f1e139afe5ab8"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getBlockByHash

eth_getBlockByHash operations.

Get Block by Hash

POST

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

Returns the block information for the specified block hash. 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 hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Request payload for Get Block by Hash.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Hash

curl -X POST 'https://eth-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://eth-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://eth-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": "0x3d2646c1",
    "blobGasUsed": "0x80000",
    "difficulty": "0x0",
    "excessBlobGas": "0xc7c47ad",
    "extraData": "0x496c6c756d696e61746520446d6f63726174697a6520447374726962757465",
    "gasLimit": "0x3938700",
    "gasUsed": "0x1921042",
    "hash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "logsBloom": "0x14ef12b4d095954480888a40b45d601dd0411845a7ada55d82501914621fa5326cd90a24609ffaf5ae8a494750f02362d41902845ebe243cdc231a2b3cab6f85d20dbfc24880301880341dcac4fd92610e431b4cf5c0647ab02288ea8aa61c9b08789459aba906998371d0a3c9402d452a1cb0d020dffc80009058b04ab80820c5ca1006f05ec979792e01098330489241f21c99a80be1788a4d8c5615b4721152e56047f1f3052fb3567d544222140e43c4aca43ec89bd869fc4b9a153c48ab9e51a00a39baa05ef74314f8fdcf96fd5a98310cc66e3b338c33594be700680194120e7b04a07ecf614095914eb3daf2920407140cb0026e9acf380839c84a...truncated",
    "miner": "0x13cb6ae34a13a0977f4d7101ebc24b87bb23f0d5",
    "mixHash": "0xb08e16d445798b3eeaf454911779f597f9ec35e633d13e184ab5fefbd10c0c8d",
    "nonce": "0x0000000000000000",
    "number": "0xaa78d0",
    "parentBeaconBlockRoot": "0xd71222080dbcd0ba17ecb345b29891d23c92b59832e6394b3bd2a008730e40cc",
    "parentHash": "0xc2a9ceacf8ba8251a0288fa2bbf67b3c7cfe7ea1ea3b8f7f7b8b59139cdf81db",
    "receiptsRoot": "0xca2a6056b455755e0f7aa15724d595ae5fbc02b04562bc064f1cdc47c622cd43",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x112e5",
    "stateRoot": "0x0bd499ad0c180809ad9f3938c61ecec09520d7cd444261d3c57d08e9cf0d5fef",
    "timestamp": "0x6a4399ac",
    "transactions": [
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
        "gas": "0x15f90",
        "gasPrice": "0xccdb50ac",
        "hash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
        "input": "0x",
        "nonce": "0x26f",
        "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
        "transactionIndex": "0x0",
        "value": "0x6d93ca6c63f0",
        "type": "0x0",
        "chainId": "0xaa36a7",
        "v": "0x1546d71",
        "r": "0x7cd3d987ac61a466220a4cef09e1227d5a53e4888f7f7128a0fe9c1640f7539e",
        "s": "0x7b9370120d693cbf2b9f3b7a7cf987fd72877066ed69801ad256852dd0eb5513"
      },
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0x57ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
        "gas": "0x2c26c",
        "gasPrice": "0xb45bdac1",
        "maxFeePerGas": "0xf36a8e7c",
        "maxPriorityFeePerGas": "0x77359400",
        "hash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
        "input": "0xa694fc3a0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "nonce": "0xa",
        "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
        "transactionIndex": "0x1",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0xaa36a7",
        "v": "0x1",
        "r": "0xb79fd8404374661a7772e8254f46a90e66ed185fef9b04018d995b73821b99e9",
        "s": "0x58093977c0a1fa6ead3c725d7d619097530d5d9ac4846a29a590e23ddc99ed39",
        "yParity": "0x1"
      },
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0xbc753396cc214acc6c49ca28969d19e1a7d36730",
        "gas": "0x2c26c",
        "gasPrice": "0xb45bdac1",
        "maxFeePerGas": "0xf36a8e7c",
        "maxPriorityFeePerGas": "0x77359400",
        "hash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
        "input": "0xa694fc3a0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "nonce": "0xa",
        "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
        "transactionIndex": "0x2",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0xaa36a7",
        "v": "0x0",
        "r": "0x758dbea02ecc7009d9c88741f1fef0e56c603688513e53e4db56a657c6df6777",
        "s": "0x283d3ce0cdb7fae563ad04d564ac0327f4575420e9eaf8dea405e51ec2307a8b",
        "yParity": "0x0"
      }
    ],
    "transactionsRoot": "0xef68ca1681c172b6a6c1d2335c92e61ff3ad153c7ba1010f2aa5251b5b1b99de",
    "uncles": [],
    "withdrawals": [
      {
        "index": "0x7cd0c99",
        "validatorIndex": "0x61f",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      },
      {
        "index": "0x7cd0c9a",
        "validatorIndex": "0x620",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      },
      {
        "index": "0x7cd0c9b",
        "validatorIndex": "0x621",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      }
    ],
    "withdrawalsRoot": "0x76c680232fb35d44a7ef17508ecf35c74b109bbf48ea0e454271a6158a082be5"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getBlockByNumber

eth_getBlockByNumber operations.

Get Block by Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Block by Number

curl -X POST 'https://eth-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://eth-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://eth-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": "0x3d2646c1",
    "blobGasUsed": "0x80000",
    "difficulty": "0x0",
    "excessBlobGas": "0xc7c47ad",
    "extraData": "0x496c6c756d696e61746520446d6f63726174697a6520447374726962757465",
    "gasLimit": "0x3938700",
    "gasUsed": "0x1921042",
    "hash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "logsBloom": "0x14ef12b4d095954480888a40b45d601dd0411845a7ada55d82501914621fa5326cd90a24609ffaf5ae8a494750f02362d41902845ebe243cdc231a2b3cab6f85d20dbfc24880301880341dcac4fd92610e431b4cf5c0647ab02288ea8aa61c9b08789459aba906998371d0a3c9402d452a1cb0d020dffc80009058b04ab80820c5ca1006f05ec979792e01098330489241f21c99a80be1788a4d8c5615b4721152e56047f1f3052fb3567d544222140e43c4aca43ec89bd869fc4b9a153c48ab9e51a00a39baa05ef74314f8fdcf96fd5a98310cc66e3b338c33594be700680194120e7b04a07ecf614095914eb3daf2920407140cb0026e9acf380839c84a...truncated",
    "miner": "0x13cb6ae34a13a0977f4d7101ebc24b87bb23f0d5",
    "mixHash": "0xb08e16d445798b3eeaf454911779f597f9ec35e633d13e184ab5fefbd10c0c8d",
    "nonce": "0x0000000000000000",
    "number": "0xaa78d0",
    "parentBeaconBlockRoot": "0xd71222080dbcd0ba17ecb345b29891d23c92b59832e6394b3bd2a008730e40cc",
    "parentHash": "0xc2a9ceacf8ba8251a0288fa2bbf67b3c7cfe7ea1ea3b8f7f7b8b59139cdf81db",
    "receiptsRoot": "0xca2a6056b455755e0f7aa15724d595ae5fbc02b04562bc064f1cdc47c622cd43",
    "requestsHash": "0xe3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x112e5",
    "stateRoot": "0x0bd499ad0c180809ad9f3938c61ecec09520d7cd444261d3c57d08e9cf0d5fef",
    "timestamp": "0x6a4399ac",
    "transactions": [
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
        "gas": "0x15f90",
        "gasPrice": "0xccdb50ac",
        "hash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
        "input": "0x",
        "nonce": "0x26f",
        "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
        "transactionIndex": "0x0",
        "value": "0x6d93ca6c63f0",
        "type": "0x0",
        "chainId": "0xaa36a7",
        "v": "0x1546d71",
        "r": "0x7cd3d987ac61a466220a4cef09e1227d5a53e4888f7f7128a0fe9c1640f7539e",
        "s": "0x7b9370120d693cbf2b9f3b7a7cf987fd72877066ed69801ad256852dd0eb5513"
      },
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0x57ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
        "gas": "0x2c26c",
        "gasPrice": "0xb45bdac1",
        "maxFeePerGas": "0xf36a8e7c",
        "maxPriorityFeePerGas": "0x77359400",
        "hash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
        "input": "0xa694fc3a0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "nonce": "0xa",
        "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
        "transactionIndex": "0x1",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0xaa36a7",
        "v": "0x1",
        "r": "0xb79fd8404374661a7772e8254f46a90e66ed185fef9b04018d995b73821b99e9",
        "s": "0x58093977c0a1fa6ead3c725d7d619097530d5d9ac4846a29a590e23ddc99ed39",
        "yParity": "0x1"
      },
      {
        "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
        "blockNumber": "0xaa78d0",
        "blockTimestamp": "0x6a4399ac",
        "from": "0xbc753396cc214acc6c49ca28969d19e1a7d36730",
        "gas": "0x2c26c",
        "gasPrice": "0xb45bdac1",
        "maxFeePerGas": "0xf36a8e7c",
        "maxPriorityFeePerGas": "0x77359400",
        "hash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
        "input": "0xa694fc3a0000000000000000000000000000000000000000000000000de0b6b3a7640000",
        "nonce": "0xa",
        "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
        "transactionIndex": "0x2",
        "value": "0x0",
        "type": "0x2",
        "accessList": [],
        "chainId": "0xaa36a7",
        "v": "0x0",
        "r": "0x758dbea02ecc7009d9c88741f1fef0e56c603688513e53e4db56a657c6df6777",
        "s": "0x283d3ce0cdb7fae563ad04d564ac0327f4575420e9eaf8dea405e51ec2307a8b",
        "yParity": "0x0"
      }
    ],
    "transactionsRoot": "0xef68ca1681c172b6a6c1d2335c92e61ff3ad153c7ba1010f2aa5251b5b1b99de",
    "uncles": [],
    "withdrawals": [
      {
        "index": "0x7cd0c99",
        "validatorIndex": "0x61f",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      },
      {
        "index": "0x7cd0c9a",
        "validatorIndex": "0x620",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      },
      {
        "index": "0x7cd0c9b",
        "validatorIndex": "0x621",
        "address": "0xf97e180c050e5ab072211ad2c213eb5aee4df134",
        "amount": "0x3760e"
      }
    ],
    "withdrawalsRoot": "0x76c680232fb35d44a7ef17508ecf35c74b109bbf48ea0e454271a6158a082be5"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getBlockReceipts

eth_getBlockReceipts operations.

Get All Transaction Receipts for a Block

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get All Transaction Receipts for a Block

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

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

const data = await response.json();

import requests

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockNumber": "0xaa78d0",
      "contractAddress": null,
      "cumulativeGasUsed": "0x5208",
      "effectiveGasPrice": "0xccdb50ac",
      "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
      "gasUsed": "0x5208",
      "logs": [],
      "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
      "transactionHash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
      "transactionIndex": "0x0",
      "type": "0x0"
    },
    {
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockNumber": "0xaa78d0",
      "contractAddress": null,
      "cumulativeGasUsed": "0x288cc",
      "effectiveGasPrice": "0xb45bdac1",
      "from": "0x57ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
      "gasUsed": "0x236c4",
      "logs": [
        {
          "address": "0x7f57966c2c4af94bc95bd7803de2c24d4275ced6",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x00000000000000000000000057ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
            "0x000000000000000000000000611f9e9d8a0049322265e94ae8379e760ec431f4"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "blockNumber": "0xaa78d0",
          "transactionHash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
          "transactionIndex": "0x1",
          "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
          "blockTimestamp": "0x6a4399ac",
          "logIndex": "0x0",
          "removed": false
        },
        {
          "address": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
          "topics": [
            "0x1449c6dd7851abc30abf37f57715f492010519147cc2652fbc38202c18a6ee90",
            "0x00000000000000000000000057ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
            "0x0000000000000000000000000000000000000000000000000000000000000004"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "blockNumber": "0xaa78d0",
          "transactionHash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
          "transactionIndex": "0x1",
          "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
          "blockTimestamp": "0x6a4399ac",
          "logIndex": "0x1",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000000000000001000000002000000000000000000000000010000000000000000000020000000000000000000000000080000000000000000080000000100000000000000100000002000000000080000000028000000000000000000000000000000000000000010100000000000021000000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000020000004000000000000020000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
      "transactionHash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
      "transactionIndex": "0x1",
      "type": "0x2"
    },
    {
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockNumber": "0xaa78d0",
      "contractAddress": null,
      "cumulativeGasUsed": "0x4bf90",
      "effectiveGasPrice": "0xb45bdac1",
      "from": "0xbc753396cc214acc6c49ca28969d19e1a7d36730",
      "gasUsed": "0x236c4",
      "logs": [
        {
          "address": "0x7f57966c2c4af94bc95bd7803de2c24d4275ced6",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            "0x000000000000000000000000bc753396cc214acc6c49ca28969d19e1a7d36730",
            "0x000000000000000000000000611f9e9d8a0049322265e94ae8379e760ec431f4"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "blockNumber": "0xaa78d0",
          "transactionHash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
          "transactionIndex": "0x2",
          "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
          "blockTimestamp": "0x6a4399ac",
          "logIndex": "0x2",
          "removed": false
        },
        {
          "address": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
          "topics": [
            "0x1449c6dd7851abc30abf37f57715f492010519147cc2652fbc38202c18a6ee90",
            "0x000000000000000000000000bc753396cc214acc6c49ca28969d19e1a7d36730",
            "0x0000000000000000000000000000000000000000000000000000000000000004"
          ],
          "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
          "blockNumber": "0xaa78d0",
          "transactionHash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
          "transactionIndex": "0x2",
          "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
          "blockTimestamp": "0x6a4399ac",
          "logIndex": "0x3",
          "removed": false
        }
      ],
      "logsBloom": "0x000000000000000000000000000000000000000000000000001000000002000000000000000040000000010000000000000000000020000000000000000000000000080000000000000000080000000000000000000000100000002000000000080000000020000000000000000000000000000000000000000010100000000000001000000000000000000000000000000000000000000000000000100000000000400000000000000000000000000000000000000000000020000004000000000000020000000000000000000000400000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
      "status": "0x1",
      "to": "0x611f9e9d8a0049322265e94ae8379e760ec431f4",
      "transactionHash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
      "transactionIndex": "0x2",
      "type": "0x2"
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByHash operations.

Get Transaction Count by Block Hash

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Hash

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber operations.

Get Transaction Count by Block Number

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Number

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getCode

eth_getCode operations.

Get Contract Bytecode at Address

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Contract Bytecode at Address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getFilterChanges

eth_getFilterChanges operations.

Get Filter Changes

POST

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

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Changes

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

const response = await fetch('https://eth-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://eth-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": -32000,
    "message": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

eth_getFilterLogs

eth_getFilterLogs operations.

Get Filter Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Filter Logs

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

const response = await fetch('https://eth-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://eth-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": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "filter not found"
  }
}

eth_getLogs

eth_getLogs operations.

Get Logs

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Logs

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1b4",
        "toBlock": "0x1f4",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          [
            "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
            "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
          ]
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x1b4",
          "toBlock": "0x1f4",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            null,
            [
              "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
              "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
            ]
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x7f57966c2c4af94bc95bd7803de2c24d4275ced6",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x00000000000000000000000057ef1f0f7c3a9f51135d8d17dbbcf5ee2cadda20",
        "0x000000000000000000000000611f9e9d8a0049322265e94ae8379e760ec431f4"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "blockNumber": "0xaa78d0",
      "transactionHash": "0xdeeaeafccae3044329a48217ed1aa32e54dcb7c083a776c392451ee1e54dfdda",
      "transactionIndex": "0x1",
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockTimestamp": "0x6a4399ac",
      "logIndex": "0x0",
      "removed": false
    },
    {
      "address": "0x7f57966c2c4af94bc95bd7803de2c24d4275ced6",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x000000000000000000000000bc753396cc214acc6c49ca28969d19e1a7d36730",
        "0x000000000000000000000000611f9e9d8a0049322265e94ae8379e760ec431f4"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "blockNumber": "0xaa78d0",
      "transactionHash": "0xda947c82de26bdcd06a5f02437c9c81d6ca98e385cb90256ecef9d2649cd9335",
      "transactionIndex": "0x2",
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockTimestamp": "0x6a4399ac",
      "logIndex": "0x2",
      "removed": false
    },
    {
      "address": "0x7f57966c2c4af94bc95bd7803de2c24d4275ced6",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        "0x0000000000000000000000006685af44827cfd4c96e3f8dabc951b8593a60bc5",
        "0x000000000000000000000000611f9e9d8a0049322265e94ae8379e760ec431f4"
      ],
      "data": "0x0000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "blockNumber": "0xaa78d0",
      "transactionHash": "0xca2e293ad3606aa3a00bc91f5399231080d9cfeba4a28bdee1914ee48ae28728",
      "transactionIndex": "0x3",
      "blockHash": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
      "blockTimestamp": "0x6a4399ac",
      "logIndex": "0x4",
      "removed": false
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

eth_getStorageAt

eth_getStorageAt operations.

Get Storage At

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Storage At

curl -X POST 'https://eth-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://eth-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://eth-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": "0x0000000000000000000000000000000000000000000000000000000000000000"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockHashAndIndex operations.

Get Transaction by Block Hash and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Hash and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "blockNumber": "0xaa78d0",
    "blockTimestamp": "0x6a4399ac",
    "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
    "gas": "0x15f90",
    "gasPrice": "0xccdb50ac",
    "hash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
    "input": "0x",
    "nonce": "0x26f",
    "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
    "transactionIndex": "0x0",
    "value": "0x6d93ca6c63f0",
    "type": "0x0",
    "chainId": "0xaa36a7",
    "v": "0x1546d71",
    "r": "0x7cd3d987ac61a466220a4cef09e1227d5a53e4888f7f7128a0fe9c1640f7539e",
    "s": "0x7b9370120d693cbf2b9f3b7a7cf987fd72877066ed69801ad256852dd0eb5513"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByBlockNumberAndIndex operations.

Get Transaction by Block Number and Index

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Number and Index

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "blockNumber": "0xaa78d0",
    "blockTimestamp": "0x6a4399ac",
    "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
    "gas": "0x15f90",
    "gasPrice": "0xccdb50ac",
    "hash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
    "input": "0x",
    "nonce": "0x26f",
    "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
    "transactionIndex": "0x0",
    "value": "0x6d93ca6c63f0",
    "type": "0x0",
    "chainId": "0xaa36a7",
    "v": "0x1546d71",
    "r": "0x7cd3d987ac61a466220a4cef09e1227d5a53e4888f7f7128a0fe9c1640f7539e",
    "s": "0x7b9370120d693cbf2b9f3b7a7cf987fd72877066ed69801ad256852dd0eb5513"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getTransactionByHash

eth_getTransactionByHash operations.

Get transaction by hash

POST

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

Executes the eth_getTransactionByHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction by hash

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

const response = await fetch('https://eth-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://eth-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": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "blockNumber": "0xaa78d0",
    "blockTimestamp": "0x6a4399ac",
    "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
    "gas": "0x15f90",
    "gasPrice": "0xccdb50ac",
    "hash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
    "input": "0x",
    "nonce": "0x26f",
    "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
    "transactionIndex": "0x0",
    "value": "0x6d93ca6c63f0",
    "type": "0x0",
    "chainId": "0xaa36a7",
    "v": "0x1546d71",
    "r": "0x7cd3d987ac61a466220a4cef09e1227d5a53e4888f7f7128a0fe9c1640f7539e",
    "s": "0x7b9370120d693cbf2b9f3b7a7cf987fd72877066ed69801ad256852dd0eb5513"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getTransactionCount

eth_getTransactionCount operations.

Get transaction count (nonce) for address

POST

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

Executes the eth_getTransactionCount JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction count (nonce) for address

curl -X POST 'https://eth-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://eth-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://eth-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": "0x270"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_getTransactionReceipt

eth_getTransactionReceipt operations.

Get transaction receipt by hash

POST

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

Executes the eth_getTransactionReceipt JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get transaction receipt by hash

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4889464db49c4f8a2bb9efce57060faffaa6e2e2e442b0db3ae64469cd91d623",
    "blockNumber": "0xaa78d0",
    "contractAddress": null,
    "cumulativeGasUsed": "0x5208",
    "effectiveGasPrice": "0xccdb50ac",
    "from": "0xd1860679770b1ad818e041e3e26e3f3d6035b937",
    "gasUsed": "0x5208",
    "logs": [],
    "logsBloom": "0x000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000...truncated",
    "status": "0x1",
    "to": "0x2553b57b692ba0755b42c7a2bd02ca2196a1e73e",
    "transactionHash": "0x020039db9c3d44f42efffa453e5d88e028f6fc9fba015f3b320101d10f5bbff6",
    "transactionIndex": "0x0",
    "type": "0x0"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockHashAndIndex operations.

Get uncle block by block hash and index

POST

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

Executes the eth_getUncleByBlockHashAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block hash and index

curl -X POST 'https://eth-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://eth-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://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleByBlockNumberAndIndex

eth_getUncleByBlockNumberAndIndex operations.

Get uncle block by block number and index

POST

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

Executes the eth_getUncleByBlockNumberAndIndex JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get uncle block by block number and index

curl -X POST 'https://eth-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://eth-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://eth-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 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockHash operations.

Get the number of uncle blocks by block hash

POST

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

Executes the eth_getUncleCountByBlockHash JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block hash

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

const response = await fetch('https://eth-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://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Hash"
  }
}

eth_getUncleCountByBlockNumber

eth_getUncleCountByBlockNumber operations.

Get the number of uncle blocks by block number

POST

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

Executes the eth_getUncleCountByBlockNumber JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block number

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

const response = await fetch('https://eth-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://eth-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 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

eth_hashrate

eth_hashrate operations.

eth_hashrate

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_hashrate

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_hashrate does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_hashrate does not exist/is not available"
  }
}

eth_maxPriorityFeePerGas

eth_maxPriorityFeePerGas operations.

Get recommended maxPriorityFeePerGas value

POST

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

Executes the eth_maxPriorityFeePerGas JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Get recommended maxPriorityFeePerGas value

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

const response = await fetch('https://eth-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://eth-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": "0xf4240"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_mining

eth_mining operations.

eth_mining

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_mining

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

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

Request Body

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_mining does not exist/is not available"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32601,
    "message": "the method eth_mining does not exist/is not available"
  }
}

eth_newBlockFilter

eth_newBlockFilter operations.

Create a new block filter

POST

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

Executes the eth_newBlockFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new block filter

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

const response = await fetch('https://eth-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://eth-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": "0x10"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_newFilter

eth_newFilter operations.

Create a new log filter

POST

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

Executes the eth_newFilter JSON-RPC method on Ethereum through NOWNodes.

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

Ethereum address.

topicsArray<string | Array<string>> | null

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

Show child attributes

Topics item.

One of

Topics item.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a new log filter

curl -X POST 'https://eth-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://eth-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://eth-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": "0x11"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type filters.input"
  }
}

eth_newPendingTransactionFilter

eth_newPendingTransactionFilter operations.

Create a filter for pending transactions

POST

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

Executes the eth_newPendingTransactionFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Create a filter for pending transactions

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

const response = await fetch('https://eth-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://eth-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": "0x12"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type bool"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type bool"
  }
}

eth_sendRawTransaction

eth_sendRawTransaction operations.

Send a raw signed transaction

POST

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

Executes the eth_sendRawTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a raw signed transaction

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

eth_sendRawTransactionSync

eth_sendRawTransactionSync operations.

Send raw transaction (synchronous)

POST

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

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Body

application/json

Submit a signed raw transaction to the network and wait for transaction receipt synchronously. This method will block until the transaction is mined or timeout occurs.

Request payload for Send raw transaction (synchronous).

jsonrpcstring

JSON-RPC protocol version.

methodstring

JSON-RPC method name.

paramsArray<string>

Array containing one parameter - the signed transaction data in hex format (0x-prefixed)

idinteger

Client-provided request identifier echoed in the response.

Response

200OK

Successful response with transaction receipt. Returns the transaction receipt if the transaction was successfully mined.

400Bad Request

Invalid request or transaction data

401Unauthorized

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

405Method Not Allowed

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

422Unprocessable Entity

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

500Internal Server Error

Transaction execution failed

Authorization

api-keyAuthapiKey in header

Send raw transaction (synchronous)

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransactionSync",
  "params": [
    "0xf86c808504a817c800825208943535353535353535353535353535353535353535880de0b6b3a76400008025a028ef61340bd939bc2195fe537567866003e1a15d3c71ff63e1590620aa636276a067cbe9d8997f761aecb703304b3800ccf555c9f3dc64214b297fb1966a3b6d83"
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: hex string without 0x prefix"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32000,
    "message": "transaction failed: insufficient funds for gas * price + value"
  }
}

eth_sendTransaction

eth_sendTransaction operations.

Send a transaction using node-managed account

POST

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

Executes the eth_sendTransaction JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Send a transaction using node-managed account

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
        "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "gas": "0x5208",
        "gasPrice": "0x3b9aca00",
        "value": "0x16345785d8a0000",
        "data": "0x"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00",
          "value": "0x16345785d8a0000",
          "data": "0x"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x3333333333333333333333333333333333333333333333333333333333333333"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_sign

eth_sign operations.

Sign arbitrary data using eth_sign

POST

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

Executes the eth_sign JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Sign arbitrary data using eth_sign

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

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

const data = await response.json();

import requests

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

response = requests.post('https://eth-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": "0x4444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444444"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type common.Address"
  }
}

eth_signTransaction

eth_signTransaction operations.

eth_signTransaction

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

eth_signTransaction

curl -X POST 'https://eth-blockbook.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "value": "0xde0b6b3a7640000",
        "data": "0x",
        "nonce": "0x1",
        "chainId": 1
      }
    ],
    "id": 1
  }'

const response = await fetch('https://eth-blockbook.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
          "gas": "0x5208",
          "gasPrice": "0x4a817c800",
          "value": "0xde0b6b3a7640000",
          "data": "0x",
          "nonce": "0x1",
          "chainId": 1
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal string into Go value of type ethapi.TransactionArgs"
  }
}

eth_syncing

eth_syncing operations.

Check if node is syncing

POST

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

Executes the eth_syncing JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Check if node is syncing

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

eth_uninstallFilter

eth_uninstallFilter operations.

Uninstall an existing filter

POST

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

Executes the eth_uninstallFilter JSON-RPC method on Ethereum through NOWNodes.

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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

Uninstall an existing filter

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

const response = await fetch('https://eth-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://eth-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": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

net_listening

net_listening operations.

net_listening

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_listening

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

const response = await fetch('https://eth-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://eth-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": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

net_peerCount

net_peerCount operations.

net_peerCount

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_peerCount

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

const response = await fetch('https://eth-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://eth-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": "0x20"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

net_version

net_version operations.

net_version

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

net_version

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

const response = await fetch('https://eth-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://eth-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": "11155111"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

web3_clientVersion

web3_clientVersion operations.

web3_clientVersion

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_clientVersion

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

const response = await fetch('https://eth-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://eth-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.17.2-stable-be4dc0c4/linux-amd64/go1.25.7"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "too many arguments, want at most 0"
  }
}

web3_sha3

web3_sha3 operations.

web3_sha3

POST

https://eth-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

Upstream node or gateway error.

Authorization

api-keyAuthapiKey in header

web3_sha3

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

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

const data = await response.json();

import requests

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

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

Request Body

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"
  }
}

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

TESTNET / BlockBook

BlockBook

Response

Authorization

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization