ETH Blockbook WSS
Get Info
wss://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"2","method":"getInfo","params":{}}
Response: 200
{
"id": "2",
"data": {
"name": "Ethereum",
"shortcut": "ETH",
"decimals": 18,
"version": "devel",
"bestHeight": 19738679,
"bestHash": "0x28786b35e47acd84ed7a99770d075ced2793a905e0c52efcee6c346e8a9c3afa",
"block0Hash": "0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3",
"testnet": false,
"backend": {
"version": "Geth/v1.13.15-stable-c5ba367e/linux-amd64/go1.21.6"
}
}
}
Ping
wss://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"3","method":"ping","params":{}}
Response: 200
{
"id": "3",
"data": {}
}
Get block hash
wss://eth-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://eth-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://eth-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://eth-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://eth-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://eth-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://eth-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://eth-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://eth-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://eth-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://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"16","method":"subscribeNewBlock","params":{}}
Response: 200
{
"id": "17",
"data": {
"subscribed": true
}
}
Unsubscribe new block
wss://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"16","method":"unsubscribeNewBlock","params":{}}
Response: 200
{
"id": "16",
"data": {
"subscribed": false
}
}
Subscribe new transaction
wss://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"17","method":"subscribeNewTransaction","params":{}}
Response: 200
{
"id": "17",
"data": {
"subscribed": true
}
}
Unsubscribe new transaction
wss://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"17","method":"unsubscribeNewTransaction","params":{}}
Response: 200
{
"id": "17",
"data": {
"subscribed": false
}
}
Subscribe address
wss://eth-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://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"18","method":"unsubscribeAddresses","params":{}}
Response: 200
{
"id": "18",
"data": {
"subscribed": false
}
}
Subscribe new fiat rates
wss://eth-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://eth-blockbook.nownodes.io/wss/{{api_key}}
Body
{"id":"19","method":"unsubscribeFiatRates","params":{}}
Response: 200
{
"id": "19",
"data": {
"subscribed": false
}
}
Last updated