BTC Blockbook WSS
Get Info
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"2","method":"getInfo","params":{}} Response: 200
{
"id": "1",
"data": {
"name": "Bitcoin",
"shortcut": "BTC",
"decimals": 8,
"version": "devel",
"bestHeight": 838610,
"bestHash": "00000000000000000000e16c1a1abc656fee6ce2f6450ea44f4d698bea9bef13",
"block0Hash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
"testnet": false,
"backend": {
"version": "260100",
"subversion": "/Satoshi:26.1.0/"
}
}
}Ping
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"3","method":"ping","params":{}} Response: 200
{
"id": "3",
"data": {}
}Get block hash
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"4","method":"getBlockHash","params":{"height":100000}}Response: 200
{
"id": "4",
"data": {
"hash": "000000000003ba27aa200b1cecaad478d2b00432346c3f1f3986da1afd33e506"
}
}Get account info
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{
"id": "5",
"method": "getAccountInfo",
"params": {
"descriptor": "bc1qrhsext2jjaczc26etu58fry28ycatznn2zv706",
"details": "basic",
"tokens": "derived",
"page": null,
"pageSize": 10,
"from": null,
"to": null,
"contractFilter": ""
}
} Response: 200
{
"id": "5",
"data": {
"address": "bc1qrhsext2jjaczc26etu58fry28ycatznn2zv706",
"balance": "0",
"totalReceived": "9899272",
"totalSent": "9899272",
"unconfirmedBalance": "0",
"unconfirmedTxs": 0,
"txs": 22
}
}Get balance history
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{
"id": "7",
"method": "getBalanceHistory",
"params": {
"descriptor": "bc1qrhsext2jjaczc26etu58fry28ycatznn2zv706",
"from": null,
"to": null,
"currencies": [
""
],
"groupBy": null
}
}Response: 200
{
"id": "7",
"data": [
{
"time": 1709060400,
"txs": 2,
"received": "424698",
"sent": "424698",
"sentToSelf": "0",
"rates": {
"aed": 209833.72,
"ars": 48053356,
"aud": 87301.23,
"bdt": 6268058,
"bhd": 21533.064,
"bmd": 57128.703,
"brl": 281867.3,
"btc": 1.002196,
"cad": 77320.84,
"chf": 50213.785,
"clp": 56008536,
"cny": 411240.94,
"czk": 1334252.2,
"dkk": 392754.1,
"eth": 17.62155,
"eur": 52689.227,
"gbp": 45049.58,
"hkd": 446998.97,
"huf": 20594874,
"idr": 894614300,
"ils": 206136.92,
"inr": 4738737,
"jpy": 8598212,
"krw": 76056030,
"kwd": 17577.36,
"lkr": 17736670,
"mmk": 119932680,
"mxn": 975180.6,
"myr": 273189.47,
"ngn": 89963450,
"nok": 601643.56,
"nzd": 92593.34,
"php": 3204320.5,
"pkr": 15967472,
"pln": 226908.58,
"rub": 5255630.5,
"sar": 214290.95,
"sek": 588895.75,
"sgd": 76780.98,
"thb": 2050577.6,
"try": 1779664.5,
"twd": 1804752.9,
"uah": 2186323.5,
"usd": 57128.703,
"vef": 5720.2974,
"vnd": 1407284400,
"zar": 1090552.6
}
},
{
"time": 1709071200,
"txs": 2,
"received": "2238267",
"sent": "2238267",
"sentToSelf": "0",
"rates": {
"aed": 208075.56,
"ars": 47650724,
"aud": 86569.75,
"bdt": 6215539,
"bhd": 21352.643,
"bmd": 56650.03,
"brl": 279505.6,
"btc": 0.9937987,
"cad": 76672.984,
"chf": 49793.055,
"clp": 55539250,
"cny": 407795.22,
"czk": 1323072.8,
"dkk": 389463.28,
"eth": 17.473902,
"eur": 52247.754,
"gbp": 44672.117,
"hkd": 443253.62,
"huf": 20422314,
"idr": 887118460,
"ils": 204409.73,
"inr": 4699032,
"jpy": 8526170,
"krw": 75418770,
"kwd": 17430.082,
"lkr": 17588056,
"mmk": 118927784,
"mxn": 967009.8,
"myr": 270900.47,
"ngn": 89209660,
"nok": 596602.44,
"nzd": 91817.52,
"php": 3177471.8,
"pkr": 15833684,
"pln": 225007.34,
"rub": 5211594,
"sar": 212495.45,
"sek": 583961.5,
"sgd": 76137.65,
"thb": 2033396.1,
"try": 1764753.1,
"twd": 1789631.1,
"uah": 2168004.8,
"usd": 56650.03,
"vef": 5672.3677,
"vnd": 1395493000,
"zar": 1081415.1
}
},
...Get transaction
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"9","method":"getTransaction","params":{"txid":"622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3"}} Response: 200
{
"id": "9",
"data": {
"txid": "622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3",
"version": 2,
"vin": [
{
"txid": "6b588f72f6c10b950e10a44448b50968a161056163a4a6c4c1b231fd5095a019",
"sequence": 4294967293,
"n": 0,
"addresses": [
"bc1pdndalx60nlzkh0sk4flzdxt325sdj7ky69kma8shh8cn26rtjrqsyfml2e"
],
"isAddress": true,
"value": "4000"
}
],
"vout": [
{
"value": "546",
"n": 0,
"hex": "512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13",
"addresses": [
"bc1pvan3ka9p3fqln8277hp0m9qts4h7qpcupvz3z2s0v9687tfulcfs9aydm5"
],
"isAddress": true
},
{
"value": "1942",
"n": 1,
"hex": "001449a49f5366d20d7e9facd0319575fdbf40a1cf72",
"addresses": [
"bc1qfxjf75mx6gxha8av6qce2a0ahaq2rnmjw20f4l"
],
"isAddress": true
}
],
"blockHeight": -1,
"confirmations": 0,
"confirmationETABlocks": 61,
"confirmationETASeconds": 33245,
"blockTime": 1712754684,
"size": 380,
"vsize": 189,
"value": "2488",
"valueIn": "4000",
"fees": "1512",
"hex": "0200000000010119a09550fd31b2c1c4a6a463610561a16809b54844a4100e950bc1f6728f586b0000000000fdffffff02220200000000000022512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13960700000000000016001449a49f5366d20d7e9facd0319575fdbf40a1cf720340312f3052926633c666f6499609f66431915dfda53b5fdd786e3a5e86c4ef9d42cbd43287f44994a3dd4b6f882fda521ec079f7eda8e3c9927982908cdae095c49820550c51c4b54a929701749e672e13ec80d53626deb85ad8725b413525862672b9ac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d38004c517b2270223a226272632d3230222c226f70223a226465706c6f79222c227469636b223a222462616279222c226c696d223a22222c226d6178223a2230222c2273656c665f6d696e74223a2274727565227d6821c158cad2ef3e5cd0b36b8a2d34b74ec8b14693b9a88571b4f96b6617be4de76d4c00000000",
"rbf": true,
"coinSpecificData": {
"txid": "622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3",
"hash": "5abf2ec6305056c2bf08dc73f1ed1f84d72c333fe896f3111f4701a9d886d08d",
"version": 2,
"size": 380,
"vsize": 189,
"weight": 755,
"locktime": 0,
"vin": [
{
"txid": "6b588f72f6c10b950e10a44448b50968a161056163a4a6c4c1b231fd5095a019",
"vout": 0,
"scriptSig": {
"asm": "",
"hex": ""
},
"txinwitness": [
"312f3052926633c666f6499609f66431915dfda53b5fdd786e3a5e86c4ef9d42cbd43287f44994a3dd4b6f882fda521ec079f7eda8e3c9927982908cdae095c4",
"20550c51c4b54a929701749e672e13ec80d53626deb85ad8725b413525862672b9ac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d38004c517b2270223a226272632d3230222c226f70223a226465706c6f79222c227469636b223a222462616279222c226c696d223a22222c226d6178223a2230222c2273656c665f6d696e74223a2274727565227d68",
"c158cad2ef3e5cd0b36b8a2d34b74ec8b14693b9a88571b4f96b6617be4de76d4c"
],
"sequence": 4294967293
}
],
"vout": [
{
"value": 0.00000546,
"n": 0,
"scriptPubKey": {
"asm": "1 67671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13",
"desc": "rawtr(67671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13)#g0upu40v",
"hex": "512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13",
"address": "bc1pvan3ka9p3fqln8277hp0m9qts4h7qpcupvz3z2s0v9687tfulcfs9aydm5",
"type": "witness_v1_taproot"
}
},
{
"value": 0.00001942,
"n": 1,
"scriptPubKey": {
"asm": "0 49a49f5366d20d7e9facd0319575fdbf40a1cf72",
"desc": "addr(bc1qfxjf75mx6gxha8av6qce2a0ahaq2rnmjw20f4l)#pgjl4kj4",
"hex": "001449a49f5366d20d7e9facd0319575fdbf40a1cf72",
"address": "bc1qfxjf75mx6gxha8av6qce2a0ahaq2rnmjw20f4l",
"type": "witness_v0_keyhash"
}
}
],
"hex": "0200000000010119a09550fd31b2c1c4a6a463610561a16809b54844a4100e950bc1f6728f586b0000000000fdffffff02220200000000000022512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13960700000000000016001449a49f5366d20d7e9facd0319575fdbf40a1cf720340312f3052926633c666f6499609f66431915dfda53b5fdd786e3a5e86c4ef9d42cbd43287f44994a3dd4b6f882fda521ec079f7eda8e3c9927982908cdae095c49820550c51c4b54a929701749e672e13ec80d53626deb85ad8725b413525862672b9ac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d38004c517b2270223a226272632d3230222c226f70223a226465706c6f79222c227469636b223a222462616279222c226c696d223a22222c226d6178223a2230222c2273656c665f6d696e74223a2274727565227d6821c158cad2ef3e5cd0b36b8a2d34b74ec8b14693b9a88571b4f96b6617be4de76d4c00000000"
}
}
}Get transaction specific
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"10","method":"getTransactionSpecific","params":{"txid":"622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3"}} Response: 200
{
"id": "10",
"data": {
"txid": "622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3",
"hash": "5abf2ec6305056c2bf08dc73f1ed1f84d72c333fe896f3111f4701a9d886d08d",
"version": 2,
"size": 380,
"vsize": 189,
"weight": 755,
"locktime": 0,
"vin": [
{
"txid": "6b588f72f6c10b950e10a44448b50968a161056163a4a6c4c1b231fd5095a019",
"vout": 0,
"scriptSig": {
"asm": "",
"hex": ""
},
"txinwitness": [
"312f3052926633c666f6499609f66431915dfda53b5fdd786e3a5e86c4ef9d42cbd43287f44994a3dd4b6f882fda521ec079f7eda8e3c9927982908cdae095c4",
"20550c51c4b54a929701749e672e13ec80d53626deb85ad8725b413525862672b9ac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d38004c517b2270223a226272632d3230222c226f70223a226465706c6f79222c227469636b223a222462616279222c226c696d223a22222c226d6178223a2230222c2273656c665f6d696e74223a2274727565227d68",
"c158cad2ef3e5cd0b36b8a2d34b74ec8b14693b9a88571b4f96b6617be4de76d4c"
],
"sequence": 4294967293
}
],
"vout": [
{
"value": 0.00000546,
"n": 0,
"scriptPubKey": {
"asm": "1 67671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13",
"desc": "rawtr(67671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13)#g0upu40v",
"hex": "512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13",
"address": "bc1pvan3ka9p3fqln8277hp0m9qts4h7qpcupvz3z2s0v9687tfulcfs9aydm5",
"type": "witness_v1_taproot"
}
},
{
"value": 0.00001942,
"n": 1,
"scriptPubKey": {
"asm": "0 49a49f5366d20d7e9facd0319575fdbf40a1cf72",
"desc": "addr(bc1qfxjf75mx6gxha8av6qce2a0ahaq2rnmjw20f4l)#pgjl4kj4",
"hex": "001449a49f5366d20d7e9facd0319575fdbf40a1cf72",
"address": "bc1qfxjf75mx6gxha8av6qce2a0ahaq2rnmjw20f4l",
"type": "witness_v0_keyhash"
}
}
],
"hex": "0200000000010119a09550fd31b2c1c4a6a463610561a16809b54844a4100e950bc1f6728f586b0000000000fdffffff02220200000000000022512067671b74a18a41f99d5ef5c2fd940b856fe0071c0b05112a0f61747f2d3cfe13960700000000000016001449a49f5366d20d7e9facd0319575fdbf40a1cf720340312f3052926633c666f6499609f66431915dfda53b5fdd786e3a5e86c4ef9d42cbd43287f44994a3dd4b6f882fda521ec079f7eda8e3c9927982908cdae095c49820550c51c4b54a929701749e672e13ec80d53626deb85ad8725b413525862672b9ac0063036f7264010118746578742f706c61696e3b636861727365743d7574662d38004c517b2270223a226272632d3230222c226f70223a226465706c6f79222c227469636b223a222462616279222c226c696d223a22222c226d6178223a2230222c2273656c665f6d696e74223a2274727565227d6821c158cad2ef3e5cd0b36b8a2d34b74ec8b14693b9a88571b4f96b6617be4de76d4c00000000"
}
}Estimate fee
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"11","method":"estimateFee","params":{"blocks":[2,5,10,20]}} Response: 200
{
"id": "11",
"data": [
{
"feePerUnit": "91652"
},
{
"feePerUnit": "43764"
},
{
"feePerUnit": "23076"
},
{
"feePerUnit": "15011"
}
]
}Send transaction
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"1","method":"sendTransaction","params":{"hex":"010000000001019d64f0c72a0d206001decbffaa722eb1044534c74eee7a5df8318e42a4323ec10000000017160014550da1f5d25a9dae2eafd6902b4194c4c6500af6ffffffff02809698000000000017a914cd668d781ece600efa4b2404dc91fd26b8b8aed8870553d7360000000017a914246655bdbd54c7e477d0ea2375e86e0db2b8f80a8702473044022076aba4ad559616905fa51d4ddd357fc1fdb428d40cb388e042cdd1da4a1b7357022011916f90c712ead9a66d5f058252efd280439ad8956a967e95d437d246710bc9012102a80a5964c5612bb769ef73147b2cf3c149bc0fd4ecb02f8097629c94ab013ffd00000000"}} Response: 200
{
"id": "1",
"data": {
"result": "622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3"
}
}Get fiat rates for timestamps
wss://btcbook.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": 26847.354,
"ars": 437688.9,
"aud": 10720.282,
"bdt": 620651.06,
"bhd": 2755.8298,
"bmd": 7308.9824,
"brl": 30870.219,
"btc": 0.002072684,
"cad": 9725.683,
"chf": 7246.6074,
"clp": 5874949.5,
"cny": 51450.12,
"czk": 168583.5,
"dkk": 49300.82,
"eth": 0.10173308,
"eur": 6598.5054,
"gbp": 5648.659,
"hkd": 57218.734,
"huf": 2192127.2,
"idr": 103259750,
"ils": 25384.826,
"inr": 523579.7,
"jpy": 796873.3,
"krw": 8659682,
"kwd": 2222.5447,
"lkr": 1325450.1,
"mmk": 11013702,
"mxn": 143120.11,
"myr": 30542.775,
"ngn": 2650395,
"nok": 67026.26,
"nzd": 11248.225,
"php": 372977.38,
"pkr": 1134879.8,
"pln": 28290.484,
"rub": 469282.72,
"sar": 27408.604,
"sek": 69754.52,
"sgd": 9989.135,
"thb": 221205.83,
"try": 41971.1,
"twd": 222543.89,
"uah": 175139.44,
"usd": 15.143119,
"vef": 1816191900,
"vnd": 168348930,
"zar": 106333.266
}
},
{
"ts": 1575590400,
"rates": {
"aed": 27085.377,
"ars": 442168.88,
"aud": 10791.464,
"bdt": 625776.9,
"bhd": 2780.3438,
"bmd": 7373.7827,
"brl": 30865.916,
"btc": 0.002118513,
"cad": 9716.802,
"chf": 7279.1255,
"clp": 5775146.5,
"cny": 51946.824,
"czk": 169634.61,
"dkk": 49610.07,
"eth": 0.10593553,
"eur": 6640.0913,
"gbp": 5603.2856,
"hkd": 57728.582,
"huf": 2196354.8,
"idr": 103020920,
"ils": 25550.23,
"inr": 525308.25,
"jpy": 801761.2,
"krw": 8760865,
"kwd": 2239.248,
"lkr": 1337502.5,
"mmk": 11056767,
"mxn": 142815.23,
"myr": 30770.795,
"ngn": 2672996.2,
"nok": 67363.266,
"nzd": 11266.284,
"php": 374521.56,
"pkr": 1143235,
"pln": 28392.588,
"rub": 469697.4,
"sar": 27651.521,
"sek": 69972.03,
"sgd": 10033.159,
"thb": 224015.52,
"try": 42391.875,
"twd": 224384.2,
"uah": 175796.9,
"usd": 15.646635,
"vef": 1832293900,
"vnd": 170593170,
"zar": 107953.65
}
}
]
}
}Get fiat rates for tickers list
wss://btcbook.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://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"6","method":"getCurrentFiatRates","params":{"currencies":[""]}} Response: 200
{
"id": "6",
"data": {
"ts": 1712755809,
"rates": {
"aed": 248263,
"ars": 58495340,
"aud": 103415,
"bdt": 7428079,
"bhd": 25486,
"bmd": 67604,
"brl": 342135,
"btc": 1,
"cad": 92305,
"chf": 61546,
"clp": 64545852,
"cny": 489064,
"czk": 1594837,
"dkk": 468399,
"eth": 19.7215,
"eur": 62792,
"gbp": 53701,
"hkd": 529593,
"huf": 24579174,
"idr": 1077804000,
"ils": 252533,
"inr": 5637349,
"jpy": 10308056,
"krw": 92173510,
"kwd": 20789,
"lkr": 20190384,
"mmk": 141962900,
"mxn": 1112681,
"myr": 320982,
"ngn": 84230660,
"nok": 728548,
"nzd": 112551,
"php": 3821156,
"pkr": 18790116,
"pln": 267799,
"rub": 6306302,
"sar": 253591,
"sek": 723243,
"sgd": 91391,
"thb": 2477468,
"try": 2181006,
"twd": 2174029,
"uah": 2633635,
"usd": 67604,
"vef": 6769.14,
"vnd": 1686505500,
"zar": 1263524
}
}
}Subscribe new block
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"16","method":"subscribeNewBlock","params":{}}Response: 200
{
"id": "17",
"data": {
"subscribed": true
}
}Unsubscribe new block
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"16","method":"unsubscribeNewBlock","params":{}} Response: 200
{
"id": "16",
"data": {
"subscribed": false
}
}Subscribe new transaction
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"17","method":"subscribeNewTransaction","params":{}} Response: 200
{
"id": "17",
"data": {
"subscribed": true
}
}Unsubscribe new transaction
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"17","method":"unsubscribeNewTransaction","params":{}} Response: 200
{
"id": "17",
"data": {
"subscribed": false
}
}Subscribe address
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"18","method":"subscribeAddresses","params":{"addresses":["bc1qrhsext2jjaczc26etu58fry28ycatznn2zv706","bc1pvan3ka9p3fqln8277hp0m9qts4h7qpcupvz3z2s0v9687tfulcfs9aydm5"]}} Response: 200
{
"id": "18",
"data": {
"subscribed": true
}
}Unsubscribe address
wss://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"18","method":"unsubscribeAddresses","params":{}} Response: 200
{
"id": "18",
"data": {
"subscribed": false
}
}Subscribe new fiat rates
wss://btcbook.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://btcbook.nownodes.io/wss/{{api_key}}
Body
{"id":"19","method":"unsubscribeFiatRates","params":{}} Response: 200
{
"id": "19",
"data": {
"subscribed": false
}
}Last updated