Your Bitcoin node, as a REST API

What is Satoshi API?

A thin REST layer between your Bitcoin Core node and your applications.

Bitcoin Core's JSON-RPC is powerful but awkward. Raw responses, no caching, no rate limiting, no input validation. Satoshi API wraps it in a clean REST interface with typed responses, smart caching, and analyzed data. Instead of calling estimatesmartfee five times and doing math, you get a single endpoint with human-readable recommendations in sat/vB.

It's part of a three-layer stack for Bitcoin developers:

Why not just use RPC directly?

Everything Bitcoin Core is missing as an API server.

Who is this for?

Anyone who runs a Bitcoin node and wants to build on top of it.

curl localhost:9332/api/v1/mempool
# Congestion level, fee buckets,
# next-block minimum fee

curl -X POST localhost:9332/api/v1/broadcast \
  -H "X-API-Key: sk_..." \
  -d '{"hex": "0200000001..."}'
# Returns txid on success

# claude desktop config
"bitcoin": {
  "command": "bitcoin-mcp",
  "args": ["--api-url",
    "http://localhost:9332"]
}

curl localhost:9332/api/v1/mining
# Difficulty, hashrate, next
# retarget height, blocks until

43 Endpoints

Blocks, transactions, fees, mempool, mining, network, prices, streams.

All endpoints prefixed with /api/v1. Interactive docs at /docs (Swagger UI) and /redoc.

New: Address lookups, fee landscape ("should I send now?"), tx cost estimator, historical fees, SSE real-time streams. Roadmap: Prometheus metrics, webhook notifications. Follow progress on GitHub.

Quick Start

Start querying Bitcoin data in seconds.

Option 1: Use the hosted API (no setup)

No node, no install, no signup. Just start making requests:

# Get current fee recommendations
curl https://bitcoinsapi.com/api/v1/fees/recommended

# Latest block analysis
curl https://bitcoinsapi.com/api/v1/blocks/latest

# Mempool congestion
curl https://bitcoinsapi.com/api/v1/mempool

# Mining stats
curl https://bitcoinsapi.com/api/v1/mining

That's it. No API key needed for GET requests. Try all 43 endpoints in the interactive playground.

Option 2: Get a free API key (10x higher limits)

Unlock 10,000 requests/day and POST access. Takes 5 seconds:

Option 3: Self-host on your own node

Run the full API on your own Bitcoin Core node. Unlimited requests, full privacy.

# Install
pip install satoshi-api

# Configure (point at your node)
export BITCOIN_RPC_USER=your_user
export BITCOIN_RPC_PASSWORD=your_password

# Run
satoshi-api
# API at http://localhost:9332
# Docs at http://localhost:9332/docs

Also available via Docker: docker compose up -d. Requires Bitcoin Core with server=1 and Python 3.10+. txindex=1 recommended.

Pricing

Self-host for free, or use our hosted API at bitcoinsapi.com.

Need higher limits or a dedicated instance? Get in touch.

How it compares

You have options. Here's why Satoshi API exists.