BlockBook API

v1.0.0

Base URLs

https://ethw-blockbook.nownodes.io

https://xlayer.nownodes.io

Authentication

api-keyAuthapiKey

API Key: api-key in header

MAINNET / Blockbook

BlockBook

Get Blockbook backend info

GET

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

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

Response

200OK

Successfully retrieved Blockbook info

500Internal Server Error

Internal error

Authorization

api-keyAuthapiKey in header

Get Blockbook backend info

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Internal server error"
}

Get block hash by block height

GET

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

Returns the block hash corresponding to the specified block height.

Parameters

heightinteger>= 0requiredpath

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

Response

200OK

Successfully retrieved block hash

404Not Found

Block not found at given height

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block hash by block height

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

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

const data = await response.json();

import requests

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

{
  "blockHash": "00000000000000000004e6a25d5e8bb4d9b23f94b84f8e0cf4e2128c2b93a6b1"
}

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Get specific transaction details

GET

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

Returns full decoded transaction data for a given transaction ID.

Parameters

txidstringrequiredpath

Transaction ID (txid) to look up

Response

200OK

Successful response with transaction details

404Not Found

Transaction not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get specific transaction details

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Transaction not found"
}

{
  "error": "Internal server error"
}

Get address information

GET

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

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

Parameters

addressstringrequiredpath

Ethereum PoW address to query.

pageinteger1query

Page number for pagination (default is 1).

pageSizeinteger1000query

Number of items per page (default 1000).

fromintegerquery

Starting block height to filter transactions (optional).

tointegerquery

Ending block height to filter transactions (optional).

detailsstringbasictokenstokenBalancestxidstxsquery

Level of transaction detail to return. Options:

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

contractstringquery

Filter by contract address (optional).

secondarystringquery

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

Response

200OK

Successful response with address details

400Bad Request

Invalid address or bad request

404Not Found

Address not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get address information

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid address format"
}

{
  "error": "Address not found"
}

{
  "error": "Internal server error"
}

Get XPUB or descriptor details

GET

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

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

Parameters

xpubOrDescriptorstringrequiredpath

XPUB or descriptor to query.

pageinteger1query

Page number for pagination (default is 1).

pageSizeinteger1000query

Number of items per page (default 1000).

fromintegerquery

Starting block height to filter transactions (optional).

tointegerquery

Ending block height to filter transactions (optional).

detailsstringbasictokenstokenBalancestxidstxsquery

Level of transaction detail to return. Options:

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

tokensstringnonzerousedderivedquery

Filter tokens by usage type:

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

secondarystringquery

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

Response

200OK

Successful response with XPUB details

400Bad Request

Invalid XPUB or bad request

404Not Found

XPUB not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get XPUB or descriptor details

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid XPUB format"
}

{
  "error": "XPUB not found"
}

{
  "error": "Internal server error"
}

Get UTXOs for address, XPUB or descriptor

GET

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

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

Parameters

addressOrXpubOrDescriptorstringrequiredpath

Address, XPUB or descriptor to query UTXOs for.

confirmedbooleanfalsequery

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

Response

200OK

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

400Bad Request

Invalid address or parameter error

404Not Found

No UTXOs found for the specified input

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get UTXOs for address, XPUB or descriptor

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

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

const data = await response.json();

import requests

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

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

{
  "error": "Invalid address format"
}

{
  "error": "No UTXOs found"
}

{
  "error": "Internal server error"
}

Get block details by height or hash

GET

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

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

Parameters

blockHeightOrHashstringrequiredpath

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

Response

200OK

Block details response

400Bad Request

Invalid block height or hash format

404Not Found

Block not found

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get block details by height or hash

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

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

const data = await response.json();

import requests

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

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

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

{
  "error": "Block not found"
}

{
  "error": "Internal server error"
}

Broadcast raw transaction

GET

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

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

Parameters

hexTxDatastringrequiredpath

Hex-encoded raw transaction data to be broadcasted.

Response

200OK

Transaction broadcast successful

400Bad Request

Invalid transaction hex data

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Broadcast raw transaction

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

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

const data = await response.json();

import requests

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

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

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

{
  "error": "Internal server error"
}

Broadcast raw transaction

POST

https://ethw-blockbook.nownodes.io/api/v2/sendtx

Broadcasts a signed raw transaction. The transaction must be properly signed and serialized in hex format.

Body

application/json

rawtxstringrequired

Signed raw transaction in hexadecimal format. The transaction must be fully signed and include all necessary inputs and outputs.

Response

200OK

Transaction successfully broadcasted

400Bad Request

Bad request - invalid transaction data

500Internal Server Error

Internal server error or network issue

Authorization

api-keyAuthapiKey in header

Broadcast raw transaction

curl -X POST 'https://ethw-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: application/json' \
  -d '{
    "rawtx": "0200000000010127d6b825e25c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0100000000ffffffff0200e1f5050000000017a9147b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c8700000000000000001976a914a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c788ac02483045022100a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c02200a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b012103a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c00000000"
  }'

const response = await fetch('https://ethw-blockbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "rawtx": "0200000000010127d6b825e25c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0100000000ffffffff0200e1f5050000000017a9147b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c8700000000000000001976a914a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c788ac02483045022100a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c02200a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b012103a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c00000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "rawtx": "0200000000010127d6b825e25c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0100000000ffffffff0200e1f5050000000017a9147b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c8700000000000000001976a914a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c788ac02483045022100a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c02200a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b012103a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c00000000"
}

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

Request Body

{
  "rawtx": "0200000000010127d6b825e25c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0c5c0100000000ffffffff0200e1f5050000000017a9147b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c8700000000000000001976a914a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c788ac02483045022100a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c02200a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b012103a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c00000000"
}

{
  "result": "a5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c7b5c"
}

{
  "error": "Transaction decode failed",
  "code": 400
}

{
  "error": "Transaction rejected by network",
  "code": 500
}

Get list of tickers updated since timestamp

GET

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

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

Parameters

timestampintegerquery

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

Response

200OK

Available currencies and timestamp

400Bad Request

Invalid timestamp parameter

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get list of tickers updated since timestamp

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

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

const data = await response.json();

import requests

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

{
  "ts": 1730678400,
  "available_currencies": [
    "aed",
    "ars",
    "aud",
    "bch",
    "bdt",
    "bhd",
    "bits",
    "bmd",
    "bnb",
    "brl",
    "btc",
    "cad",
    "chf",
    "clp",
    "cny",
    "czk",
    "dkk",
    "dot",
    "eos",
    "eth",
    "eur",
    "gbp",
    "gel",
    "hkd",
    "huf",
    "idr",
    "ils",
    "inr",
    "jpy",
    "krw",
    "kwd",
    "link",
    "lkr",
    "ltc",
    "mmk",
    "mxn",
    "myr",
    "ngn",
    "nok",
    "nzd",
    "php",
    "pkr",
    "pln",
    "rub",
    "sar",
    "sats",
    "sek",
    "sgd",
    "sol",
    "thb",
    "try",
    "twd",
    "uah",
    "usd",
    "vef",
    "vnd",
    "xag",
    "xau",
    "xdr",
    "xlm",
    "xrp",
    "yfi",
    "zar"
  ]
}

{
  "error": "Invalid timestamp parameter"
}

{
  "error": "Internal server error"
}

Get balance history for an address or XPUB

GET

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

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

Parameters

accountstringrequiredpath

XPUB or address to query balance history for

fromstring<date-time>requiredquery

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

tostring<date-time>requiredquery

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

fiatcurrencystringquery

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

groupByintegerquery

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

Response

200OK

Balance history retrieved successfully

400Bad Request

Invalid or missing parameters

500Internal Server Error

Internal server error

Authorization

api-keyAuthapiKey in header

Get balance history for an address or XPUB

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

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

const data = await response.json();

import requests

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

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

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

{
  "error": "Internal server error"
}

MAINNET / DEBUG

debug_getRawBlock

Debug method - debug_getRawBlock

POST

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

Returns an RLP-encoded block. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsArray<string | string>required

Array containing the block identifier parameter.

Show child attributes

One of

Block number as a hex string (e.g., "0x10d4f")

string

Block tag (e.g., "latest", "earliest", "pending")

string

idintegerrequired

A unique ID for the request

Response

200OK

The RLP-encoded block data

Authorization

api-keyAuthapiKey in header

Debug method - debug_getRawBlock

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_getRawBlock",
  "params": [
    "latest"
  ],
  "id": 0
}

200

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0xf90219a0..."
}

debug_getRawHeader

Debug method - debug_getRawHeader

POST

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

Returns an RLP-encoded header. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsArray<string>required

Array containing the block identifier parameter.

Show child attributes

One of

Block number as a hex string (e.g., "0x10d4f") or block tag

string

idintegerrequired

A unique ID for the request

Response

200OK

The RLP-encoded header data

Authorization

api-keyAuthapiKey in header

Debug method - debug_getRawHeader

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_getRawHeader",
  "params": [
    "latest"
  ],
  "id": 0
}

200

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0xf90211a0..."
}

debug_getRawReceipts

Debug method - debug_getRawReceipts

POST

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

Returns an array of EIP-2718 binary-encoded receipts. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsArray<string>required

Array containing the block identifier parameter.

Show child attributes

One of

Block number as a hex string (e.g., "0x10d4f") or block tag

string

idintegerrequired

A unique ID for the request

Response

200OK

An array of EIP-2718 binary-encoded receipts

Authorization

api-keyAuthapiKey in header

Debug method - debug_getRawReceipts

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

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

const data = await response.json();

import requests

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

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_getRawReceipts",
  "params": [
    "latest"
  ],
  "id": 0
}

200

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": [
    "0x02f873...",
    "0x02f874..."
  ]
}

debug_getRawTransaction

Debug method - debug_getRawTransaction

POST

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

Returns an EIP-2718 binary-encoded transaction. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsArray<string>required

Array containing the transaction hash parameter.

idintegerrequired

A unique ID for the request

Response

200OK

The EIP-2718 binary-encoded transaction

Authorization

api-keyAuthapiKey in header

Debug method - debug_getRawTransaction

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

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

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "debug_getRawTransaction",
  "params": [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
  ],
  "id": 0
}

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

Request Body

{
  "jsonrpc": "2.0",
  "method": "debug_getRawTransaction",
  "params": [
    "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
  ],
  "id": 0
}

200

{
  "jsonrpc": "2.0",
  "id": 0,
  "result": "0x02f872..."
}

debug_traceCall

Trace call execution

POST

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

Returns the number of possible tracing result by executing an eth call within the context of the given block execution. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | string>required

Show child attributes

Any of

object

string

idintegerrequired

Response

200OK

Call execution trace

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace call execution

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "failed": false,
    "gas": 24034,
    "returnValue": "0000000000000000000000000000000000000000000000000858898f93629000",
    "structLogs": [
      {
        "pc": 0,
        "op": "PUSH1",
        "gas": 599978568,
        "gasCost": 3,
        "depth": 1,
        "error": "string",
        "stack": [
          "string"
        ],
        "memory": [
          "string"
        ],
        "storage": {},
        "refund": 0
      }
    ]
  }
}

debug_traceTransaction

Trace transaction execution

POST

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

Returns all traces of a given transaction. Kindly note that this method can be used starting from block 42810022.

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string | object>required

Show child attributes

Any of

string

object

idintegerrequired

Response

200OK

Transaction execution trace

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Authorization

api-keyAuthapiKey in header

Trace transaction execution

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "type": "CALL",
    "from": "0x688c1de81ce07a698679928ae319bbe503da1a5d",
    "to": "0xf15176bc2a8d95102e21641fc0c3b1a9990d2d2d",
    "value": "0x0",
    "gas": "0x226c9",
    "gasUsed": "0x1a529",
    "input": "0xaea01419000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000b7180b07bd1906c59af640bd8eeab367b7594f9af0fc90ecd5ebe7c0a1be8a4e536f3393fd943b12745241929d83318675e662c725c1ede53fcb3b8396277bf617b5839bd4d6e005d4dda81701f87378e34cb9cbd113c435db0c10ac07f2465579615210131a0c66381308e606e3b6da4a360285b8865010f14d3c3f92aa9043d6d48b0e6493b6b63887c0fbfe88c48d280c01cbf4df2a77a7221536436b02c0382ab5368bb19710ec9ba7bf6375faf6d4936e21152556361682e63b083f0b61402ac2171cc082861c603adf7e26abfc9c196e8fe07491088f1a887a8e2124e90f9b26afe29ac9f0c44594eb6ad83ce13fc4362fb86cd71e5d8133548a9ed2165d90a60b7959951ce31ebe733f8e648987339c66246b7dcab61eae5c6f95604a2133af90e4ee678878c0c249c07e4f3159c5e7bef52a67baf54e075715cc39b4795940b8f2632eabc4a68d61d83c4ed2a4b4a2a1d80da98ee8a74a0d497924866",
    "output": "string",
    "error": "string",
    "revertReason": "string",
    "calls": [
      {}
    ]
  }
}

MAINNET / EVM

eth_accounts

Ethereum method - eth_accounts

POST

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

Returns an array of addresses controlled by the client.

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_accounts

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

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

Request Body

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

200

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

eth_blockNumber

Ethereum method - eth_blockNumber

POST

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

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_blockNumber

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

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

Request Body

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

200

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

eth_call

Ethereum method - eth_call

POST

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

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<object | string>required

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

Show child attributes

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

Response

200OK

Result of the call

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_call

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

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

eth_chainId

Ethereum method - eth_chainId

POST

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

Returns the hexadecimal string of the current chain ID.

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Ethereum method - eth_chainId

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

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

Request Body

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

200

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

eth_estimateGas

Estimate Gas for Transaction

POST

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

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

Body

application/json

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

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

Authorization

api-keyAuthapiKey in header

Estimate Gas for Transaction

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

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

eth_feeHistory

POST

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

jsonrpcstringrequired

methodstringrequired

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

Any of

string

integer

Array<number>

idintegerrequired

Response

200OK

JSON-RPC Response with fee history data

Authorization

api-keyAuthapiKey in header

eth_feeHistory

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x10d4f",
    "baseFeePerGas": [
      "0x1dcd65000"
    ],
    "gasUsedRatio": [
      0.85
    ],
    "reward": [
      [
        "0x59682f00"
      ]
    ]
  }
}

eth_gasPrice

Get Suggested Gas Price

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Suggested Gas Price

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

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

Request Body

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

200

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

eth_getBalance

Get ETH Balance of an Address

POST

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

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

Authorization

api-keyAuthapiKey in header

Get ETH Balance of an Address

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

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

eth_getBlockByHash

Get Block by Hash

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Block by Hash

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79",
    "parentHash": "0x5e8d5f58b0c1be8c3a3d172a41f9f4e35f2f15d5b3347f17a6c11a3aeadf9c10",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9e7a6ccfbcc2fdb5d98a9fdb716e0df485b4d39a5a6f85ebd",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x829BD824B016326A401d083B33D092293333A830",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": [
      "0x9f1c04b814a153e1b9f11b60d4e0f9349d07f9251e9b7b60aebb21721c8c07d7"
    ],
    "uncles": [
      "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    ]
  }
}

eth_getBlockByNumber

Get Block by Number

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Block by Number

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x1b4",
    "hash": "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79",
    "parentHash": "0x5e8d5f58b0c1be8c3a3d172a41f9f4e35f2f15d5b3347f17a6c11a3aeadf9c10",
    "nonce": "0x0000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "logsBloom": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "stateRoot": "0xd7f8974fb5ac78d9e7a6ccfbcc2fdb5d98a9fdb716e0df485b4d39a5a6f85ebd",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "miner": "0x829BD824B016326A401d083B33D092293333A830",
    "difficulty": "0x027f07",
    "totalDifficulty": "0x027f07",
    "extraData": "0x",
    "size": "0x027f07",
    "gasLimit": "0x9f759",
    "gasUsed": "0x9f759",
    "timestamp": "0x54e34e8e",
    "transactions": [
      "0x9f1c04b814a153e1b9f11b60d4e0f9349d07f9251e9b7b60aebb21721c8c07d7"
    ],
    "uncles": [
      "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347"
    ]
  }
}

eth_getBlockReceipts

Get All Transaction Receipts for a Block

POST

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

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

Authorization

api-keyAuthapiKey in header

Get All Transaction Receipts for a Block

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "transactionHash": "0x5f4e3b4f5c4c4a6a93c2a3c9d1f47ee7e54b1f4e8a8e0cfd3aabb8a7a8295f7a",
      "transactionIndex": "0x1",
      "blockHash": "0xabc123def456...",
      "blockNumber": "0x10d4f",
      "from": "0x1234567890abcdef1234567890abcdef12345678",
      "to": "0xabcdefabcdefabcdefabcdefabcdefabcdef",
      "cumulativeGasUsed": "0x5208",
      "gasUsed": "0x5208",
      "contractAddress": "0xcontractaddresshere",
      "logs": [
        {
          "removed": false,
          "logIndex": "0x0",
          "transactionIndex": "0x1",
          "transactionHash": "0x5f4e3b4f5c4c4a6a93c2a3c9d1f47ee7e54b1f4e8a8e0cfd3aabb8a7a8295f7a",
          "blockHash": "0xabc123def456...",
          "blockNumber": "0x10d4f",
          "address": "0xcontractaddresshere",
          "data": "0x0000000000000000000000000000000000000000000000000000000000000000",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
          ]
        }
      ],
      "status": "0x1",
      "root": "0x..."
    }
  ]
}

eth_getBlockTransactionCountByHash

Get Transaction Count by Block Hash

POST

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

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Hash

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

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

Request Body

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

200

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

eth_getBlockTransactionCountByNumber

Get Transaction Count by Block Number

POST

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

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Get Transaction Count by Block Number

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

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

Request Body

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

200

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

eth_getCode

Get Contract Bytecode at Address

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Contract Bytecode at Address

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

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

eth_getFilterChanges

Get Filter Changes

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Filter Changes

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getFilterLogs

Get Filter Logs

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Filter Logs

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getLogs

Get Logs

POST

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

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

Authorization

api-keyAuthapiKey in header

Get Logs

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef"
      ],
      "data": "0x000000000000000000000000000000000000000000000000000000000000003e8",
      "blockNumber": "0x1b4",
      "transactionHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "transactionIndex": "0x0",
      "blockHash": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "logIndex": "0x0",
      "removed": false
    }
  ]
}

eth_getStorageAt

Get Storage At

POST

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

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Get Storage At

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

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

eth_getTransactionByBlockHashAndIndex

Get Transaction by Block Hash and Index

POST

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

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Parameters:

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

idintegerrequired

Response

200OK

A transaction object or null if no transaction was found.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Hash and Index

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "hash": "0x3f1c...",
    "input": "0x",
    "nonce": "0x15",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "transactionIndex": "0x0",
    "value": "0x7f110",
    "type": "0x0"
  }
}

eth_getTransactionByBlockNumberAndIndex

Get Transaction by Block Number and Index

POST

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

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Parameters:

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

idintegerrequired

Response

200OK

A transaction object, or null if not found.

Authorization

api-keyAuthapiKey in header

Get Transaction by Block Number and Index

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72",
    "nonce": "0x15",
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "transactionIndex": "0x0",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "value": "0x7f110",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "input": "0x",
    "type": "0x0"
  }
}

eth_getTransactionByHash

Get transaction by hash

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

Array containing a single transaction hash

idintegerrequired

Response

200OK

Transaction object or null

Authorization

api-keyAuthapiKey in header

Get transaction by hash

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "hash": "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72",
    "nonce": "0x15",
    "blockHash": "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "blockNumber": "0x5daf3b",
    "transactionIndex": "0x0",
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0x85h1c2d44cf8531a24b1030f78134677856f7b9f",
    "value": "0x7f110",
    "gas": "0x5208",
    "gasPrice": "0x4a817c800",
    "input": "0x",
    "type": "0x0"
  }
}

eth_getTransactionCount

Get transaction count (nonce) for address

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

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

idintegerrequired

Response

200OK

Hex encoded nonce (transaction count)

Authorization

api-keyAuthapiKey in header

Get transaction count (nonce) for address

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

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

eth_getTransactionReceipt

Get transaction receipt by hash

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Transaction receipt if mined, otherwise null

Authorization

api-keyAuthapiKey in header

Get transaction receipt by hash

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "transactionHash": "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7",
    "transactionIndex": "0x0",
    "blockHash": "0x9b559a...",
    "blockNumber": "0x5daf3b",
    "from": "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "to": "0x53d284357ec70ce289d6d64134dfac8e511c8a3d",
    "cumulativeGasUsed": "0x5208",
    "gasUsed": "0x5208",
    "contractAddress": null,
    "logs": [],
    "logsBloom": "0x000...",
    "status": "0x1"
  }
}

eth_getUncleByBlockHashAndIndex

Get uncle block by block hash and index

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

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

idintegerrequired

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

Get uncle block by block hash and index

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x5daf3c",
    "hash": "0xabc123...",
    "parentHash": "0xdef456...",
    "miner": "0x1234567890abcdef1234567890abcdef12345678",
    "difficulty": "0x3e8",
    "totalDifficulty": "0x1d4c",
    "extraData": "0x",
    "size": "0x220",
    "gasLimit": "0x7a1200",
    "gasUsed": "0x5208",
    "timestamp": "0x5bad55",
    "transactions": []
  }
}

eth_getUncleByBlockNumberAndIndex

Get uncle block by block number and index

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

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

Response

200OK

Uncle block object or null

Authorization

api-keyAuthapiKey in header

Get uncle block by block number and index

curl -X POST 'https://ethw-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://ethw-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://ethw-blockbook.nownodes.io/', json=payload)
data = response.json()

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "number": "0x5daf3c",
    "hash": "0xabc123abc123abc123abc123abc123abc123abc123abc123abc123abc123abc1",
    "parentHash": "0xdef456def456def456def456def456def456def456def456def456def456def4",
    "miner": "0x1234567890abcdef1234567890abcdef12345678",
    "difficulty": "0x3e8",
    "totalDifficulty": "0x1d4c",
    "extraData": "0x",
    "size": "0x220",
    "gasLimit": "0x7a1200",
    "gasUsed": "0x5208",
    "timestamp": "0x5bad55",
    "transactions": []
  }
}

eth_getUncleCountByBlockHash

Get the number of uncle blocks by block hash

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

An array containing the block hash.

idintegerrequired

Response

200OK

Number of uncles in the block

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block hash

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

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

Request Body

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

200

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

eth_getUncleCountByBlockNumber

Get the number of uncle blocks by block number

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

An array containing the block number as a hex string.

idintegerrequired

Response

200OK

Number of uncle blocks in the block

Authorization

api-keyAuthapiKey in header

Get the number of uncle blocks by block number

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

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

Request Body

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

200

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

eth_hashrate

POST

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

Returns the current mining hashrate reported by the client.

Body

application/json

jsonrpcstringrequired

methodstringeth_hashraterequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current mining hashrate

Authorization

api-keyAuthapiKey in header

eth_hashrate

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

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

Request Body

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

200

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

eth_maxPriorityFeePerGas

Get recommended maxPriorityFeePerGas value

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsarrayrequired

No parameters are required.

idintegerrequired

Response

200OK

Returns the suggested maxPriorityFeePerGas value

Authorization

api-keyAuthapiKey in header

Get recommended maxPriorityFeePerGas value

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

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

Request Body

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

200

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

eth_newBlockFilter

Create a new block filter

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<any>required

This method does not require any parameters.

idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

Create a new block filter

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

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

Request Body

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

200

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

eth_newFilter

Create a new log filter

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

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

topicsArray<string | Array<string>> | null

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

Show child attributes

One of

string

Array<string>

idintegerrequired

Response

200OK

Filter ID created successfully

Authorization

api-keyAuthapiKey in header

Create a new log filter

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

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

eth_newPendingTransactionFilter

Create a filter for pending transactions

POST

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Create a filter for pending transactions

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

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

Request Body

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

200

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

eth_sendRawTransaction

Send a raw signed transaction

POST

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

Body

application/json

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

Authorization

api-keyAuthapiKey in header

Send a raw signed transaction

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

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

Request Body

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

200

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

eth_sendTransaction

Send a transaction using node-managed account

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

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

Response

200OK

Transaction successfully sent

Authorization

api-keyAuthapiKey in header

Send a transaction using node-managed account

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

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

eth_sign

Sign arbitrary data using eth_sign

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

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

Response

200OK

Returns the signature of the message

Authorization

api-keyAuthapiKey in header

Sign arbitrary data using eth_sign

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

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

const data = await response.json();

import requests

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

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

Request Body

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

200

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

eth_signTransaction

POST

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

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

Body

application/json

jsonrpcstringrequired

methodstringeth_signTransactionrequired

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

Response

200OK

JSON-RPC response with the signed transaction data

Authorization

api-keyAuthapiKey in header

eth_signTransaction

curl -X POST 'https://ethw-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://ethw-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://ethw-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
}

200

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

eth_syncing

Check if node is syncing

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsarrayrequired

Must be an empty array.

idintegerrequired

Response

200OK

Returns sync status object or false

Authorization

api-keyAuthapiKey in header

Check if node is syncing

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

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

Request Body

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

200

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "startingBlock": "0x384",
    "currentBlock": "0x386",
    "highestBlock": "0x454"
  }
}

eth_uninstallFilter

Uninstall an existing filter

POST

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

Body

application/json

jsonrpcstringrequired

methodstringrequired

paramsArray<string>required

idintegerrequired

Response

200OK

Success or failure of the uninstall operation

Authorization

api-keyAuthapiKey in header

Uninstall an existing filter

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

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

Request Body

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

200

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

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

net_listening

POST

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

Checks if the client is listening for network connections.

Body

application/json

jsonrpcstringrequired

methodstringnet_listeningrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with listening status

Authorization

api-keyAuthapiKey in header

net_listening

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

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

Request Body

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

200

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

net_peerCount

POST

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

Returns the number of peers currently connected to the client.

Body

application/json

jsonrpcstringrequired

methodstringnet_peerCountrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the number of connected peers

Authorization

api-keyAuthapiKey in header

net_peerCount

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

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

Request Body

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

200

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

net_version

POST

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

Returns the current network ID of the Ethereum client.

Body

application/json

jsonrpcstringrequired

methodstringnet_versionrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the current network ID

Authorization

api-keyAuthapiKey in header

net_version

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

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

Request Body

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

200

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

web3_clientVersion

POST

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

Returns the current Ethereum client version.

Body

application/json

jsonrpcstringrequired

methodstringweb3_clientVersionrequired

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Response

200OK

JSON-RPC response with the client version string

Authorization

api-keyAuthapiKey in header

web3_clientVersion

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

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

Request Body

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

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "Geth/v1.10.8-stable-26675454/linux-amd64/go1.16.6"
}

web3_sha3

POST

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

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

Body

application/json

jsonrpcstringrequired

methodstringweb3_sha3required

paramsArray<string>required

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

idintegerrequired

Response

200OK

JSON-RPC response with the Keccak-256 hash of the input data

Authorization

api-keyAuthapiKey in header

web3_sha3

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

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

Request Body

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

200

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

Documentation

Authentication

MAINNET / Blockbook

BlockBook

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

MAINNET / DEBUG

debug_getRawBlock

Body

Response

Authorization

debug_getRawHeader

Body

Response

Authorization

debug_getRawReceipts

Body

Response

Authorization

debug_getRawTransaction

Body

Response

Authorization

debug_traceCall

Body

Response

Authorization

debug_traceTransaction

Body

Response

Authorization

MAINNET / EVM

eth_accounts

Body

Response

Authorization

eth_blockNumber

Body

Response

Authorization

eth_call

Body

Response

Authorization

eth_chainId

Body

Response

Authorization

eth_estimateGas

Body