mempool-watch
Bitcoin mempool monitoring — check transaction confirmation status, retrieve address transaction history, and inspect current mempool state. Data sourced from mempool.space.
How do I install this agent skill?
npx skills add https://github.com/aibtcdev/skills --skill mempool-watchIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides read-only monitoring of the Bitcoin blockchain and mempool via the public mempool.space API. It does not require credentials, handle private keys, or perform any state-changing operations.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Mempool Watch Skill
Monitor the Bitcoin mempool and track on-chain activity using the mempool.space public API (no authentication required). Works on both mainnet and testnet.
Usage
bun run mempool-watch/mempool-watch.ts <subcommand> [options]
Subcommands
tx-status
Check the confirmation status of a Bitcoin transaction.
bun run mempool-watch/mempool-watch.ts tx-status --txid <txid>
Options:
--txid(required) — Bitcoin transaction ID to look up
Output:
{
"txid": "abc123...",
"network": "mainnet",
"confirmed": true,
"blockHeight": 880000,
"blockHash": "000000...",
"blockTime": "2026-01-01T00:00:00.000Z",
"confirmations": 42,
"explorerUrl": "https://mempool.space/tx/abc123..."
}
If unconfirmed:
{
"txid": "abc123...",
"network": "mainnet",
"confirmed": false,
"blockHeight": null,
"blockHash": null,
"blockTime": null,
"confirmations": 0,
"explorerUrl": "https://mempool.space/tx/abc123..."
}
address-history
Retrieve the transaction history for a Bitcoin address.
bun run mempool-watch/mempool-watch.ts address-history --address <addr> [--limit <n>]
Options:
--address(required) — Bitcoin address to look up--limit(optional) — Maximum number of transactions to return (default: 10, max: 25)
Output:
{
"address": "bc1q...",
"network": "mainnet",
"count": 3,
"transactions": [
{
"txid": "abc123...",
"confirmed": true,
"blockHeight": 880000,
"blockTime": "2026-01-01T00:00:00.000Z",
"fee": 1200,
"valueIn": 500000,
"valueOut": 498800,
"explorerUrl": "https://mempool.space/tx/abc123..."
}
],
"explorerUrl": "https://mempool.space/address/bc1q..."
}
mempool-stats
Get current Bitcoin mempool statistics including pending transaction count, backlog size, and fee histogram.
bun run mempool-watch/mempool-watch.ts mempool-stats
Output:
{
"network": "mainnet",
"pendingTransactions": 12400,
"pendingVsize": 8500000,
"totalFees": 120000000,
"recommendedFees": {
"fast": { "satPerVb": 15, "target": "~10 minutes (next block)" },
"medium": { "satPerVb": 8, "target": "~30 minutes" },
"slow": { "satPerVb": 3, "target": "~1 hour" },
"economy": { "satPerVb": 1, "target": "~24 hours" }
},
"feeHistogram": [[15, 200000], [8, 500000], [3, 1000000]]
}
Notes
- All subcommands use the public mempool.space API — no authentication or wallet required
- Defaults to testnet unless
NETWORK=mainnetis set confirmationsintx-statusis estimated from current block height minus the transaction's block heightaddress-historyreturns the most recent transactions first; mempool.space paginates viaafter_txidwhich is not exposed here — use--limitto control result size
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/aibtcdev/skills/mempool-watch">View mempool-watch on skillZs</a>