# BTC Node API — btcnode.uk

> Bitcoin data from a real synced full node. No API keys. No signup. Pay per call in USDC.

**Price: $0.001 flat for every paid endpoint.** USDC on Base (eip155:8453) via x402. No API keys, no accounts, no signup.
**Free (discovery):** / · /health · /wallet · /revenue · /openapi.json · /llms.txt · /llms-full.txt · /.well-known/ai-index · /.well-known/x402 · /.well-known/ucp · /api/catalog · /api/credits/deposit · /api/credits/balance · /api/credits/statement · /api/credits/stats

## How to pay

1. Call the endpoint → `402 Payment Required` with `accepts[]` (price, asset, network, payTo)
2. Sign an EIP-3009 transfer authorization for $0.001 USDC
3. Re-send with the `X-PAYMENT` header → `200` + data
4. A Lightning rail (L402, 1 sat) is also accepted

Everything below is a flat **$0.001** per call.

### Bitcoin

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/info | $0.001 | Block height, difficulty, peers, chain health |
| GET /api/chain/info | $0.001 | Full chain state: height, size on disk, prune flag, softforks |
| GET /api/chain/best | $0.001 | Current chain tip: hash, height, time, confirmations |
| GET /api/chain/tips | $0.001 | All known chain tips — detects forks and reorgs |
| GET /api/chain/txstats | $0.001 | Transaction rate and volume over the window |
| GET /api/chain/utxo-set | $0.001 | CIRCULATING SUPPLY, UTXO count, total amount — cached 10 min |
| GET /api/chain/index-status | $0.001 | Which indexes this node runs (txindex, blockfilter, coinstats) |
| GET /api/block/{hashOrHeight} | $0.001 | Block by hash or height: txs, size, weight, merkleroot |
| GET /api/block/{hash}/header | $0.001 | Raw block header + prev/next links |
| GET /api/block/{hash}/stats | $0.001 | Block economics: subsidy, total fees, fee-rate percentiles |
| GET /api/block/{hash}/raw | $0.001 | Raw block hex — for SPV and light clients |
| GET /api/blocks/recent | $0.001 | Last N blocks (default 10): height, hash, size, txcount, time |
| GET /api/tx/{hash} | $0.001 | Transaction lookup + confirmations |
| GET /api/tx/{hash}/raw | $0.001 | Raw transaction hex |
| GET /api/tx/{hash}/status | $0.001 | Confirmed or pending: block, height, confirmations, fee |
| GET /api/tx/{hash}/outspends | $0.001 | Which outputs are already spent — UTXO hygiene check |
| POST /api/tx/decode | $0.001 | Decode an arbitrary raw transaction hex |
| POST /api/tx/broadcast | $0.001 | Broadcast a signed transaction to the network |
| POST /api/tx/test | $0.001 | Would this transaction be accepted? Fee/relay/standardness check |
| GET /api/trace/{txid} | $0.001 | 2-hop transaction tracing — follow the money |
| GET /api/addr/{address} | $0.001 | Address portfolio: balance, UTXOs, tx count |
| GET /api/addr/{address}/balance | $0.001 | Balance only — lean and fast |
| GET /api/utxo/{txid}/{vout} | $0.001 | Single UTXO: value, script, confirmations |
| GET /api/address/validate/{address} | $0.001 | Validate a Bitcoin address + script type |
| GET /api/descriptor/info | $0.001 | Descriptor checksum + metadata |
| GET /api/descriptor/derive | $0.001 | Derive addresses from a descriptor |
| GET /api/network/info | $0.001 | Node network state: version, subversion, connections |
| GET /api/network/peers | $0.001 | Connected peers: version, latency, direction, services |
| GET /api/network/connections | $0.001 | Connection count only |
| GET /api/network/traffic | $0.001 | Bytes sent/received since start |
| GET /api/node/uptime | $0.001 | Node uptime in seconds |

### Fees

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/mempool | $0.001 | Mempool congestion: pending tx, size, usage |
| GET /api/mempool/txs | $0.001 | Mempool transactions with fee + vsize |
| GET /api/mempool/histogram | $0.001 | Fee-rate distribution — what everyone else is paying |
| GET /api/fees | $0.001 | Live fee rates (high/medium/low sat/vB) |
| GET /api/fees/predict | $0.001 | Current fees + next-3-block forecast |
| GET /api/fees/estimate | $0.001 | Fee estimate for ANY target block (1-1008) |
| GET /api/rbf/replacements | $0.001 | Replace-by-fee activity in the mempool |

### Mining

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/mining/info | $0.001 | Mining state: difficulty, network hashrate, pooled tx |
| GET /api/mining/difficulty | $0.001 | Current difficulty + next retarget estimate |
| GET /api/mining/hashrate | $0.001 | Network hashrate (1/7/30 day windows) |

### Intel

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/whales | $0.001 | Whale monitor: mempool transfers over 50 BTC |

### Data

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/sec/insider/{ticker} | $0.001 | SEC insider trading filings (Form 4) for any ticker |
| POST /api/scrape | $0.001 | URL → clean markdown text (cached 1h) |
| POST /api/summarize | $0.001 | AI text summarization |

### Reddit

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/reddit/hot/{subreddit} | $0.001 | Hot posts from any subreddit |
| GET /api/reddit/search | $0.001 | Search Reddit posts |
| GET /api/reddit/comments/{postId} | $0.001 | Comments for a post |
| GET /api/reddit/trending | $0.001 | Trending from r/popular |

### Analysis

| Endpoint | Price | What you get |
|---|---|---|
| POST /api/game-theory | $0.001 | Game-theoretic analysis of a scenario |
| POST /api/systems-theory | $0.001 | Systems-theory analysis of a scenario |
| POST /api/omni-theory | $0.001 | Cross-domain omni-theory analysis |
| POST /api/capital-flows | $0.001 | Capital-flow analysis of a market/scenario |

### Agent

| Endpoint | Price | What you get |
|---|---|---|
| GET /api/agent/address/{address} | $0.001 | Agent-facing address intelligence |
| GET /api/agent/taint/{address} | $0.001 | Taint/cluster analysis for an address |
| GET /api/agent/whales | $0.001 | Agent-facing whale feed |
| POST /api/agent/scrape | $0.001 | Agent-facing scrape with cache |
| GET /api/agent/conan | $0.001 | Barbarian ops: node rank, traffic, revenue |
| GET /api/agent/health | $0.001 | Agent health + endpoint price list |
| POST /api/ironclaw/settle | $0.001 | Settlement helper for agent-to-agent payments |

### Free

| Endpoint | What you get |
|---|---|
| GET / | Landing page + human-readable catalog |
| GET /health | Liveness + wallet |
| GET /wallet | Farm wallet address + USDC balance |
| GET /revenue | 24h usage + revenue stats |
| GET /openapi.json | OpenAPI 3.1 spec with prices |
| GET /llms.txt | LLM-readable catalog (this file, generated) |
| GET /llms-full.txt | Full catalog (alias of llms.txt) |
| GET /.well-known/ai-index | AI index discovery document |
| GET /.well-known/x402 | x402 discovery document |
| GET /.well-known/ucp | Google UCP commerce profile |
| GET /api/catalog | Machine-readable catalog (all routes + prices) |
| POST /api/credits/deposit | Deposit USDC by proof-of-payment (tx hash) → spendable balance |
| GET /api/credits/balance | Prepay balance + calls remaining at $0.001 |
| GET /api/credits/statement | Deposit/spend history for a wallet |
| GET /api/credits/stats | Public ledger health (no wallet data) |

## Machine-readable

- OpenAPI: https://btcnode.uk/openapi.json
- Catalog JSON: https://btcnode.uk/api/catalog
- x402 discovery: https://btcnode.uk/.well-known/x402
- MCP server: https://mcp.btcnode.uk

## Contact

contact@btcnode.uk
X: https://x.com/btcnodeuk