Bitcoin Api

Satoshi API

Stop overpaying Bitcoin fees. Know when to send.

[](https://github.com/Bortlesboat/bitcoin-api/actions/workflows/ci.yml) [](https://pypi.org/project/satoshi-api/) [](https://pypi.org/project/satoshi-api/) [](https://www.python.org/downloads/) [](LICENSE) [](https://bitcoinsapi.com) [](https://opensats.org)

Live Playground · Landing Page · PyPI · MCP Server · Discord Bot

---

Live at bitcoinsapi.com · MCP-ready · x402 pay-per-call · Apache 2.0

---

Bad fee timing burns sats on every Bitcoin transaction. Satoshi API tells you when to send, what to pay, and whether to wait — combining multiple estimatesmartfee targets with real-time mempool state. Instead of just "4 sat/vB", you get "Fees are low. Good time to send." One pip install, self-hostable, open source.

Install & Run

pip install satoshi-api
export BITCOIN_RPC_USER=your_user BITCOIN_RPC_PASSWORD=your_password
satoshi-api
# API:  http://localhost:9332
# Docs: http://localhost:9332/docs

Example

curl http://localhost:9332/api/v1/fees/recommended | jq

{
  "data": {
    "recommendation": "Fees are low. Good time to send.",
    "estimates": { "high": 4, "medium": 2, "low": 1 }
  },
  "meta": { "timestamp": "...", "node_height": 939462, "chain": "main" }
}

Core Endpoints

| Category | Example paths | Highlights | |----------|---------------|------------| | Fees | /api/v1/fees/recommended, /api/v1/fees/plan | Recommendations, landscape ("send now or wait?"), history, mempool-blocks | | Transactions | /api/v1/tx/{txid}, /api/v1/broadcast | Decoded analysis, status, outspends, UTXO lookup, broadcast | | Mempool | /api/v1/mempool, /api/v1/mempool/recent | Congestion score, fee buckets, recent entries | | Blocks | /api/v1/blocks/latest, /api/v1/blocks/{height_or_hash} | Latest block, by height/hash, stats, txids, header | | Mining | /api/v1/mining, /api/v1/mining/nextblock | Hashrate, difficulty, next block template | | Network | /api/v1/network, /api/v1/network/difficulty | Peers, forks, difficulty, address validation | | Streams | /api/v1/stream/blocks, /api/v1/stream/fees | Real-time blocks & fees via SSE |

...and more (prices, address lookups, exchange comparison). Full interactive docs at /docs.

For AI Agents

bitcoin-mcp — the first Bitcoin MCP server on the official Anthropic MCP Registry — lets AI agents check fees, verify payments, and monitor addresses without human babysitting. Saves developer time: no custom Bitcoin plumbing needed.

# Install and point at your Satoshi API instance
pip install bitcoin-mcp
SATOSHI_API_URL=https://bitcoinsapi.com bitcoin-mcp

Or connect to a local node directly:

{
  "mcpServers": {
    "bitcoin": { "command": "bitcoin-mcp" }
  }
}

For repo-native agent instructions, use [docs/AGENTINTEGRATION.md](docs/AGENTINTEGRATION.md). It includes copy-paste snippets for AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, Cursor/Windsurf rules, MCP config, and x402 paid calls.

For keyless premium calls, start at bitcoinsapi.com/x402/start. The paid flow is: discover /.well-known/x402, request a paid /api/v1 endpoint, read PAYMENT-REQUIRED, then retry with PAYMENT-SIGNATURE.

Self-Hosting

pip install satoshi-api
satoshi-api  # runs on :9332

# Expose publicly (free HTTPS + DDoS protection)
cloudflared tunnel --url http://localhost:9332

See [self-hosting guide](docs/self-hosting.md) for full production setup.

Contributing

Issues and PRs welcome. Run the test suite before submitting:

pip install -e ".[dev]"
pytest

Roadmap

See [docs/ROADMAP.md](docs/ROADMAP.md) for the 12-month development plan — indexer expansion, multi-network support, fee prediction, SDKs, and more.

Support This Project

Satoshi API is free, open-source Bitcoin infrastructure. If you find it useful, consider supporting development through OpenSats.

Related Projects

• bitcoin-mcp — MCP server with 49 Bitcoin tools for AI agents
• ChainPulse — AI-powered Bitcoin network intelligence CLI
• BAIP-1 — Bitcoin Agent Identity Protocol

License

Apache 2.0 — see [LICENSE](LICENSE).

---

Live API · Website · PyPI · MCP Server · [Roadmap](docs/ROADMAP.md)

Built by a Bitcoin Core contributor. Run python -m pytest --collect-only -q for the current test inventory.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Bortlesboat
• Source: Bortlesboat/bitcoin-api
• License: Apache-2.0
• Homepage: https://bitcoinsapi.com

Install and usage instructions live in the source repository linked above.