Home

BlockBook Sepolia WSS 0.6.0

Get Info

Copied! 
wss://ethbook-sepolia.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": 11445354,
        "bestHash": "0xa3456e36cd6cc025bd8779afcc69eb2f166f03951974f00da0406098ed5ee35b",
        "block0Hash": "0x25a5cc106eea7138acab33231d7160d69cb777ee0c2c553fcddf5138993e6dd9",
        "testnet": true,
        "backend": {
            "version": "Geth/v1.17.5-stable-9621c6ad/linux-amd64/go1.25.12"
        }
    }
}

Ping

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get block hash

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get account info

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

Copied! 
{
    "id": "4",
    "data": {
        "address": "0x3fD29B9C637F68F807b92ABd690fA0a25aA37Ee1",
        "balance": "328500299352090324",
        "unconfirmedTxs": 0,
        "txs": 1013,
        "nonTokenTxs": 998,
        "nonce": "985"
    }
}

Get account UTXO

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get balance history

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get transaction

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

Copied! 
{
    "id": "7",
    "data": {
        "txid": "0x72c7ff0fb2230ba5d22b7b66fe853e67336076f86ec7a0216ff29a322fa9280c",
        "vin": [
            {
                "n": 0,
                "addresses": [
                    "0x9762D5E119c8b10e715864cEA19E38Ee34B8D852"
                ],
                "isAddress": true
            }
        ],
        "vout": [
            {
                "value": "0",
                "n": 0,
                "addresses": [
                    "0x2c41Ed6294A15F5FBC731396fAdb4723ee397f25"
                ],
                "isAddress": true
            }
        ],
        "blockHash": "0xc6b0fbfa3bba3995854858c642b67f86a4083f859a782e863f1dea3eac7c84f2",
        "blockHeight": 11445311,
        "confirmations": 45,
        "blockTime": 1786192752,
        "value": "0",
        "fees": "194835383669680",
        "tokenTransfers": [
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0x9762D5E119c8b10e715864cEA19E38Ee34B8D852",
                "to": "0x2c41Ed6294A15F5FBC731396fAdb4723ee397f25",
                "contract": "0xf58c3e99A217e7c70F238d1914366489Ae6B9F9F",
                "name": "QuietUSD",
                "symbol": "qUSD",
                "decimals": 18,
                "value": "50000000000000000000"
            },
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0x0000000000000000000000000000000000000000",
                "to": "0x9762D5E119c8b10e715864cEA19E38Ee34B8D852",
                "contract": "0x2c41Ed6294A15F5FBC731396fAdb4723ee397f25",
                "name": "sQuietUSD",
                "symbol": "sqUSD",
                "decimals": 18,
                "value": "48152282271484417489"
            }
        ],
        "ethereumSpecific": {
            "status": 1,
            "nonce": 88,
            "gasLimit": 81326,
            "gasUsed": 69814,
            "gasPrice": "2790778120",
            "effectiveGasPrice": "2790778120",
            "maxPriorityFeePerGas": "1796230339",
            "maxFeePerGas": "2790778120",
            "baseFeePerGas": "1067806414",
            "data": "0x6e553f65000000000000000000000000000000000000000000000002b5e3af16b18800000000000000000000000000009762d5e119c8b10e715864cea19e38ee34b8d852",
            "parsedData": {
                "methodId": "0x6e553f65",
                "name": ""
            }
        }
    }
}

Get transaction specific

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

Copied! 
{
    "id": "8",
    "data": {
        "tx": {
            "nonce": "0x58",
            "gasPrice": "0xa657e508",
            "maxPriorityFeePerGas": "0x6b104cc3",
            "maxFeePerGas": "0xa657e508",
            "baseFeePerGas": "0x3fa56ece",
            "gas": "0x13dae",
            "to": "0x2c41Ed6294A15F5FBC731396fAdb4723ee397f25",
            "value": "0x0",
            "input": "0x6e553f65000000000000000000000000000000000000000000000002b5e3af16b18800000000000000000000000000009762d5e119c8b10e715864cea19e38ee34b8d852",
            "hash": "0x72c7ff0fb2230ba5d22b7b66fe853e67336076f86ec7a0216ff29a322fa9280c",
            "blockNumber": "0xaea43f",
            "blockHash": "0xc6b0fbfa3bba3995854858c642b67f86a4083f859a782e863f1dea3eac7c84f2",
            "from": "0x9762D5E119c8b10e715864cEA19E38Ee34B8D852",
            "transactionIndex": "0x6"
        },
        "receipt": {
            "gasUsed": "0x110b6",
            "effectiveGasPrice": "0xa657e508",
            "status": "0x1",
            "logs": [
                {
                    "address": "0xf58c3e99A217e7c70F238d1914366489Ae6B9F9F",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x0000000000000000000000009762d5e119c8b10e715864cea19e38ee34b8d852"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000002b5e3af16b1880000"
                },
                {
                    "address": "0x2c41Ed6294A15F5FBC731396fAdb4723ee397f25",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x0000000000000000000000000000000000000000000000000000000000000000"
                    ],
                    "data": "0x0000000000000000000000000000000000000000000000029c3f459aac2b15d1"
                }
            ]
        }
    }
}

Estimate fee

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get long term fee rate

Copied! 
wss://ethbook-sepolia.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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

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://ethbook-sepolia.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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get fiat rates for tickers list

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get current fiat rates

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

Copied! 
{
    "id": "16",
    "data": {
        "ts": 1786193280,
        "rates": {
            "usd": 1918.9
        }
    }
}

Subscribe new block

Copied! 
wss://ethbook-sepolia.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://ethbook-sepolia.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://ethbook-sepolia.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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Subscribe address

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

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://ethbook-sepolia.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://ethbook-sepolia.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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

Get block

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"25","method":"getBlock","params":{"id":"860730","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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "26",
  "method": "getBlockFiltersBatch",
  "params": {
    "scriptType": "",
    "bestKnownBlockHash": "c6b0fbfa3bba3995854858c642b67f86a4083f859a782e863f1dea3eac7c84f2",
    "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://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

Copied! 
{
    "id": "27",
    "data": {
        "type": "ERC20",
        "standard": "ERC20",
        "contract": "0x55Cc481D28Db3f1ffc9347745AA6fbB940505BdD",
        "name": "Stabilizer USD",
        "symbol": "USDZ",
        "decimals": 18,
        "blockHeight": 11445358
    }
}

RPC call

Copied! 
wss://ethbook-sepolia.nownodes.io/wss/{{api_key}}

Body

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

Response: 200

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

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