WSS 0.6.0
Get Info
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"1","method":"getInfo","params":{}}Response: 200
Copied!
{
"id": "1",
"data": {
"name": "Bitcoin",
"shortcut": "BTC",
"network": "BTC",
"decimals": 8,
"version": "0.6.0",
"bestHeight": 961329,
"bestHash": "00000000000000000002024f8204a700dc7b41b099f264997f1d5b606afdbe9c",
"block0Hash": "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
"testnet": false,
"backend": {
"version": "310100",
"subversion": "/Satoshi:31.1.0/"
}
}
}Ping
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"2","method":"ping","params":{}}Response: 200
Copied!
{
"id": "2",
"data": {}
}Get block hash
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"3","method":"getBlockHash","params":{"height":900000}}Response: 200
Copied!
{
"id": "3",
"data": {
"hash": "000000000000000000010538edbfd2d5b809a33dd83f284aeea41c6d0d96968a"
}
}Get account info
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "4",
"method": "getAccountInfo",
"params": {
"descriptor": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
"details": "basic"
}
}Response: 200
Copied!
{
"id": "4",
"data": {
"address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
"balance": "30551556036",
"totalReceived": "9491573241165",
"totalSent": "9461021685129",
"unconfirmedTxs": 0,
"txs": 30803
}
}Get account UTXO
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "5",
"method": "getAccountUtxo",
"params": {
"descriptor": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38"
}
}Response: 200
Copied!
{
"id": "5",
"data": [
{
"txid": "4388955bb9636d07f1b458ce4fe14e385ca24e7dcb8cefe417fcd65cd591a227",
"vout": 0,
"value": "314733533",
"height": 961326,
"confirmations": 4,
"coinbase": true
},
{
"txid": "342aa01e68ecd44edac06942d2677ed49883ac27a8758b5461f7b68f1790cc43",
"vout": 0,
"value": "313578190",
"height": 961315,
"confirmations": 15,
"coinbase": true
}
]
}Get balance history
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "6",
"method": "getBalanceHistory",
"params": {
"descriptor": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
"from": 1725976800,
"to": 1726063200
}
}Response: 200
Copied!
{
"id": "6",
"data": [
{
"time": 1725976800,
"txs": 3,
"received": "951626120",
"sent": "0",
"sentToSelf": "0",
"rates": {
"aed": 413468.1,
"ars": 152054020,
"aud": 173953.44,
"bdt": 13550807,
"bhd": 42209.594,
"bmd": 112572.125,
"brl": 623491.9,
"btc": 0.9857531,
"cad": 155085.44,
"chf": 90515.76,
"clp": 108788056,
"cny": 811847.7,
"czk": 2386675.5,
"dkk": 724840.7,
"eth": 32.191605,
"eur": 97140.74,
"gbp": 84694.66,
"hkd": 883641.1,
"huf": 38635310,
"idr": 1856281100,
"ils": 383821.2,
"inr": 9821416,
"jpy": 16579004,
"krw": 156608050,
"kwd": 34301.965,
"lkr": 33396254,
"mmk": 236288900,
"mxn": 2123763.2,
"myr": 481527.28,
"ngn": 169874720,
"nok": 1153367.5,
"nzd": 190284.27,
"php": 6497663,
"pkr": 31537822,
"pln": 414580.06,
"rub": 8908448,
"sar": 422280.56,
"sek": 1085954.2,
"sgd": 145029.27,
"thb": 3642834,
"try": 4579839.5,
"twd": 3358026.8,
"uah": 4633410.5,
"usd": 112572.125,
"vnd": 2951553500,
"zar": 2029329.2
}
},
{
"time": 1725980400,
"txs": 1,
"received": "321108026",
"sent": "0",
"sentToSelf": "0",
"rates": {
"aed": 413468.1,
"ars": 152054020,
"aud": 173953.44,
"bdt": 13550807,
"bhd": 42209.594,
"bmd": 112572.125,
"brl": 623491.9,
"btc": 0.9857531,
"cad": 155085.44,
"chf": 90515.76,
"clp": 108788056,
"cny": 811847.7,
"czk": 2386675.5,
"dkk": 724840.7,
"eth": 32.191605,
"eur": 97140.74,
"gbp": 84694.66,
"hkd": 883641.1,
"huf": 38635310,
"idr": 1856281100,
"ils": 383821.2,
"inr": 9821416,
"jpy": 16579004,
"krw": 156608050,
"kwd": 34301.965,
"lkr": 33396254,
"mmk": 236288900,
"mxn": 2123763.2,
"myr": 481527.28,
"ngn": 169874720,
"nok": 1153367.5,
"nzd": 190284.27,
"php": 6497663,
"pkr": 31537822,
"pln": 414580.06,
"rub": 8908448,
"sar": 422280.56,
"sek": 1085954.2,
"sgd": 145029.27,
"thb": 3642834,
"try": 4579839.5,
"twd": 3358026.8,
"uah": 4633410.5,
"usd": 112572.125,
"vnd": 2951553500,
"zar": 2029329.2
}
}
]
}Get transaction
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "7",
"method": "getTransaction",
"params": {
"txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a"
}
}Response: 200
Copied!
{
"id": "7",
"data": {
"txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
"version": 2,
"lockTime": 956046,
"vin": [
{
"sequence": 4294967294,
"n": 0,
"isAddress": false,
"coinbase": "038f960e055b464881002f466f756e6472792055534120506f6f6c202364726f70676f6c642f7b13d7fa00002280abd80000"
}
],
"vout": [
{
"value": "317143553",
"n": 0,
"spent": true,
"hex": "00207086320071974eef5e72eaa01dd9096e10c0383483855ea6b344259c244f73c2",
"addresses": [
"bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38"
],
"isAddress": true
},
{
"value": "0",
"n": 1,
"hex": "6a24aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f",
"addresses": [
"OP_RETURN aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f"
],
"isAddress": false
}
],
"blockHash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
"blockHeight": 956047,
"confirmations": 5283,
"blockTime": 1782808904,
"size": 227,
"vsize": 200,
"value": "317143553",
"valueIn": "0",
"fees": "0",
"hex": "020000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff32038f960e055b464881002f466f756e6472792055534120506f6f6c202364726f70676f6c642f7b13d7fa00002280abd80000feffffff02013ae712000000002200207086320071974eef5e72eaa01dd9096e10c0383483855ea6b344259c244f73c20000000000000000266a24aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f012000000000000000000000000000000000000000000000000000000000000000008e960e00"
}
}Get transaction specific
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "8",
"method": "getTransactionSpecific",
"params": {
"txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a"
}
}Response: 200
Copied!
{
"id": "8",
"data": {
"txid": "e1e372f70f639a800e4b77c1b45d26f84daa4d82ef8243ebb6b0a31e2921ad2a",
"hash": "c27bf43da318469ec129c6fb39f86a2b4d1d80718548e4977502c523ccbbf9b0",
"version": 2,
"size": 227,
"vsize": 200,
"weight": 800,
"locktime": 956046,
"vin": [
{
"coinbase": "038f960e055b464881002f466f756e6472792055534120506f6f6c202364726f70676f6c642f7b13d7fa00002280abd80000",
"txinwitness": [
"0000000000000000000000000000000000000000000000000000000000000000"
],
"sequence": 4294967294
}
],
"vout": [
{
"value": 3.17143553,
"n": 0,
"scriptPubKey": {
"asm": "0 7086320071974eef5e72eaa01dd9096e10c0383483855ea6b344259c244f73c2",
"desc": "addr(bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38)#y9upg3rz",
"hex": "00207086320071974eef5e72eaa01dd9096e10c0383483855ea6b344259c244f73c2",
"address": "bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38",
"type": "witness_v0_scripthash"
}
},
{
"value": 0.0,
"n": 1,
"scriptPubKey": {
"asm": "OP_RETURN aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f",
"desc": "raw(6a24aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f)#9hmdp8d4",
"hex": "6a24aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f",
"type": "nulldata"
}
}
],
"hex": "020000000001010000000000000000000000000000000000000000000000000000000000000000ffffffff32038f960e055b464881002f466f756e6472792055534120506f6f6c202364726f70676f6c642f7b13d7fa00002280abd80000feffffff02013ae712000000002200207086320071974eef5e72eaa01dd9096e10c0383483855ea6b344259c244f73c20000000000000000266a24aa21a9ed56bd38dc043560d794a5d9af101f4654ca9d61ef7ca2fa901fc89aed3fed8e2f012000000000000000000000000000000000000000000000000000000000000000008e960e00",
"blockhash": "0000000000000000000160424415c96b888cc76a350b6f4218beef1caf1f71b3",
"confirmations": 5283,
"time": 1782808904,
"blocktime": 1782808904
}
}Estimate fee
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"9","method":"estimateFee","params":{"blocks":[2,6]}}Response: 200
Copied!
{
"id": "9",
"data": [
{
"feePerUnit": "2115"
},
{
"feePerUnit": "1070"
}
]
}Get long term fee rate
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"10","method":"longTermFeeRate","params":{}}Response: 200
Copied!
{
"id": "10",
"data": {
"feePerUnit": "100",
"blocks": 1008
}
}Get block filter
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "23",
"method": "getBlockFilter",
"params": {
"scriptType": "",
"blockHash": "000000000000000000010538edbfd2d5b809a33dd83f284aeea41c6d0d96968a"
}
}Response: 200
Copied!
{
"id": "23",
"data": {
"P": 0,
"M": 1,
"zeroedKey": false,
"blockFilter": ""
}
}Compact block filters are not built on this endpoint, so
blockFiltercomes back empty andPis 0. SendscriptTypeempty, as no script type is configured.
Get mempool filters
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"24","method":"getMempoolFilters","params":{"scriptType":"","mempool":true}}Response: 200
Copied!
{
"id": "24",
"data": {
"P": 0,
"M": 1,
"zeroedKey": false,
"entries": {}
}
}Mempool filters are not built on this endpoint, so
entriescomes back empty.
Send transaction
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"11","method":"sendTransaction","params":{"hex":"<signed raw transaction hex>"}}Response: 200
Copied!
{
"id": "11",
"data": {
"result": "622ed4e93b25fdb699115ed5a698f410ddeddd7aa7d5e835762905425d2a6de3"
}
}A transaction the backend rejects returns an error object instead, for example
{"id":"11","data":{"error":{"message":"-22: TX decode failed. Make sure the tx has at least one input."}}}.
Get fiat rates for timestamps
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "12",
"method": "getFiatRatesForTimestamps",
"params": {
"timestamps": [
1710000000
],
"currencies": [
"usd"
]
}
}Response: 200
Copied!
{
"id": "12",
"data": {
"tickers": [
{
"ts": 1754179200,
"rates": {
"usd": 112572.125
}
}
]
}
}Get fiat rates for tickers list
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"13","method":"getFiatRatesTickersList","params":{"timestamp":1710000000}}Response: 200
Copied!
{
"id": "13",
"data": {
"ts": 1754179200,
"available_currencies": [
"aed",
"ars"
]
}
}Get current fiat rates
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"14","method":"getCurrentFiatRates","params":{"currencies":["usd"]}}Response: 200
Copied!
{
"id": "14",
"data": {
"ts": 1786045500,
"rates": {
"usd": 64369
}
}
}Subscribe new block
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"15","method":"subscribeNewBlock","params":{}}Response: 200
Copied!
{
"id": "15",
"data": {
"subscribed": true
}
}Unsubscribe new block
Copied!wss://btc.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://btc.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://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"18","method":"unsubscribeNewTransaction","params":{}}Response: 200
Copied!
{
"id": "18",
"data": {
"subscribed": false
}
}Subscribe address
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "19",
"method": "subscribeAddresses",
"params": {
"addresses": [
"bc1qwzrryqr3ja8w7hnja2spmkgfdcgvqwp5swz4af4ngsjecfz0w0pqud7k38"
]
}
}Response: 200
Copied!
{
"id": "19",
"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://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"20","method":"unsubscribeAddresses","params":{}}Response: 200
Copied!
{
"id": "20",
"data": {
"subscribed": false
}
}Subscribe new fiat rates
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"21","method":"subscribeFiatRates","params":{"currency":"usd"}}Response: 200
Copied!
{
"id": "21",
"data": {
"subscribed": true
}
}Unsubscribe new fiat rates
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"22","method":"unsubscribeFiatRates","params":{}}Response: 200
Copied!
{
"id": "22",
"data": {
"subscribed": false
}
}Get block
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"25","method":"getBlock","params":{"id":"900000","page":1}}Response: 200
Copied!
{
"id": "25",
"data": {
"error": {
"message": "Not supported"
}
}
}Not supported on this endpoint. This method requires the extended index, which is not enabled on this endpoint.
Get block filters batch
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "26",
"method": "getBlockFiltersBatch",
"params": {
"scriptType": "",
"bestKnownBlockHash": "000000000000000000010538edbfd2d5b809a33dd83f284aeea41c6d0d96968a",
"pageSize": 2
}
}Response: 200
Copied!
{
"id": "26",
"data": {
"error": {
"message": "Not supported"
}
}
}Not supported on this endpoint. Compact block filters are not built on this endpoint.
Get contract info
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{
"id": "27",
"method": "getContractInfo",
"params": {
"contract": "0x0000000000000000000000000000000000000001"
}
}Response: 200
Copied!
{
"id": "27",
"data": {
"error": {
"message": "getContractInfo is not supported on this coin"
}
}
}Available on Ethereum-type networks only. Bitcoin has no contract layer.
RPC call
Copied!wss://btc.nownodes.io/wss/{{api_key}}
Body
Copied!
{"id":"28","method":"rpcCall","params":{"method":"getblockcount","params":[]}}Response: 200
Copied!
{
"id": "28",
"data": {
"error": {
"message": "not supported"
}
}
}Available on Ethereum-type networks only.