ChainPulse

March 21, 2026 · View on GitHub

CI License: MIT Python 3.10+ PyPI

15 minutes of manual research → 5 seconds in your terminal.

ChainPulse is an AI-powered CLI that answers questions about the Bitcoin network using real-time on-chain data. Ask in plain English, get structured analysis.

$ chainpulse "What's happening with fees right now?"

╭─────────────────────── ⚡ ChainPulse ────────────────────────╮
│                                                              │
│  ## Current Fee Rates                                        │
│                                                              │
│  | Priority    | Target  | Fee Rate   |                      │
│  |-------------|---------|------------|                      │
│  | Next block  | 1 block | 12.3 sat/vB|                      │
│  | Normal      | 3 block | 8.1 sat/vB |                      │
│  | Economy     | 6 block | 4.2 sat/vB |                      │
│  | Low         | 25 block| 2.0 sat/vB |                      │
│                                                              │
│  **Recommendation:** Fees are moderate. A typical 1-in/2-out │
│  SegWit transaction costs ~1,700 sats (\$1.80) at normal      │
│  priority. The mempool is clearing — waiting 2-3 blocks       │
│  could save ~40%.                                            │
│                                                              │
╰────────────── Data: bitcoinsapi.com · block 939,462 ─────────╯

Install

pip install chainpulse

Setup

You need an Anthropic API key:

export ANTHROPIC_API_KEY=sk-ant-...

Verify everything works:

chainpulse --check
# ✓ API key valid, Satoshi API reachable (block 939,462)

Usage

Single Query

chainpulse "Should I send my transaction now or wait?"
chainpulse "Give me a complete network health check"
chainpulse "How congested is the mempool?"

Interactive Mode

chainpulse -i

╭─── ⚡ ChainPulse Interactive Mode ───╮
│ Ask anything about the Bitcoin        │
│ network. Type quit to exit.           │
╰──────────────────────────────────────╯

chainpulse> What's the current hashrate?
  → Fetching Mining Info...
  → Analyzing...

  [response panel]

chainpulse> quit

How It Works

  1. You ask a question in plain English
  2. An AI agent selects the right on-chain data sources
  3. Real-time data is fetched from the Bitcoin network
  4. The agent synthesizes a structured analysis
  5. Rich terminal output makes it screenshot-worthy

10 built-in data sources: fee estimates, fee recommendations, fee landscape analysis, mempool stats, mempool analysis, latest block, BTC price, mining stats, supply data, and network info.

Configuration

VariableRequiredDefaultDescription
ANTHROPIC_API_KEYYes—Your Anthropic API key
CHAINPULSE_API_URLNohttps://bitcoinsapi.comCustom API endpoint
CHAINPULSE_MODELNoclaude-sonnet-4-20250514Anthropic model to use

Example Queries

Fees & Timing

  • "What are current fee rates?"
  • "Should I send now or wait?"
  • "How much would a 2-input transaction cost?"

Network Health

  • "Full network health check"
  • "Current hashrate and difficulty"
  • "When is the next halving?"

Mempool

  • "How congested is the mempool?"
  • "What's the next-block minimum fee?"

Market + On-Chain

  • "Bitcoin price with network context"
  • "Is this a good time to consolidate UTXOs?"

Development

git clone https://github.com/Bortlesboat/chainpulse
cd chainpulse
pip install -e ".[dev]"
pytest
ruff check src/ tests/

Contributing

Pull requests welcome. Please open an issue first to discuss major changes.

  1. Fork the repo
  2. Create your feature branch
  3. Run tests: pytest
  4. Submit a PR
  • bitcoin-mcp — MCP server with 49 Bitcoin tools for AI agents
  • Satoshi API — Bitcoin fee intelligence API
  • BAIP-1 — Bitcoin Agent Identity Protocol

License

MIT

For informational purposes only. Not financial advice.