BTC Node API — Bitcoin node data over x402
Bitcoin data from a real synced full node. No API keys. No signup. Pay per call in USDC. Every paid route is a flat $0.001 USDC on Base (eip155:8453). Free…
Finance & banking#cryptocurrency
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Bitcoin data from a real synced full node. No API keys. No signup. Pay per call in USDC.
Every paid route is a flat $0.001 USDC on Base (eip155:8453). Free routes are the discovery surface. Prices are declared per-operation in x-price-usd and x-payment-info.
Endpoints 76
Free
- GETLanding page + human-readable catalog
/ - GETLiveness + wallet
/health - GETFarm wallet address + USDC balance
/wallet - GET24h usage + revenue stats
/revenue - GETOpenAPI 3.1 spec with prices
/openapi.json - GETLLM-readable catalog (this file, generated)
/llms.txt - GETFull catalog (alias of llms.txt)
/llms-full.txt - GETAI index discovery document
/.well-known/ai-index - GETx402 discovery document
/.well-known/x402 - GETGoogle UCP commerce profile
/.well-known/ucp - GETMachine-readable catalog (all routes + prices)
/api/catalog - GETFREE sample: fee rates cached up to 60 min — evaluate before paying
/api/sample/fees - POSTDeposit USDC by proof-of-payment (tx hash) → spendable balance
/api/credits/deposit - GETPrepay balance + calls remaining at $0.01
/api/credits/balance - GETDeposit/spend history for a wallet
/api/credits/statement - GETPublic ledger health (no wallet data)
/api/credits/stats
Bitcoin
- GETBlock height, difficulty, peers, chain health
/api/info - GETFull chain state: height, size on disk, prune flag, softforks
/api/chain/info - GETCurrent chain tip: hash, height, time, confirmations
/api/chain/best - GETAll known chain tips — detects forks and reorgs
/api/chain/tips - GETTransaction rate and volume over the window
/api/chain/txstats - GETCIRCULATING SUPPLY, UTXO count, total amount — cached 10 min
/api/chain/utxo-set - GETWhich indexes this node runs (txindex, blockfilter, coinstats)
/api/chain/index-status - GETBlock by hash or height: txs, size, weight, merkleroot
/api/block/:hashOrHeight - GETRaw block header + prev/next links
/api/block/:hash/header - GETBlock economics: subsidy, total fees, fee-rate percentiles
/api/block/:hash/stats - GETRaw block hex — for SPV and light clients
/api/block/:hash/raw - GETLast N blocks (default 10): height, hash, size, txcount, time
/api/blocks/recent - GETTransaction lookup + confirmations
/api/tx/:hash - GETRaw transaction hex
/api/tx/:hash/raw - GETConfirmed or pending: block, height, confirmations, fee
/api/tx/:hash/status - GETWhich outputs are already spent — UTXO hygiene check
/api/tx/:hash/outspends - POSTDecode an arbitrary raw transaction hex
/api/tx/decode - POSTBroadcast a signed transaction to the network
/api/tx/broadcast - POSTWould this transaction be accepted? Fee/relay/standardness check
/api/tx/test - GET2-hop transaction tracing — follow the money
/api/trace/:txid - GETAddress portfolio: balance, UTXOs, tx count
/api/addr/:address - GETBalance only — lean and fast
/api/addr/:address/balance - GETSingle UTXO: value, script, confirmations
/api/utxo/:txid/:vout - GETValidate a Bitcoin address + script type
/api/address/validate/:address - GETDescriptor checksum + metadata
/api/descriptor/info - GETDerive addresses from a descriptor
/api/descriptor/derive - GETNode network state: version, subversion, connections
/api/network/info - GETConnected peers: version, latency, direction, services
/api/network/peers - GETConnection count only
/api/network/connections - GETBytes sent/received since start
/api/network/traffic - GETNode uptime in seconds
/api/node/uptime
Fees
- GETMempool congestion: pending tx, size, usage
/api/mempool - GETMempool transactions with fee + vsize
/api/mempool/txs - GETFee-rate distribution — what everyone else is paying
/api/mempool/histogram - GETLive fee rates (high/medium/low sat/vB)
/api/fees - GETCurrent fees + next-3-block forecast
/api/fees/predict - GETFee estimate for ANY target block (1-1008)
/api/fees/estimate - GETReplace-by-fee activity in the mempool
/api/rbf/replacements
Mining
- GETMining state: difficulty, network hashrate, pooled tx
/api/mining/info - GETCurrent difficulty + next retarget estimate
/api/mining/difficulty - GETNetwork hashrate (1/7/30 day windows)
/api/mining/hashrate
Intel
- GETWhale monitor: mempool transfers over 50 BTC
/api/whales
Data
- GETSEC insider trading filings (Form 4) for any ticker
/api/sec/insider/:ticker - POSTURL → clean markdown text (cached 1h)
/api/scrape - POSTAI text summarization
/api/summarize
- GETHot posts from any subreddit
/api/reddit/hot/:subreddit - GETSearch Reddit posts
/api/reddit/search - GETComments for a post
/api/reddit/comments/:postId - GETTrending from r/popular
/api/reddit/trending
Analysis
- POSTGame-theoretic analysis of a scenario
/api/game-theory - POSTSystems-theory analysis of a scenario
/api/systems-theory - POSTCross-domain omni-theory analysis
/api/omni-theory - POSTCapital-flow analysis of a market/scenario
/api/capital-flows
Agent
- GETAgent-facing address intelligence
/api/agent/address/:address - GETTaint/cluster analysis for an address
/api/agent/taint/:address - GETAgent-facing whale feed
/api/agent/whales - POSTAgent-facing scrape with cache
/api/agent/scrape - GETBarbarian ops: node rank, traffic, revenue
/api/agent/conan - GETAgent health + endpoint price list
/api/agent/health - POSTSettlement helper for agent-to-agent payments
/api/ironclaw/settle
API details
- Base URL
https://btcnode.uk- Authentication
- None declared in the description
- Operations
- 76 operations on 76 pathsGET 64POST 12
- Main resources
- Bitcoin 31Free 16Agent 7Fees 7Analysis 4Reddit 4Data 3Mining 3Intel 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
4.0.0 - Links
- OpenAPI document
- Listed from
- Btcnode's published OpenAPI description
How to test the BTC Node API — Bitcoin node data over x402 in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the BTC Node API — Bitcoin node data over x402 collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Landing page + human-readable catalog” (GET /), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the BTC Node API — Bitcoin node data over x402?
Bitcoin data from a real synced full node. No API keys. No signup. Pay per call in USDC. Every paid route is a flat $0.001 USDC on Base (eip155:8453). Free… It is listed under Finance & banking and has 76 endpoints.
Who publishes the BTC Node API — Bitcoin node data over x402?
It is listed from Btcnode's public API description (an OpenAPI document), not published by Btcnode on Swastik Codes. Anyone who controls btcnode.uk can claim the profile by adding a DNS TXT record.
What is the base URL of the BTC Node API — Bitcoin node data over x402?
Requests go to https://btcnode.uk. Endpoint paths are added to this base URL.
How do I authenticate with the BTC Node API — Bitcoin node data over x402?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the BTC Node API — Bitcoin node data over x402 have?
76 operations on 76 paths (64 GET, 12 POST). The largest groups are Bitcoin, Free, Agent, Fees.
Is forking the BTC Node API — Bitcoin node data over x402 free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.