satoshi-api 0.3.1

Satoshi API — developer-friendly Bitcoin REST API powered by your own node

Satoshi API

REST API for your Bitcoin node. One pip install, 42 endpoints.

Live Playground · Landing Page · PyPI · MCP Server

---

Wraps Bitcoin Core's JSON-RPC in a clean REST interface with analyzed data, smart caching, and tiered rate limiting.

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	Endpoints	Highlights
Blocks	8	Latest block, by height/hash, stats, txids, header
Transactions	7	Decoded analysis, status, outspends, UTXO lookup, broadcast
Fees	7	Recommendations, landscape ("send now or wait?"), history, mempool-blocks
Mempool	5	Congestion score, fee buckets, recent entries
Mining	2	Hashrate, difficulty, next block template
Network	4	Peers, forks, difficulty, address validation
Streams	2	Real-time blocks & fees via SSE

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

AI Agent Integration (MCP)

Pairs with bitcoin-mcp to give AI assistants direct access to your Bitcoin node via Model Context Protocol.

{
  "mcpServers": {
    "bitcoin": {
      "command": "bitcoin-mcp",
      "args": ["--api-url", "http://localhost:9332"]
    }
  }
}

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 for full production setup.

Contributing

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

pip install -e ".[dev]"
pytest

License

Apache 2.0 — see LICENSE.

---

Live API · Website · PyPI · MCP Server

Built by a Bitcoin Core contributor.