Crypto Payments

NBXplorer for WindowsUTXO Tracker for HD Wallets

What NBXplorer does, how to install it, how it compares with BTCPay Server, and the safety steps to take before running it.

Free Open source Windows: Yes v5.0.12 Updated 29 Oct 2026
10 min read Last update 29 Oct 2026 github.com/btcpayserver/NBXplorer

NBXplorer is an open-source UTXO tracker for HD cryptocurrency wallets, written in C#/.NET and released under the MIT license. It is built for developers and operators who run payment or wallet infrastructure and need a lightweight service that follows incoming and outgoing coins across wallet addresses derived from an extended public key. The program is free to use.

The project is aimed at people who run servers, not at everyday desktop users. Its most common setup is Docker, although a Windows build or installer is also available. The latest tagged release is Client/v5.0.12, and the code has seen recent updates, so this is not a legacy project. Because the service works with public wallet data rather than private keys, its main security questions concern how you expose its API and database. Read on for installation steps, a safety checklist and a comparison with similar tools.

02

What Is NBXplorer and Who Is It For?

NBXplorer sits in the background of a wallet or payment system. Its job is to watch addresses that belong to a hierarchical deterministic wallet and report which unspent outputs and transactions are associated with them. Applications can then ask the service what they need instead of scanning the blockchain themselves.

The typical audience is a small team building a checkout flow, a bookkeeping tool or a wallet backend. A solo developer testing a Bitcoin integration can also use it on a laptop. Casual users who only want to send and receive coins in a mobile wallet will find it too low-level, because the project does not provide a finished consumer interface.

The scope is deliberately narrow. NBXplorer tracks data and exposes it through an API, and it leaves decisions about invoices, accounting rules and user accounts to the application that uses it. That separation is the reason many developers find it easier to reason about than a larger all-in-one stack.

03

How UTXO Tracking Works in Practice

Bitcoin does not store balances the way a bank account does. Instead, each payment creates unspent transaction outputs, usually called UTXOs, and a wallet's balance is the sum of the outputs it can still spend. A tracker has to find every output that belongs to a wallet and remember when it is spent.

HD wallets make this harder. A single extended public key, often written as an xpub, can produce a long sequence of addresses. A tracker must know the derivation scheme, meaning the rules that turn the key into addresses, and then scan forward through that sequence. If it scans too little, new payments may be missed. If it scans too much, it wastes time and storage.

This is why the derivation and tracked-source settings matter. Getting them right at the start avoids a later rescan, which can be slow on a busy chain. When you understand this model, the API responses become easier to interpret, because each figure corresponds to a set of outputs rather than a single account entry.

04

Real-World Use Cases for Merchants and Developers

A shop that accepts Bitcoin needs to know, for each invoice, whether the matching payment has arrived and how many confirmations it has. An application can register the store's extended public key with NBXplorer and poll the API for new outputs. The shop's own software then decides when an order is paid.

Another common case is a bookkeeping or reporting tool. It can read transaction history through the API or, where appropriate, query the documented PostgreSQL schema to build monthly summaries. Developers testing wallet logic can also use the service on a test network setup to check that their address generation matches what the tracker sees.

A third scenario is an internal operations dashboard. A treasury team can monitor a set of watched wallets and be alerted when outputs move. Because NBXplorer is a backend component, the dashboard would still need its own access controls, and the team should avoid exposing the raw API to the public internet.

05

Key features

Operator Guide for Installation and Rescanning

The operator documentation covers installing the service, configuring it, choosing which blockchains it follows, and rescanning when wallet history needs to be rebuilt. This is the starting point for anyone who will run NBXplorer on their own machine or server. Reading it first saves time, because most setup questions are answered in one place.

Integrator Guide for Tracked Sources and Authentication

Developers who connect an application to NBXplorer get a dedicated guide to tracked sources, derivation schemes, authentication and the available client libraries. It shows how to define what the service should watch and how to request access securely. Use it to decide what your application must register before it starts querying balances.

REST API Reference

A reference for endpoints and data schemas lets your code query wallet and UTXO state over HTTP. Having the request and response formats in one place makes it easier to write typed clients and test edge cases. It is the document you will keep open while building an integration.

Documented PostgreSQL Schema

The project documents its PostgreSQL schema for direct database access. This matters if you need reporting queries, custom analytics or backups that go beyond what the API exposes. Treat direct access with care, because changes made outside the service can confuse its tracking state.

Contributing Guide for Building and Testing

The contributing guide explains how to build the project from source, run its tests and add support for new chains. It is mainly useful to developers who want to extend NBXplorer or fix a bug. Most Windows users will never need it, since they install a ready-made build.
06

Supported coins

The project documentation names Bitcoin (BTC) as the chain covered in its current guides. The operator guide includes a section on supported chains, so check it before planning a deployment that needs another network. The contributing guide describes how developers can add support for additional chains.

07

How to install Nbxplorer on Windows

  1. 1

    Choose your installation method

    Decide between the Docker route and the Windows build. The project lists Docker as its platform and also offers a Windows build or installer, so pick the one that fits your server setup. For a service that runs continuously, a container keeps its dependencies isolated from the rest of your system.

  2. 2

    Download from the official source

    Download only from the official website or from the GitHub Releases page of the project at github.com/btcpayserver/NBXplorer. The latest tagged release listed for the project is Client/v5.0.12. Avoid mirrors and file-sharing sites, even if they appear high in search results.

  3. 3

    Verify the file before running it

    Compare the SHA-256 checksum of the downloaded file with the value published alongside the release, or verify the signature if one is provided. Do not run an installer or archive whose hash does not match. This quick check catches corrupted downloads and tampered files.

  4. Install and configure the service

    Run the installer or start the container, then work through the operator guide to set the network, data directory and database connection. Confirm that the service responds on its configured address before connecting any application. Keep the API off the public internet unless you have placed it behind proper access controls.

08

System requirements

  • Docker, the platform the project lists for running NBXplorer
  • A Windows build or installer is also offered for Windows machines
09

How to use Nbxplorer

NBXplorer is not a point-and-click desktop app, so the workflow is more like setting up a small service. The steps below describe a typical test run on a single machine, where you track a wallet you control and read its data through the API.

  1. Start the service and confirm it is running. Use the Docker container or the Windows build, then check that the service answers on its local address.
  2. Open the REST API reference and find the endpoint for registering a tracked source.
  3. Register a derivation scheme based on an extended public key you control. Never submit a seed phrase or private key; the service only needs public data.
  4. Let the service scan the chain. If the wallet has older history that did not appear, run a rescan as described in the operator guide.
  5. Query the balance and transaction endpoints from a simple script or your application.
  6. Compare the results with a block explorer for the same addresses. Matching figures confirm that your derivation settings are correct.
  7. Review the logs and the database size regularly, so you can spot problems early.

Once the test run works, you can move the same configuration to a production server and add authentication for your application.

10

Pros & cons

Pros
  • Free to use and released under the MIT license
  • Open source code that anyone can review
  • Small, focused scope that does one job well
  • Documentation split by audience: operators, integrators and contributors
  • Recent code activity and tagged releases
Cons
  • Aimed at developers and operators rather than casual desktop users
  • Docker is the listed platform, so Windows-only setups may need extra steps
  • Bitcoin (BTC) is the only chain named in the current documentation
  • You are responsible for securing the server, the API and the database
11

Is Nbxplorer safe?

NBXplorer works with public wallet data, but a misconfigured tracker can still expose your financial activity. Download only from the official website or the GitHub Releases page, and verify the SHA-256 checksum or signature before running anything. Check the official site for the latest version before you install. Never enter a seed phrase or private key on any third-party website, and never give one to a service that asks for it; an extended public key is the only key material a tracker needs. Keep the API and PostgreSQL database off the public internet, use strong credentials, and restrict access to the machine that runs the service.

  • Official source only. Download from github.com/btcpayserver/NBXplorer. Ignore ads and lookalike domains.
  • Check the SHA-256. Compare the installer hash with the value the developer publishes before running it.
  • Never share your seed phrase. No developer, support agent or website — including CryptApps — will ever ask for it.
12

Alternatives

NBXplorer is best understood as a component rather than a finished product. BTCPay Server is a self-hosted platform for accepting payments in Bitcoin and Lightning, with a full interface for merchants. Btcpayserver Docker is a deployment package aimed at getting that platform running on a server. Crypto Terminal takes a different route: it is an open-source terminal application for accepting in-person cryptocurrency payments.

NBXplorer is narrower than all three. It does not provide storefronts, invoices or point-of-sale screens. It tracks wallet outputs and exposes them through an API. If you need a complete payment system, a platform like BTCPay Server is the better starting point. If you are building your own backend and want only the tracking layer, NBXplorer is the more focused choice.

13

Specifications

Price
Free
Type
Open source
License
MIT
Latest version
Client/v5.0.12
Last update
29 Oct 2026
Windows support
Yes (Windows build or installer)
Source code
github.com/btcpayserver/NBXplorer
14

Frequently asked questions

Yes. NBXplorer is free and released under the MIT license, which allows you to use, copy and modify the code. The license does not include support or hosting, so running the service and keeping it secure is your responsibility. Check the license text in the repository for the full terms before you build a commercial product around it.

Yes, the project offers a Windows build or installer. However, the platform the project lists is Docker, which many operators prefer for running a background service. You can choose either route. Docker keeps dependencies separate from your system, while the Windows build may suit a local test setup.

NBXplorer is open source and works with public wallet data, which reduces the risk compared with software that stores private keys. Safety still depends on your setup. Download it only from the official website or GitHub Releases, verify the checksum, and keep the API and database private. Never share a seed phrase with any tool.

A UTXO is an unspent transaction output, meaning a piece of Bitcoin that has been sent to an address and not yet spent. A wallet balance is the total of the UTXOs it controls. NBXplorer tracks these outputs so applications can see which payments belong to a wallet without scanning the chain themselves.

NBXplorer tracks the addresses derived from an extended public key, using a derivation scheme you define. It follows the outputs sent to those addresses and records when they are spent. The project documentation names Bitcoin (BTC) as the supported chain, so that is the network to plan around.

No. Docker is the platform the project lists, but a Windows build or installer is also available. Docker is useful when you want the service isolated from the rest of your system or deployed on a server. A Windows build can be simpler for a local test on a single computer.

BTCPay Server is a full self-hosted payment platform with a merchant interface, while NBXplorer is a narrower tracking service. NBXplorer does not provide invoices or storefronts. It exposes wallet data through an API that your application can use. Many developers consider it when they want to build their own backend rather than adopt a complete system.

15

Verdict

NBXplorer suits developers and operators who need a free, open-source service that tracks UTXOs for HD wallets and exposes the results through an API. It rewards careful setup and a clear understanding of Bitcoin's output model. It is not a good fit for someone who wants a simple app to send and receive coins. If you run it, treat the server, the API and the database as production infrastructure, and keep the software updated from official sources.

Download now