Home

Ethereum Blockbook WSS 0.6.0

Get Info

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"1","method":"getInfo","params":{}}

Response: 200

Copied! 
{
    "id": "1",
    "data": {
        "name": "Ethereum",
        "shortcut": "ETH",
        "network": "ETH",
        "decimals": 18,
        "version": "0.6.0",
        "bestHeight": 25710276,
        "bestHash": "0x01b66f62e1a174e57de034d726c0518dd285d5c14d53adac8cac7986d26dc37b",
        "block0Hash": "0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3",
        "testnet": false,
        "backend": {
            "version": "Geth/v1.17.5-stable-9621c6ad/linux-amd64/go1.25.12"
        }
    }
}

Ping

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"2","method":"ping","params":{}}

Response: 200

Copied! 
{
    "id": "2",
    "data": {}
}

Get block hash

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"3","method":"getBlockHash","params":{"height":25000000}}

Response: 200

Copied! 
{
    "id": "3",
    "data": {
        "hash": "0xf398976165ca4756c77fc6b61111fa1102d431eb03082417ecce38b36308d728"
    }
}

Get account info

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "4",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0x861B462812299D758a88Cad79AFdBe187Dc5AF4F",
    "details": "basic"
  }
}

Response: 200

Copied! 
{
    "id": "4",
    "data": {
        "address": "0x861B462812299D758a88Cad79AFdBe187Dc5AF4F",
        "balance": "1441306895569971",
        "unconfirmedTxs": 0,
        "txs": 235,
        "nonTokenTxs": 147,
        "nonce": "14"
    }
}

Get account UTXO

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "5",
  "method": "getAccountUtxo",
  "params": {
    "descriptor": "0x861B462812299D758a88Cad79AFdBe187Dc5AF4F"
  }
}

Response: 200

Copied! 
{
    "id": "5",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Get balance history

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "6",
  "method": "getBalanceHistory",
  "params": {
    "descriptor": "0x861B462812299D758a88Cad79AFdBe187Dc5AF4F",
    "from": 1578391200,
    "to": 1578488400
  }
}

Response: 200

Copied! 
{
    "id": "6",
    "data": []
}

Get transaction

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "7",
  "method": "getTransaction",
  "params": {
    "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc"
  }
}

Response: 200

Copied! 
{
    "id": "7",
    "data": {
        "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc",
        "vin": [
            {
                "n": 0,
                "addresses": [
                    "0xc917c3fa468f2c4B9c84C72caA46420eb9825249"
                ],
                "isAddress": true
            }
        ],
        "vout": [
            {
                "value": "0",
                "n": 0,
                "addresses": [
                    "0x0000000aa232009084Bd71A5797d089AA4Edfad4"
                ],
                "isAddress": true
            }
        ],
        "blockHash": "0xf9a4df322bd51ccaec6e0f3b70ee707314e087882d35cf3805003f3652d0d912",
        "blockHeight": 25529946,
        "confirmations": 180332,
        "blockTime": 1784020823,
        "value": "0",
        "fees": "20945985792600",
        "tokenTransfers": [
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0x000000000004444c5dc75cB358380D2e3dE08A90",
                "to": "0x0000000aa232009084Bd71A5797d089AA4Edfad4",
                "contract": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
                "name": "Wrapped Ether",
                "symbol": "WETH",
                "decimals": 18,
                "value": "17383622202419060"
            },
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0x0000000aa232009084Bd71A5797d089AA4Edfad4",
                "to": "0x000000000004444c5dc75cB358380D2e3dE08A90",
                "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "name": "Tether USD",
                "symbol": "USDT",
                "decimals": 6,
                "value": "31087726"
            }
        ],
        "ethereumSpecific": {
            "status": 1,
            "nonce": 76341,
            "gasLimit": 352962,
            "gasUsed": 150600,
            "gasPrice": "139083571",
            "effectiveGasPrice": "139083571",
            "maxFeePerGas": "278783678",
            "baseFeePerGas": "139083571",
            "data": "0x09c5eabe00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000174000088c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000084a90530000000000000000003dc24ff248e77400000000000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001da5c6e00002600000001000100000000000000000000000000000000000000000000000018d175cff0b83f2e00003302000000000000000000000000000001da5c6e00000000000000000000000cda5210a80000000000000000031bcf5da3d04d1e0000840900000000000000000000000001da5c6e0000000000000000003dc24317f6d6cc000000000000000000000000084a9053000000000000000000000000084a905300001c991c7568b8501d65ec7a8cf60c45f71be30404f75d9fb8f1c05c1abdcb766cda65f4392644ce479da91585c3637c5c1eef3057b57effd96cb2328a3518272a0f000000000000000000000000000000",
            "parsedData": {
                "methodId": "0x09c5eabe",
                "name": ""
            }
        }
    }
}

Get transaction specific

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "8",
  "method": "getTransactionSpecific",
  "params": {
    "txid": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc"
  }
}

Response: 200

Copied! 
{
    "id": "8",
    "data": {
        "tx": {
            "nonce": "0x12a35",
            "gasPrice": "0x84a3f33",
            "maxPriorityFeePerGas": "0x0",
            "maxFeePerGas": "0x109de6be",
            "baseFeePerGas": "0x84a3f33",
            "gas": "0x562c2",
            "to": "0x0000000aa232009084Bd71A5797d089AA4Edfad4",
            "value": "0x0",
            "input": "0x09c5eabe00000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000174000088c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000084a90530000000000000000003dc24ff248e77400000000000000000000000000000000dac17f958d2ee523a2206206994597c13d831ec7000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001da5c6e00002600000001000100000000000000000000000000000000000000000000000018d175cff0b83f2e00003302000000000000000000000000000001da5c6e00000000000000000000000cda5210a80000000000000000031bcf5da3d04d1e0000840900000000000000000000000001da5c6e0000000000000000003dc24317f6d6cc000000000000000000000000084a9053000000000000000000000000084a905300001c991c7568b8501d65ec7a8cf60c45f71be30404f75d9fb8f1c05c1abdcb766cda65f4392644ce479da91585c3637c5c1eef3057b57effd96cb2328a3518272a0f000000000000000000000000000000",
            "hash": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc",
            "blockNumber": "0x1858e5a",
            "blockHash": "0xf9a4df322bd51ccaec6e0f3b70ee707314e087882d35cf3805003f3652d0d912",
            "from": "0xc917c3fa468f2c4B9c84C72caA46420eb9825249",
            "transactionIndex": "0x0"
        },
        "receipt": {
            "gasUsed": "0x24c48",
            "effectiveGasPrice": "0x84a3f33",
            "status": "0x1",
            "logs": [
                {
                    "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x000000000000000000000000000000000004444c5dc75cb358380d2e3de08a90"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000000003dc24ff248e774"
                },
                {
                    "address": "0x000000000004444c5dc75cB358380D2e3dE08A90",
                    "topics": [
                        "0x40e9cecb9f5f1f1c5b9c97dec2917b7ee92e57ba5563708daca94dd84ad7112f",
                        "0x90078845bceb849b171873cfbc92db8540e9c803ff57d9d21b1215ec158e79b3"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000000003dc24ff248e774fffffffffffffffffffffffffffffffffffffffffffffffffffffffffe25a39200000000000000000000000000000000000000000002c57ce245db5608ffc00a000000000000000000000000000000000000000000000000031bcf5da3d04d1efffffffffffffffffffffffffffffffffffffffffffffffffffffffffffced2a0000000000000000000000000000000000000000000000000000000000000000"
                }
            ]
        }
    }
}

Estimate fee

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"9","method":"estimateFee","params":{"blocks":[2,6]}}

Response: 200

Copied! 
{
    "id": "9",
    "data": [
        {
            "feePerTx": "2267291947401",
            "feePerUnit": "42148457",
            "feeLimit": "53793"
        },
        {
            "feePerTx": "2267291947401",
            "feePerUnit": "42148457",
            "feeLimit": "53793"
        }
    ]
}

Get long term fee rate

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"10","method":"longTermFeeRate","params":{}}

Response: 200

Copied! 
{
    "id": "10",
    "data": {
        "error": {
            "message": "not supported"
        }
    }
}

Get block filter

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "11",
  "method": "getBlockFilter",
  "params": {
    "scriptType": "",
    "blockHash": "f398976165ca4756c77fc6b61111fa1102d431eb03082417ecce38b36308d728"
  }
}

Response: 200

Copied! 
{
    "id": "11",
    "data": {
        "P": 0,
        "M": 1,
        "zeroedKey": false,
        "blockFilter": ""
    }
}

Compact block filters are not built on this endpoint, so blockFilter comes back empty and P is 0. Send scriptType empty, as no script type is configured.

Get mempool filters

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"12","method":"getMempoolFilters","params":{"scriptType":"","mempool":true}}

Response: 200

Copied! 
{
    "id": "12",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Mempool filters are not built on this endpoint, so entries comes back empty.

Send transaction

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"13","method":"sendTransaction","params":{"hex":"<signed raw transaction hex>"}}

Response: 200

Copied! 
{
    "id": "13",
    "data": {
        "result": "0xb5c7d2040134aa8c7d54dafb9c88258c9e2acd2ea25d883dab9884756052bbdc"
    }
}

A transaction the backend rejects returns an error object instead, for example {"id": "13", "data": {"error": {"message": "invalid argument 0: json: cannot unmarshal hex string without 0x prefix into Go value of type hexutil.Bytes"}}}.

Get fiat rates for timestamps

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "14",
  "method": "getFiatRatesForTimestamps",
  "params": {
    "timestamps": [
      1578391200
    ],
    "currencies": [
      "usd"
    ]
  }
}

Response: 200

Copied! 
{
    "id": "14",
    "data": {
        "tickers": [
            {
                "ts": 1746835200,
                "rates": {
                    "usd": 2341.408
                }
            }
        ]
    }
}

Get fiat rates for tickers list

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"15","method":"getFiatRatesTickersList","params":{"timestamp":1578391200}}

Response: 200

Copied! 
{
    "id": "15",
    "data": {
        "ts": 1746835200,
        "available_currencies": [
            "aed",
            "ars"
        ]
    }
}

Get current fiat rates

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"16","method":"getCurrentFiatRates","params":{"currencies":["usd"]}}

Response: 200

Copied! 
{
    "id": "16",
    "data": {
        "ts": 1786192502,
        "rates": {
            "usd": 1918.72
        }
    }
}

Subscribe new block

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"17","method":"subscribeNewBlock","params":{}}

Response: 200

Copied! 
{
    "id": "17",
    "data": {
        "subscribed": true
    }
}

Unsubscribe new block

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"18","method":"unsubscribeNewBlock","params":{}}

Response: 200

Copied! 
{
    "id": "18",
    "data": {
        "subscribed": false
    }
}

Subscribe new transaction

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"19","method":"subscribeNewTransaction","params":{}}

Response: 200

Copied! 
{
    "id": "19",
    "data": {
        "subscribed": true
    }
}

Unsubscribe new transaction

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"20","method":"unsubscribeNewTransaction","params":{}}

Response: 200

Copied! 
{
    "id": "20",
    "data": {
        "subscribed": false
    }
}

Subscribe address

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "21",
  "method": "subscribeAddresses",
  "params": {
    "addresses": [
      "0x861B462812299D758a88Cad79AFdBe187Dc5AF4F"
    ]
  }
}

Response: 200

Copied! 
{
    "id": "21",
    "data": {
        "subscribed": true
    }
}

Optional parameter newBlockTxs (boolean, default false): when true, the subscription also publishes confirmed transactions for the subscribed addresses as new blocks are connected. Without it only mempool transactions are delivered, so transactions that land straight in a block are never announced.

Unsubscribe address

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"22","method":"unsubscribeAddresses","params":{}}

Response: 200

Copied! 
{
    "id": "22",
    "data": {
        "subscribed": false
    }
}

Subscribe new fiat rates

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"23","method":"subscribeFiatRates","params":{"currency":"usd"}}

Response: 200

Copied! 
{
    "id": "23",
    "data": {
        "subscribed": true
    }
}

Unsubscribe new fiat rates

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"24","method":"unsubscribeFiatRates","params":{}}

Response: 200

Copied! 
{
    "id": "24",
    "data": {
        "subscribed": false
    }
}

Get block

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"25","method":"getBlock","params":{"id":"25000000","page":1}}

Response: 200

Copied! 
{
    "id": "25",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Not supported on this endpoint. Account-based networks have no per-block transaction index for this method.

Get block filters batch

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "26",
  "method": "getBlockFiltersBatch",
  "params": {
    "scriptType": "",
    "bestKnownBlockHash": "f398976165ca4756c77fc6b61111fa1102d431eb03082417ecce38b36308d728",
    "pageSize": 2
  }
}

Response: 200

Copied! 
{
    "id": "26",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Not supported on this endpoint. Compact block filters are not built.

Get contract info

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "27",
  "method": "getContractInfo",
  "params": {
    "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
  }
}

Response: 200

Copied! 
{
    "id": "27",
    "data": {
        "type": "ERC20",
        "standard": "ERC20",
        "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "name": "Tether USD",
        "symbol": "USDT",
        "decimals": 6,
        "createdInBlock": 4634748,
        "blockHeight": 25710280
    }
}

RPC call

Copied! 
wss://eth-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "28",
  "method": "rpcCall",
  "params": {
    "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "data": "0x18160ddd"
  }
}

Response: 200

Copied! 
{
    "id": "28",
    "data": {
        "data": "0x00000000000000000000000000000000000000000000000001470cf8acc65585"
    }
}

Passthrough for eth_call: send the contract address in to and the ABI-encoded call in data. The example above calls totalSupply().