Home

BlockBook WSS 0.6.0

Get Info

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"1","method":"getInfo","params":{}}

Response: 200

Copied! 
{
    "id": "1",
    "data": {
        "name": "Avalanche",
        "shortcut": "AVAX",
        "network": "AVAX",
        "decimals": 18,
        "version": "0.6.0",
        "bestHeight": 92326210,
        "bestHash": "0xc2cb3b92abdd53ae617789fd102973ac05cb8c6172273faaca650b76fd1f92ec",
        "block0Hash": "",
        "testnet": false,
        "backend": {
            "version": "avalanchego/1.14.2"
        }
    }
}

Ping

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"2","method":"ping","params":{}}

Response: 200

Copied! 
{
    "id": "2",
    "data": {}
}

Get block hash

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"3","method":"getBlockHash","params":{"height":92325878}}

Response: 200

Copied! 
{
    "id": "3",
    "data": {
        "hash": "0x4ae8a0e330fd22a5b0f95adddd05dc038081011af751a92b0301f6b50ca2d1cf"
    }
}

Get account info

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "4",
  "method": "getAccountInfo",
  "params": {
    "descriptor": "0x04E1163225A09172f25530f8C552F8A76808A308",
    "details": "basic"
  }
}

Response: 200

Copied! 
{
    "id": "4",
    "data": {
        "address": "0x04E1163225A09172f25530f8C552F8A76808A308",
        "balance": "46631861418094886",
        "unconfirmedTxs": 0,
        "txs": 9,
        "nonTokenTxs": 8,
        "nonce": "72"
    }
}

Get account UTXO

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "5",
  "method": "getAccountUtxo",
  "params": {
    "descriptor": "0x04E1163225A09172f25530f8C552F8A76808A308"
  }
}

Response: 200

Copied! 
{
    "id": "5",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Get balance history

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "6",
  "method": "getBalanceHistory",
  "params": {
    "descriptor": "0x04E1163225A09172f25530f8C552F8A76808A308",
    "from": 1578391200,
    "to": 1578488400
  }
}

Response: 200

Copied! 
{
    "id": "6",
    "data": []
}

Get transaction

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "7",
  "method": "getTransaction",
  "params": {
    "txid": "0x4a4e1549aaa28a39f627b058c290ea7c4ee754fcc45270f0ec0e4d446e357ebe"
  }
}

Response: 200

Copied! 
{
    "id": "7",
    "data": {
        "txid": "0x4a4e1549aaa28a39f627b058c290ea7c4ee754fcc45270f0ec0e4d446e357ebe",
        "vin": [
            {
                "n": 0,
                "addresses": [
                    "0x978B21a854dbEFcD6d51DFd269875d158046240b"
                ],
                "isAddress": true
            }
        ],
        "vout": [
            {
                "value": "0",
                "n": 0,
                "addresses": [
                    "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7"
                ],
                "isAddress": true
            }
        ],
        "blockHash": "0x4ae8a0e330fd22a5b0f95adddd05dc038081011af751a92b0301f6b50ca2d1cf",
        "blockHeight": 92325878,
        "confirmations": 340,
        "blockTime": 1786196393,
        "value": "0",
        "fees": "134452481069834",
        "tokenTransfers": [
            {
                "type": "ERC20",
                "standard": "ERC20",
                "from": "0x978B21a854dbEFcD6d51DFd269875d158046240b",
                "to": "0x6785629d312cD25Bf9E619ce2c45A5af31F6E310",
                "contract": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
                "name": "TetherToken",
                "symbol": "USDt",
                "decimals": 6,
                "value": "12880000"
            }
        ],
        "ethereumSpecific": {
            "status": 1,
            "nonce": 897740,
            "gasLimit": 44404,
            "gasUsed": 44026,
            "gasPrice": "3053933609",
            "effectiveGasPrice": "3053933609",
            "maxPriorityFeePerGas": "3000000000",
            "maxFeePerGas": "66000000000",
            "baseFeePerGas": "53933609",
            "data": "0xa9059cbb0000000000000000000000006785629d312cd25bf9e619ce2c45a5af31f6e3100000000000000000000000000000000000000000000000000000000000c48880",
            "parsedData": {
                "methodId": "0xa9059cbb",
                "name": ""
            }
        }
    }
}

Get transaction specific

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "8",
  "method": "getTransactionSpecific",
  "params": {
    "txid": "0x4a4e1549aaa28a39f627b058c290ea7c4ee754fcc45270f0ec0e4d446e357ebe"
  }
}

Response: 200

Copied! 
{
    "id": "8",
    "data": {
        "tx": {
            "nonce": "0xdb2cc",
            "gasPrice": "0xb6075429",
            "maxPriorityFeePerGas": "0xb2d05e00",
            "maxFeePerGas": "0xf5de81400",
            "baseFeePerGas": "0x336f629",
            "gas": "0xad74",
            "to": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
            "value": "0x0",
            "input": "0xa9059cbb0000000000000000000000006785629d312cd25bf9e619ce2c45a5af31f6e3100000000000000000000000000000000000000000000000000000000000c48880",
            "hash": "0x4a4e1549aaa28a39f627b058c290ea7c4ee754fcc45270f0ec0e4d446e357ebe",
            "blockNumber": "0x580c7f6",
            "blockHash": "0x4ae8a0e330fd22a5b0f95adddd05dc038081011af751a92b0301f6b50ca2d1cf",
            "from": "0x978B21a854dbEFcD6d51DFd269875d158046240b",
            "transactionIndex": "0x0"
        },
        "receipt": {
            "gasUsed": "0xabfa",
            "effectiveGasPrice": "0xb6075429",
            "status": "0x1",
            "logs": [
                {
                    "address": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
                    "topics": [
                        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                        "0x000000000000000000000000978b21a854dbefcd6d51dfd269875d158046240b"
                    ],
                    "data": "0x0000000000000000000000000000000000000000000000000000000000c48880"
                }
            ]
        }
    }
}

Estimate fee

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"9","method":"estimateFee","params":{"blocks":[2,6]}}

Response: 200

Copied! 
{
    "id": "9",
    "data": [
        {
            "feePerTx": "2853853670430",
            "feePerUnit": "53052510",
            "feeLimit": "53793"
        },
        {
            "feePerTx": "2853853670430",
            "feePerUnit": "53052510",
            "feeLimit": "53793"
        }
    ]
}

Get long term fee rate

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"10","method":"longTermFeeRate","params":{}}

Response: 200

Copied! 
{
    "id": "10",
    "data": {
        "error": {
            "message": "not supported"
        }
    }
}

Get block filter

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "11",
  "method": "getBlockFilter",
  "params": {
    "scriptType": "",
    "blockHash": "4ae8a0e330fd22a5b0f95adddd05dc038081011af751a92b0301f6b50ca2d1cf"
  }
}

Response: 200

Copied! 
{
    "id": "11",
    "data": {
        "P": 0,
        "M": 1,
        "zeroedKey": false,
        "blockFilter": ""
    }
}

Compact block filters are not built on this endpoint, so blockFilter comes back empty and P is 0. Send scriptType empty, as no script type is configured.

Get mempool filters

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"12","method":"getMempoolFilters","params":{"scriptType":"","mempool":true}}

Response: 200

Copied! 
{
    "id": "12",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Mempool filters are not built on this endpoint, so entries comes back empty.

Send transaction

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"13","method":"sendTransaction","params":{"hex":"<signed raw transaction hex>"}}

Response: 200

Copied! 
{
    "id": "13",
    "data": {
        "result": "0x4a4e1549aaa28a39f627b058c290ea7c4ee754fcc45270f0ec0e4d446e357ebe"
    }
}

A transaction the backend rejects returns an error object instead, for example {"id": "13", "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://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "14",
  "method": "getFiatRatesForTimestamps",
  "params": {
    "timestamps": [
      1578391200
    ],
    "currencies": [
      "usd"
    ]
  }
}

Response: 200

Copied! 
{
    "id": "14",
    "data": {
        "tickers": [
            {
                "ts": 1748822400,
                "rates": {
                    "usd": 20.882236
                }
            }
        ]
    }
}

Get fiat rates for tickers list

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"15","method":"getFiatRatesTickersList","params":{"timestamp":1578391200}}

Response: 200

Copied! 
{
    "id": "15",
    "data": {
        "ts": 1748822400,
        "available_currencies": [
            "aed",
            "ars"
        ]
    }
}

Get current fiat rates

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"16","method":"getCurrentFiatRates","params":{"currencies":["usd"]}}

Response: 200

Copied! 
{
    "id": "16",
    "data": {
        "ts": 1786195075,
        "rates": {
            "usd": 6.52
        }
    }
}

Subscribe new block

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"17","method":"subscribeNewBlock","params":{}}

Response: 200

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

Unsubscribe new block

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"18","method":"unsubscribeNewBlock","params":{}}

Response: 200

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

Subscribe new transaction

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"19","method":"subscribeNewTransaction","params":{}}

Response: 200

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

Unsubscribe new transaction

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"20","method":"unsubscribeNewTransaction","params":{}}

Response: 200

Copied! 
{
    "id": "20",
    "data": {
        "subscribed": false
    }
}

Subscribe address

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "21",
  "method": "subscribeAddresses",
  "params": {
    "addresses": [
      "0x04E1163225A09172f25530f8C552F8A76808A308"
    ]
  }
}

Response: 200

Copied! 
{
    "id": "21",
    "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://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"22","method":"unsubscribeAddresses","params":{}}

Response: 200

Copied! 
{
    "id": "22",
    "data": {
        "subscribed": false
    }
}

Subscribe new fiat rates

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"23","method":"subscribeFiatRates","params":{"currency":"usd"}}

Response: 200

Copied! 
{
    "id": "23",
    "data": {
        "subscribed": true
    }
}

Unsubscribe new fiat rates

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"24","method":"unsubscribeFiatRates","params":{}}

Response: 200

Copied! 
{
    "id": "24",
    "data": {
        "subscribed": false
    }
}

Get block

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{"id":"25","method":"getBlock","params":{"id":"92325878","page":1}}

Response: 200

Copied! 
{
    "id": "25",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Not supported on this endpoint. Account-based networks have no per-block transaction index for this method.

Get block filters batch

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "26",
  "method": "getBlockFiltersBatch",
  "params": {
    "scriptType": "",
    "bestKnownBlockHash": "4ae8a0e330fd22a5b0f95adddd05dc038081011af751a92b0301f6b50ca2d1cf",
    "pageSize": 2
  }
}

Response: 200

Copied! 
{
    "id": "26",
    "data": {
        "error": {
            "message": "Not supported"
        }
    }
}

Not supported on this endpoint. Compact block filters are not built.

Get contract info

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "27",
  "method": "getContractInfo",
  "params": {
    "contract": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7"
  }
}

Response: 200

Copied! 
{
    "id": "27",
    "data": {
        "type": "ERC20",
        "standard": "ERC20",
        "contract": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
        "name": "TetherToken",
        "symbol": "USDt",
        "decimals": 6,
        "rates": {
            "baseRate": 0.15329095721244812
        },
        "blockHeight": 92326247
    }
}

RPC call

Copied! 
wss://avax-blockbook.nownodes.io/wss/{{api_key}}

Body

Copied! 
{
  "id": "28",
  "method": "rpcCall",
  "params": {
    "to": "0x9702230A8Ea53601f5cD2dc00fDBc13d4dF4A8c7",
    "data": "0x18160ddd"
  }
}

Response: 200

Copied! 
{
    "id": "28",
    "data": {
        "data": "0x000000000000000000000000000000000000000000000000000690061011766a"
    }
}

Passthrough for eth_call: send the contract address in to and the ABI-encoded call in data. The example above calls totalSupply().