# BTC Node API — Bitcoin node data over x402 API

**Canonical:** https://apis.io/apis/btcnode-uk/btc-node-api-bitcoin-node-data-over-x402-api/  
**Provider:** btcnode-uk — https://apis.io/providers/btcnode-uk/  
**Base URL:** https://btcnode.uk  
**Documentation:** https://btcnode.uk/openapi.json

BTC Node API — Bitcoin node data over x402 API is one of 2 APIs that [btcnode-uk](https://apis.io/providers/btcnode-uk/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. The published artifact set on APIs.io includes an OpenAPI specification.

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

## Operations (60 of 76)

| Method | Path | Summary |
|---|---|---|
| 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.01 |
| GET | `/api/credits/statement` | Deposit/spend history for a wallet |
| GET | `/api/credits/stats` | Public ledger health (no wallet data) |
| GET | `/admin/usage` | Internal only — loopback/private networks |
| GET | `/api/info` | Block height, difficulty, peers, chain health |
| GET | `/api/chain/info` | Full chain state: height, size on disk, prune flag, softforks |
| GET | `/api/chain/best` | Current chain tip: hash, height, time, confirmations |
| GET | `/api/chain/tips` | All known chain tips — detects forks and reorgs |
| GET | `/api/chain/txstats` | Transaction rate and volume over the window |
| GET | `/api/chain/utxo-set` | CIRCULATING SUPPLY, UTXO count, total amount — cached 10 min |
| GET | `/api/chain/index-status` | Which indexes this node runs (txindex, blockfilter, coinstats) |
| GET | `/api/block/{hashOrHeight}` | Block by hash or height: txs, size, weight, merkleroot |
| GET | `/api/block/{hash}/header` | Raw block header + prev/next links |
| GET | `/api/block/{hash}/stats` | Block economics: subsidy, total fees, fee-rate percentiles |
| GET | `/api/block/{hash}/raw` | Raw block hex — for SPV and light clients |
| GET | `/api/blocks/recent` | Last N blocks (default 10): height, hash, size, txcount, time |
| GET | `/api/tx/{hash}` | Transaction lookup + confirmations |
| GET | `/api/tx/{hash}/raw` | Raw transaction hex |
| GET | `/api/tx/{hash}/status` | Confirmed or pending: block, height, confirmations, fee |
| GET | `/api/tx/{hash}/outspends` | Which outputs are already spent — UTXO hygiene check |
| POST | `/api/tx/decode` | Decode an arbitrary raw transaction hex |
| POST | `/api/tx/broadcast` | Broadcast a signed transaction to the network |
| POST | `/api/tx/test` | Would this transaction be accepted? Fee/relay/standardness check |
| GET | `/api/trace/{txid}` | 2-hop transaction tracing — follow the money |
| GET | `/api/mempool` | Mempool congestion: pending tx, size, usage |
| GET | `/api/mempool/txs` | Mempool transactions with fee + vsize |
| GET | `/api/mempool/histogram` | Fee-rate distribution — what everyone else is paying |
| GET | `/api/fees` | Live fee rates (high/medium/low sat/vB) |
| GET | `/api/fees/predict` | Current fees + next-3-block forecast |
| GET | `/api/fees/estimate` | Fee estimate for ANY target block (1-1008) |
| GET | `/api/rbf/replacements` | Replace-by-fee activity in the mempool |
| GET | `/api/addr/{address}` | Address portfolio: balance, UTXOs, tx count |
| GET | `/api/addr/{address}/balance` | Balance only — lean and fast |
| GET | `/api/utxo/{txid}/{vout}` | Single UTXO: value, script, confirmations |
| GET | `/api/address/validate/{address}` | Validate a Bitcoin address + script type |
| GET | `/api/descriptor/info` | Descriptor checksum + metadata |
| GET | `/api/descriptor/derive` | Derive addresses from a descriptor |
| GET | `/api/network/info` | Node network state: version, subversion, connections |
| GET | `/api/network/peers` | Connected peers: version, latency, direction, services |
| GET | `/api/network/connections` | Connection count only |
| GET | `/api/network/traffic` | Bytes sent/received since start |
| GET | `/api/node/uptime` | Node uptime in seconds |
| GET | `/api/mining/info` | Mining state: difficulty, network hashrate, pooled tx |
| GET | `/api/mining/difficulty` | Current difficulty + next retarget estimate |
| GET | `/api/mining/hashrate` | Network hashrate (1/7/30 day windows) |
| GET | `/api/whales` | Whale monitor: mempool transfers over 50 BTC |
| GET | `/api/sec/insider/{ticker}` | SEC insider trading filings (Form 4) for any ticker |
| POST | `/api/scrape` | URL → clean markdown text (cached 1h) |

…and 16 more operations. They are listed in full on the page.

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/btcnode-uk/openapi/_original/btcnode-uk-api-openapi.json

## Other btcnode-uk APIs (1)

- [BTC Node API](https://apis.io/apis/btcnode-uk/btc-node-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/btcnode-uk/btc-node-api-bitcoin-node-data-over-x402-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/btcnode-uk/.