🇬🇧 English · 🇩🇪 Deutsch
Current version: v0.5.9.3
Mempool Watch is a custom Home Assistant integration for monitoring the Bitcoin network through your local Mempool instance or mempool.space.
Privacy: Do not enter BTC addresses when using a public Mempool instance.
- 18 core sensors + 14 optional sensors (fees, mempool, difficulty, hashrate, mining, price)
- Multiple BTC price entities (select multiple fiat currencies)
- Unlimited Bitcoin addresses (confirmed + pending balances)
- SSL / custom CA certificate (Umbrel, Start9, …)
- btc-address-card Lovelace Card included! No separate installation or additional download required!
- HACS → Integrations → Custom repositories
- Add
https://github.com/jinx-22/mempool_watch(Category: Integration) - Install Mempool Watch → Restart Home Assistant
- Settings → Devices & services → Add Integration → Mempool Watch
Copy the mempool_watch folder to /config/custom_components/, restart Home Assistant, and then add the integration through the user interface.
UI only — no YAML required.
Setup: Instance URL, update interval (5–600 s, default 60 s), SSL certificate verification, optional CA certificate (PEM), and fiat currencies.
Later in Options: Settings, currencies, and Bitcoin addresses can be added or removed at any time.
| Sensor | Description | Example |
|---|---|---|
| Average Block Fees (144 Blocks) | Average block fees over the last 144 blocks | 0.02134933 BTC |
| Average TX Fee (144 Blocks) | Average transaction fee over the last 144 blocks | 496 sats |
| Block Height | Current blockchain height | 964019 |
| BTC Price | BTC price (USD) | 79,296 USD |
| Difficulty Adjustment Estimate | Estimated next difficulty adjustment | -0.79 % |
| Difficulty Adjustment Progress | Progress toward the next retarget | 18.4 % |
| Blocks Remaining Until Difficulty Adjustment | Blocks remaining until the next retarget | 1,645 blocks |
| Economy Fee | Fee for low-priority transactions | 1 sat/vB |
| Fastest Fee | Fee for the next block | 3 sat/vB |
| Half-Hour Fee | Fee for confirmation in approximately 30 minutes | 3 sat/vB |
| Hour Fee | Fee for confirmation in approximately 1 hour | 1 sat/vB |
| Latest Block Miner | Miner / pool of the latest block | ViaBTC |
| Mempool Size | Current mempool size | 42,485,511 vB |
| Mempool TX Count | Number of unconfirmed transactions | 84,930 |
| Minimum Fee | Lowest fee currently in the mempool | 1 sat/vB |
| Network Difficulty | Current network difficulty | 125,807,076,547,198 |
| Network Hashrate | Estimated network hashrate | 872.60 EH/s |
| Total Miner Rewards (144 Blocks) | Total miner rewards over the last 144 blocks | 453.0743 BTC |
Enable these sensors in the Entity Registry if required:
| Sensor | Description |
|---|---|
| Total Mempool Fees | Total fees currently contained in the mempool |
| Time Remaining Until Difficulty Adjustment | Hours until the next retarget |
| Previous Difficulty Retarget | Previous difficulty adjustment (%) |
| Next Retarget Height | Block height of the next retarget |
| Average Block Time | Average block time (min.) |
| Last Block TX Count / Size / Weight | Details of the latest block |
| Last Block Median Fee / Total Fees / Reward | Fees and reward of the latest block |
| Next Block Median Fee / TX Count | Projected next mempool block |
| Projected Mempool Blocks | Number of projected blocks |
USD is always available. During setup or in the integration options, you can select one or more additional fiat currencies. A separate BTC price entity is created for each selected currency.
Supported (depending on the response from your Mempool instance at /api/v1/prices):
EUR GBP CAD CHF AUD JPY
With API key:
CNY INR BRL KRW TRY PLN SEK NOK DKK CZK HUF ILS MXN SGD HKD NZD ZAR RUB THB TWD PHP IDR MYR VND
Note: An API key is required for additional fiat currencies. The API key must be configured in your Mempool instance under
FIAT_PRICE → API_KEY.
Add as many Bitcoin addresses as you like. Each address creates its own entity with:
| Attribute | Description |
|---|---|
confirmed_balance |
Confirmed on-chain balance |
pending_incoming |
Unconfirmed incoming balance |
pending_outgoing |
Unconfirmed outgoing balance |
pending_change |
Net change of the pending balance (incoming − outgoing) |
unconfirmed_count |
Number of unconfirmed transactions |
address |
Full Bitcoin address |
Pending Change: Positive = more pending BTC incoming, negative = more pending BTC outgoing.
Dedicated Lovelace Card for BTC address sensors, available in the Card Picker:
INFO here: btc-address-card
Please provide the following information:
- Home Assistant version
- Mempool Watch version
- Relevant logs
- Steps to reproduce the issue
⚡ Address:
usefulplay52@walletofsatoshi.com
bc1qkz7mtp23cmshxnru96lzgeayu0urlysvqk5vry
Thank you for your support — even a free ⭐ helps others discover the project:
Apache License 2.0 — see LICENSE.
Independent open-source project. Not an official product of mempool.space, Home Assistant, or any other third party. Use at your own risk.