Get compact block filters.

GET

https://ethw-blockbook.nownodes.io/api/v2/block-filters

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns compact block filters for the script type configured on this Blockbook instance. Provide either lastN or a from/to range. When to is omitted for a range, the current best height is used.

Load estimate: High for wide ranges; work and payload grow linearly with the number of requested filters.

live-verified behavior:

Neither deployed build routes this path: requests fall through to the /api/ index handler and return HTTP 200 with the status object (live capture, both scriptType=taproot and empty).
Compact block filters are a Bitcoin-chain feature and are not configured on EthereumPoW.

Parameters

scriptTypestringrequiredquery

Script type configured for block filters on this instance, for example taproot.

lastNinteger>= 1query

Return filters for the last N blocks.

frominteger>= 0query

First block height in the requested range.

tointeger>= 0query

Last block height in the requested range. Defaults to the current best height when omitted.

Response

200OK

Block filters keyed by block height.

401Unauthorized

Missing or invalid API key (plain text).

Get compact block filters.

curl -X GET 'https://ethw-blockbook.nownodes.io/api/v2/block-filters/'

const response = await fetch('https://ethw-blockbook.nownodes.io/api/v2/block-filters/', {
  method: 'GET',
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ethw-blockbook.nownodes.io/api/v2/block-filters/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://ethw-blockbook.nownodes.io/api/v2/block-filters/')
data = response.json()

const response = await fetch('https://ethw-blockbook.nownodes.io/api/v2/block-filters/', {
  method: 'GET',
});

const data = await response.json();

const endpoint = "https://ethw-blockbook.nownodes.io/api/v2/block-filters/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

const response = await fetch('https://ethw-blockbook.nownodes.io/api/v2/block-filters/', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://ethw-blockbook.nownodes.io/api/v2/block-filters/')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ethw-blockbook.nownodes.io/api/v2/block-filters/')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

{
  "P": 19,
  "M": 784931,
  "zeroedKey": false,
  "blockFilters": {
    "24975125": {
      "blockHash": "0xdf60edce09b12e1340d6a1b21926ccaafbbc1c4a5196708520455dde2ce96cc0",
      "filter": ""
    }
  }
}

{
  "blockbook": {
    "coin": "Ethereum PoW",
    "host": "1e4485eb5a6f",
    "version": "devel",
    "gitCommit": "89431f5",
    "buildTime": "2022-09-16T11:21:44+00:00",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 24975124,
    "lastBlockTime": "2026-09-01T18:20:55.114820285Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-09-01T18:20:11.137064755Z",
    "mempoolSize": 11,
    "decimals": 18,
    "dbSize": 281969362509,
    "about": "Blockbook - blockchain indexer for Trezor wallet https://trezor.io/. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 24975124,
    "bestBlockHash": "0x73e34bc8810177be2323c7eae29b48aa12d506eb208c3a26f112120661cff4c5",
    "difficulty": "27188762399451",
    "version": "Geth/v1.10.23-stable-f78489ad/linux-amd64/go1.19"
  }
}

Unknown API_key