BlockBook WSS

Get Info

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

Body

{"id":"2","method":"getInfo","params":{}}	

Response: 200

{
    "id": "2",
    "data": {
        "name": "Base",
        "shortcut": "ETH",
        "network": "ETH",
        "decimals": 18,
        "version": "0.5.0",
        "bestHeight": 36228797,
        "bestHash": "0x1cc235c5f6827549df8b9f1821f20d96567f406bbe287db7d027bf7128b93534",
        "block0Hash": "",
        "testnet": false,
        "backend": {
            "version": "Geth/v0.1.0-untagged/linux-amd64/go1.23.12"
        }
    }
}

Ping

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

Body

{"id":"3","method":"ping","params":{}}	

Response: 200

{
    "id": "3",
    "data": {}
}

Get block hash

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

Body

{"id":"4","method":"getBlockHash","params":{"height":1000000}}

Response: 200

{
    "id": "4",
    "data": {
        "hash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e"
    }
}

Get account info

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

Body

{
  "id": "5",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
    "details": "basic",
    "tokens": "derived",
    "page": null,
    "pageSize": 10,
    "from": null,
    "to": null,
    "contractFilter": ""
  }
}	

Response: 200

{
    "id": "5",
    "data": {
        "address": "0xba98D6a5ac827632E3457De7512d211e4ff7e8bD",
        "balance": "0",
        "unconfirmedBalance": "0",
        "unconfirmedTxs": 0,
        "txs": 0,
        "nonce": "0"
    }
}

Get balance history

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

Body

{
  "id": "7",
  "method": "getBalanceHistory",
  "params": {
    "descriptor": "0x00008eb96bbe046aee645d8933adf151c4b7b614",
    "from": null,
    "to": null,
    "currencies": [
      ""
    ],
    "groupBy": null
  }
}

Response: 200

{
    "id": "7",
    "data": []
}

Get transaction

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

Body

{"id":"9","method":"getTransaction","params":{"txid":"0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532"}}	

Response: 200

{
    "id": "9",
    "data": {
        "error": {
            "message": "Transaction '0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532' not found"
        }
    }
}

Get transaction specific

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

Body

{"id":"10","method":"getTransactionSpecific","params":{"txid":"0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532"}}	

Response: 200

{
    "id": "10",
    "data": {
        "error": {
            "message": "Tx not found"
        }
    }
}

Estimate fee

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

Body

{"id":"11","method":"estimateFee","params":{"blocks":[2,5,10,20]}}	

Response: 200

{
    "id": "11",
    "data": [
        {
            "feePerTx": "426083335548084",
            "feePerUnit": "7920795188",
            "feeLimit": "53793"
        },
        {
            "feePerTx": "22920300869138082612",
            "feePerUnit": "426083335548084",
            "feeLimit": "53793"
        },
        {
            "feePerTx": "1232951744653544877947316",
            "feePerUnit": "22920300869138082612",
            "feeLimit": "53793"
        },
        {
            "feePerTx": "66324173200148139619419969588",
            "feePerUnit": "1232951744653544877947316",
            "feeLimit": "53793"
        }
    ]
}

Send transaction

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

Body

{"id":"1","method":"sendTransaction","params":{"hex":"010000000001019d64f0c72a0d206001decbffaa722eb1044534c74eee7a5df8318e42a4323ec10000000017160014550da1f5d25a9dae2eafd6902b4194c4c6500af6ffffffff02809698000000000017a914cd668d781ece600efa4b2404dc91fd26b8b8aed8870553d7360000000017a914246655bdbd54c7e477d0ea2375e86e0db2b8f80a8702473044022076aba4ad559616905fa51d4ddd357fc1fdb428d40cb388e042cdd1da4a1b7357022011916f90c712ead9a66d5f058252efd280439ad8956a967e95d437d246710bc9012102a80a5964c5612bb769ef73147b2cf3c149bc0fd4ecb02f8097629c94ab013ffd00000000"}}		

Response: 200

{
    "id": "1",
    "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

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

Body

{"id":"13","method":"getFiatRatesForTimestamps","params":{"timestamps":[1575288000,1575550800],"currencies":[""]}}	

Response: 200

{
    "id": "13",
    "data": {
        "tickers": [
            {
                "ts": 1575331200,
                "rates": {
                    "aed": 546.8193,
                    "ars": 8914.723,
                    "aud": 218.34764,
                    "bdt": 12641.244,
                    "bhd": 56.129955,
                    "bmd": 148.86726,
                    "brl": 628.7558,
                    "btc": 0.020375907,
                    "cad": 198.08994,
                    "chf": 147.59683,
                    "clp": 119659.3,
                    "cny": 1047.9214,
                    "czk": 3433.6606,
                    "dkk": 1004.145,
                    "eth": 1,
                    "eur": 134.39647,
                    "gbp": 115.050285,
                    "hkd": 1165.4148,
                    "huf": 44648.62,
                    "idr": 2103165.2,
                    "ils": 517.0309,
                    "inr": 10664.122,
                    "jpy": 16230.488,
                    "krw": 176377.94,
                    "kwd": 45.268154,
                    "lkr": 26996.39,
                    "mmk": 224323.94,
                    "mxn": 2915.0295,
                    "myr": 622.08655,
                    "ngn": 53982.49,
                    "nok": 1365.1716,
                    "nzd": 229.10062,
                    "php": 7596.697,
                    "pkr": 23114.906,
                    "pln": 576.2125,
                    "rub": 9558.217,
                    "sar": 558.2506,
                    "sek": 1420.7402,
                    "sgd": 203.45586,
                    "thb": 4505.457,
                    "try": 854.8554,
                    "twd": 4532.7104,
                    "uah": 3567.19,
                    "usd": 148.86726,
                    "vef": 36991676,
                    "vnd": 3428883,
                    "zar": 2165.7656
                }
            },
...

Get fiat rates for tickers list

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

Body

{"id":"15","method":"getFiatRatesTickersList","params":{"timestamp":1676591569}}

Response: 200

{
    "id": "15",
    "data": {
        "ts": 1676592000,
        "available_currencies": [
            "aed",
            "ars",
            "aud",
            "bdt",
            "bhd",
            "bmd",
            "brl",
            "btc",
            "cad",
            "chf",
            "clp",
            "cny",
            "czk",
            "dkk",
            "eth",
            "eur",
            "gbp",
            "hkd",
            "huf",
            "idr",
            "ils",
            "inr",
            "jpy",
            "krw",
            "kwd",
            "lkr",
            "mmk",
            "mxn",
            "myr",
            "ngn",
            "nok",
            "nzd",
            "php",
            "pkr",
            "pln",
            "rub",
            "sar",
            "sek",
            "sgd",
            "thb",
            "try",
            "twd",
            "uah",
            "usd",
            "vef",
            "vnd",
            "zar"
        ]
    }
}

Get current fiat rates

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

Body

{"id":"6","method":"getCurrentFiatRates","params":{"currencies":[""]}}	

Response: 200

{
    "id": "6",
    "data": {
        "ts": 1714124526,
        "rates": {
            "aed": 11578.76,
            "ars": 2754471,
            "aud": 4821.05,
            "bdt": 345886,
            "bhd": 1188.35,
            "bmd": 3152.49,
            "brl": 16264.46,
            "btc": 0.04887087,
            "cad": 4303.69,
            "chf": 2875.59,
            "clp": 2990132,
            "cny": 22846,
            "czk": 73905,
            "dkk": 21905,
            "eth": 1,
            "eur": 2937.24,
            "gbp": 2519.91,
            "hkd": 24678,
            "huf": 1154543,
            "idr": 51266030,
            "ils": 12005.23,
            "inr": 262738,
            "jpy": 493543,
            "krw": 4339333,
            "kwd": 970.4,
            "lkr": 936066,
            "mmk": 6618563,
            "mxn": 54401,
            "myr": 15035.78,
            "ngn": 4117840,
            "nok": 34627,
            "nzd": 5294.62,
            "php": 181917,
            "pkr": 877746,
            "pln": 12708.14,
            "rub": 290552,
            "sar": 11823.6,
            "sek": 34306,
            "sgd": 4289.26,
            "thb": 116453,
            "try": 102702,
            "twd": 102737,
            "uah": 124920,
            "usd": 3152.49,
            "vef": 315.66,
            "vnd": 79900800,
            "zar": 59867
        }
    }
}

Subscribe new block

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

Body

{"id":"16","method":"subscribeNewBlock","params":{}}

Response: 200

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

Unsubscribe new block

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

Body

{"id":"16","method":"unsubscribeNewBlock","params":{}}	

Response: 200

{
    "id": "16",
    "data": {
        "subscribed": false
    }
}

Subscribe new transaction

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

Body

{"id":"17","method":"subscribeNewTransaction","params":{}}	

Response: 200

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

Unsubscribe new transaction

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

Body

{"id":"17","method":"unsubscribeNewTransaction","params":{}}	

Response: 200

{
    "id": "17",
    "data": {
        "subscribed": false
    }
}

Subscribe address

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

Body

{"id":"18","method":"subscribeAddresses","params":{"addresses":["0xba98d6a5ac827632e3457de7512d211e4ff7e8bd","0x73d0385f4d8e00c5e6504c6030f47bf6212736a8"]}}	

Response: 200

{
    "id": "18",
    "data": {
        "subscribed": true
    }
}

Unsubscribe address

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

Body

{"id":"18","method":"unsubscribeAddresses","params":{}}		

Response: 200

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

Subscribe new fiat rates

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

Body

{"id":"19","method":"subscribeFiatRates","params":{"currency":"usd"}}		

Response: 200

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

Unsubscribe new fiat rates

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

Body

{"id":"19","method":"unsubscribeFiatRates","params":{}}		

Response: 200

{
    "id": "19",
    "data": {
        "subscribed": false
    }
}