Home

BlockBook WSS 0.6.0

Get Info

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

Body

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

Response: 200

Copied! 
{
    "id": "1",
    "data": {
        "name": "Base",
        "shortcut": "ETH",
        "network": "ETH",
        "decimals": 18,
        "version": "0.6.0",
        "bestHeight": 49705602,
        "bestHash": "0x07eddd233f7f2292693fb2835b5bfcdd43e2ace1bc8081129027b4123c1cc595",
        "block0Hash": "0xf712aa9241cc24369b143cf6dce85f0902a9731e70d66818a3a5845b296c73dd",
        "testnet": false,
        "backend": {
            "version": "reth/v2.3.0-9384bc5/x86_64-unknown-linux-gnu/base/v1.2.0"
        }
    }
}

Ping

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

Body

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

Response: 200

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

Get block hash

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

Body

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

Response: 200

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

Get account info

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

Body

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

Response: 200

Copied! 
{
    "id": "4",
    "data": {
        "address": "0xB04783be99bc9b17bF49e90255bC87047f2c1b65",
        "balance": "36883906350",
        "unconfirmedTxs": 0,
        "txs": 36,
        "nonTokenTxs": 28,
        "nonce": "27"
    }
}

Get account UTXO

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

Body

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

Response: 200

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

Get balance history

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

Body

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

Response: 200

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

Get transaction

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

Body

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

Response: 200

Copied! 
{
    "id": "7",
    "data": {
        "txid": "0xa02b923d1f26c6ef3d286052a9f1968dbcca5b3e33f939399539a82b1b0a3ffa",
        "vin": [
            {
                "n": 0,
                "addresses": [
                    "0x467F3ACD346A3Aa56F612820367023B94dC73d3f"
                ],
                "isAddress": true
            }
        ],
        "vout": [
            {
                "value": "0",
                "n": 0,
                "addresses": [
                    "0xFB384a73e9B89b01749C1127cDe4FeA20fb9F06a"
                ],
                "isAddress": true
            }
        ],
        "blockHash": "0xba6bbb9586a36ae09be3e66c2d31a44a3666f3d1b131756ccbf94bf9098b40f6",
        "blockHeight": 49703773,
        "confirmations": 1836,
        "blockTime": 1786196893,
        "value": "0",
        "fees": "2619840072518",
        "tokenTransfers": [
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0xCAf89E2Fd05574ba2e43d3DC3CBf1a743BB0f955",
                "to": "0xbFACe6Ad3c7f07714F2Cc0a2651436f897537a95",
                "contract": "0xb4bB2032A73A53C0Aa7Dc9ee2d9658a978fA7bC2",
                "name": "Unified USD",
                "symbol": "WUSD",
                "decimals": 18,
                "value": "6381474627586445312"
            }
        ],
        "ethereumSpecific": {
            "status": 1,
            "nonce": 9638227,
            "gasLimit": 506042,
            "gasUsed": 363775,
            "gasPrice": "7200000",
            "effectiveGasPrice": "7200000",
            "baseFeePerGas": "5000000",
            "l1Fee": 660072518,
            "l1GasPrice": "38668090",
            "l1GasUsed": 2932,
            "data": "0xfe7cdd426ccd487b6cb24263a44ce592487f8ddb00000000000000000000000000000000ebf52e2c0cf2456db07a6cf3cdd009d400000000000000000000000000000000436172642d44656269742d504f530000000000000000000000000000000000004555520000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000048b8383cbf0c0000000000000000000000000000caf89e2fd05574ba2e43d3dc3cbf1a743bb0f955000000000000000000000000b4bb2032a73a53c0aa7dc9ee2d9658a978fa7bc2000000000000000000000000000000000000000000000000588f8d5d007550000000000000000000000000000000000000000000000000000000019fe1a1948d",
            "parsedData": {
                "methodId": "0xfe7cdd42",
                "name": ""
            }
        }
    }
}

Get transaction specific

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

Body

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

Response: 200

Copied! 
{
    "id": "8",
    "data": {
        "tx": {
            "nonce": "0x931153",
            "gasPrice": "0x6ddd00",
            "baseFeePerGas": "0x4c4b40",
            "gas": "0x7b8ba",
            "to": "0xFB384a73e9B89b01749C1127cDe4FeA20fb9F06a",
            "value": "0x0",
            "input": "0xfe7cdd426ccd487b6cb24263a44ce592487f8ddb00000000000000000000000000000000ebf52e2c0cf2456db07a6cf3cdd009d400000000000000000000000000000000436172642d44656269742d504f530000000000000000000000000000000000004555520000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000048b8383cbf0c0000000000000000000000000000caf89e2fd05574ba2e43d3dc3cbf1a743bb0f955000000000000000000000000b4bb2032a73a53c0aa7dc9ee2d9658a978fa7bc2000000000000000000000000000000000000000000000000588f8d5d007550000000000000000000000000000000000000000000000000000000019fe1a1948d",
            "hash": "0xa02b923d1f26c6ef3d286052a9f1968dbcca5b3e33f939399539a82b1b0a3ffa",
            "blockNumber": "0x2f66b5d",
            "blockHash": "0xba6bbb9586a36ae09be3e66c2d31a44a3666f3d1b131756ccbf94bf9098b40f6",
            "from": "0x467F3ACD346A3Aa56F612820367023B94dC73d3f",
            "transactionIndex": "0xd"
        },
        "receipt": {
            "gasUsed": "0x58cff",
            "effectiveGasPrice": "0x6ddd00",
            "status": "0x1",
            "logs": [
                {
                    "address": "0xb4bB2032A73A53C0Aa7Dc9ee2d9658a978fA7bC2",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x000000000000000000000000caf89e2fd05574ba2e43d3dc3cbf1a743bb0f955"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000000588f8d5d00755000"
                },
                {
                    "address": "0xb4bB2032A73A53C0Aa7Dc9ee2d9658a978fA7bC2",
                    "topics": [
                        "0xe0909c1e0920730c8581f147b8c626a0f7872c24ec1241f0dbb6e3ebecc409af",
                        "0x000000000000000000000000caf89e2fd05574ba2e43d3dc3cbf1a743bb0f955"
                    ],
                    "data": "0x000000000000000000000000000000000000000000000000225fff34214f6012000000000000000000000000000000000000000000000021b970693fda6ca40000000000000000000000000000000000000000000000002160e0dbe2d9f75400000000000000000000000000000000000000000000000000000000006a77339d0000000000000000000000000000000000000000000000000000000000000001"
                }
            ],
            "l1Fee": "0x2757e846",
            "l1GasPrice": "0x24e073a",
            "l1GasUsed": "0xb74"
        }
    }
}

Estimate fee

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

Body

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

Response: 200

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

Get long term fee rate

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

Body

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

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://base-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://base-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": "0xa02b923d1f26c6ef3d286052a9f1968dbcca5b3e33f939399539a82b1b0a3ffa"
    }
}

A transaction the backend rejects returns an error object instead, for example {"id": "13", "data": {"error": {"message": "failed to decode signed transaction"}}}.

Get fiat rates for timestamps

Copied! 
wss://base-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": 1748908800,
                "rates": {
                    "usd": 2609.7373
                }
            }
        ]
    }
}

Get fiat rates for tickers list

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

Body

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

Response: 200

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

Get current fiat rates

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

Body

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

Response: 200

Copied! 
{
    "id": "16",
    "data": {
        "ts": 1786199062,
        "rates": {
            "usd": 1919.92
        }
    }
}

Subscribe new block

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

Body

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

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

Body

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

Body

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

Body

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

Response: 200

Copied! 
{
    "id": "27",
    "data": {
        "type": "ERC20",
        "standard": "ERC20",
        "contract": "0xb4bB2032A73A53C0Aa7Dc9ee2d9658a978fA7bC2",
        "name": "Unified USD",
        "symbol": "WUSD",
        "decimals": 18,
        "blockHeight": 49705627
    }
}

RPC call

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

Body

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

Response: 200

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

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