BlockBook WSS
Body
Get Info
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"2","method":"getInfo","params":{}} Response: 200
Copied!
{
"id": "2",
"data": {
"name": "Polygon",
"shortcut": "MATIC",
"network": "MATIC",
"decimals": 18,
"version": "0.5.0",
"bestHeight": 77092542,
"bestHash": "0x3c67aa0c53d27a99ebcd1c7cc2edfe313a345b978306d901030144d17776610e",
"block0Hash": "",
"testnet": false,
"backend": {
"version": "bor/v2.2.11-beta2/linux-amd64/go1.24.6"
}
}
}Ping
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"3","method":"ping","params":{}} Response: 200
Copied!
{
"id": "3",
"data": {}
}Get block hash
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"4","method":"getBlockHash","params":{"height":1000000}}Response: 200
Copied!
{
"id": "4",
"data": {
"hash": "0x8e38b4dbf6b11fcc3b9dee84fb7986e29ca0a02cecd8977c161ff7333329681e"
}
}Get account info
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "5",
"method": "getAccountInfo",
"params": {
"descriptor": "0xba98d6a5ac827632e3457de7512d211e4ff7e8bd",
"details": "basic",
"tokens": "derived",
"page": null,
"pageSize": 10,
"from": null,
"to": null,
"contractFilter": ""
}
} Response: 200
Copied!
{
"id": "5",
"data": {
"address": "0xba98D6a5ac827632E3457De7512d211e4ff7e8bD",
"balance": "0",
"unconfirmedBalance": "0",
"unconfirmedTxs": 0,
"txs": 0,
"nonce": "0"
}
}Get balance history
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "7",
"method": "getBalanceHistory",
"params": {
"descriptor": "0x00008eb96bbe046aee645d8933adf151c4b7b614",
"from": null,
"to": null,
"currencies": [
""
],
"groupBy": null
}
}Response: 200
Copied!
{
"id": "7",
"data": []
}Get transaction
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"9","method":"getTransaction","params":{"txid":"0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532"}} Response: 200
Copied!
{
"id": "9",
"data": {
"error": {
"message": "Transaction '0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532' not found"
}
}
}Get transaction specific
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"10","method":"getTransactionSpecific","params":{"txid":"0xdc18ac078e20f5ce8ee72004c89400ffa4bee67e8aa292dce69f5978dce84532"}} Response: 200
Copied!
{
"id": "10",
"data": {
"error": {
"message": "Tx not found"
}
}
}Estimate fee
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"11","method":"estimateFee","params":{"blocks":[2,5,10,20]}} Response: 200
Copied!
{
"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
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"1","method":"sendTransaction","params":{"hex":"010000000001019d64f0c72a0d206001decbffaa722eb1044534c74eee7a5df8318e42a4323ec10000000017160014550da1f5d25a9dae2eafd6902b4194c4c6500af6ffffffff02809698000000000017a914cd668d781ece600efa4b2404dc91fd26b8b8aed8870553d7360000000017a914246655bdbd54c7e477d0ea2375e86e0db2b8f80a8702473044022076aba4ad559616905fa51d4ddd357fc1fdb428d40cb388e042cdd1da4a1b7357022011916f90c712ead9a66d5f058252efd280439ad8956a967e95d437d246710bc9012102a80a5964c5612bb769ef73147b2cf3c149bc0fd4ecb02f8097629c94ab013ffd00000000"}} Response: 200
Copied!
{
"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
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"13","method":"getFiatRatesForTimestamps","params":{"timestamps":[1575288000,1575550800],"currencies":[""]}} Response: 200
Copied!
{
"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
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"15","method":"getFiatRatesTickersList","params":{"timestamp":1676591569}}Response: 200
Copied!
{
"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
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"6","method":"getCurrentFiatRates","params":{"currencies":[""]}} Response: 200
Copied!
{
"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
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"16","method":"subscribeNewBlock","params":{}}Response: 200
Copied!
{
"id": "17",
"data": {
"subscribed": true
}
}Unsubscribe new block
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"16","method":"unsubscribeNewBlock","params":{}} Response: 200
Copied!
{
"id": "16",
"data": {
"subscribed": false
}
}Subscribe new transaction
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"17","method":"subscribeNewTransaction","params":{}} Response: 200
Copied!
{
"id": "17",
"data": {
"subscribed": true
}
}Unsubscribe new transaction
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"17","method":"unsubscribeNewTransaction","params":{}} Response: 200
Copied!
{
"id": "17",
"data": {
"subscribed": false
}
}Subscribe address
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "18",
"method": "subscribeAddresses",
"params": {
"addresses": [
"0x109b12abF3FB6396a0E90894E86a640870b7c1ad"
],
"newBlockTxs": true
}
}Response: 200
Copied!
{
"id": "18",
"data": {
"subscribed": true
}
}Unsubscribe address
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"18","method":"unsubscribeAddresses","params":{}} Response: 200
Copied!
{
"id": "18",
"data": {
"subscribed": false
}
}Subscribe new fiat rates
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"19","method":"subscribeFiatRates","params":{"currency":"usd"}} Response: 200
Copied!
{
"id": "19",
"data": {
"subscribed": true
}
}Unsubscribe new fiat rates
Copied!wss://maticbook.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"19","method":"unsubscribeFiatRates","params":{}} Response: 200
Copied!
{
"id": "19",
"data": {
"subscribed": false
}
}