btcnode-uk

BTC Node API — Bitcoin node data over x402 API

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

Documentation GitHub OpenAPI

Operations 76

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) #

POST /api/summarize AI text summarization #

GET /api/reddit/hot/{subreddit} Hot posts from any subreddit #

GET /api/reddit/search Search Reddit posts #

GET /api/reddit/comments/{postId} Comments for a post #

GET /api/reddit/trending Trending from r/popular #

POST /api/game-theory Game-theoretic analysis of a scenario #

POST /api/systems-theory Systems-theory analysis of a scenario #

POST /api/omni-theory Cross-domain omni-theory analysis #

POST /api/capital-flows Capital-flow analysis of a market/scenario #

GET /api/agent/address/{address} Agent-facing address intelligence #

GET /api/agent/taint/{address} Taint/cluster analysis for an address #

GET /api/agent/whales Agent-facing whale feed #

POST /api/agent/scrape Agent-facing scrape with cache #

GET /api/agent/conan Barbarian ops: node rank, traffic, revenue #

GET /api/agent/health Agent health + endpoint price list #

POST /api/ironclaw/settle Settlement helper for agent-to-agent payments #

Specifications

⚙

OpenAPI

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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/btcnode-uk:btc-node-api-bitcoin-node-data-over-x402-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

{"openapi":"3.1.0","info":{"title":"BTC Node API — Bitcoin node data over x402","version":"4.0.0","description":"Bitcoin data from a real synced full node. No API keys. No signup. Pay per call in USDC.\n\nEvery paid route is a flat $0.01 USDC on Base (eip155:8453). Free routes are the discovery surface. Prices are declared per-operation in `x-price-usd` and `x-payment-info`.","contact":{"email":"contact@btcnode.uk"},"x-pricing":{"model":"flat-per-call","amount_usd":"0.01","network":"eip155:8453","asset":"USDC","free_routes":["GET /","GET /health","GET /wallet","GET /revenue","GET /openapi.json","GET /llms.txt","GET /llms-full.txt","GET /.well-known/ai-index","GET /.well-known/x402","GET /.well-known/ucp","GET /api/catalog","POST /api/credits/deposit","GET /api/credits/balance","GET /api/credits/statement","GET /api/credits/stats"]}},"servers":[{"url":"https://btcnode.uk"}],"tags":[{"name":"Free","description":"Discovery surface — always free"},{"name":"Bitcoin"},{"name":"Fees"},{"name":"Mining"},{"name":"Intel"},{"name":"Data"},{"name":"Reddit"},{"name":"Analysis"},{"name":"Agent"}],"paths":{"/":{"get":{"operationId":"free__","summary":"Landing page + human-readable catalog","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/health":{"get":{"operationId":"free__health","summary":"Liveness + wallet","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/wallet":{"get":{"operationId":"free__wallet","summary":"Farm wallet address + USDC balance","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/revenue":{"get":{"operationId":"free__revenue","summary":"24h usage + revenue stats","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/openapi.json":{"get":{"operationId":"free__openapi_json","summary":"OpenAPI 3.1 spec with prices","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/llms.txt":{"get":{"operationId":"free__llms_txt","summary":"LLM-readable catalog (this file, generated)","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/llms-full.txt":{"get":{"operationId":"free__llms_full_txt","summary":"Full catalog (alias of llms.txt)","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/.well-known/ai-index":{"get":{"operationId":"free__well_known_ai_index","summary":"AI index discovery document","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/.well-known/x402":{"get":{"operationId":"free__well_known_x402","summary":"x402 discovery document","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/.well-known/ucp":{"get":{"operationId":"free__well_known_ucp","summary":"Google UCP commerce profile","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/api/catalog":{"get":{"operationId":"free__api_catalog","summary":"Machine-readable catalog (all routes + prices)","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/api/credits/deposit":{"post":{"operationId":"free__api_credits_deposit","summary":"Deposit USDC by proof-of-payment (tx hash) → spendable balance","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/api/credits/balance":{"get":{"operationId":"free__api_credits_balance","summary":"Prepay balance + calls remaining at $0.01","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/api/credits/statement":{"get":{"operationId":"free__api_credits_statement","summary":"Deposit/spend history for a wallet","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/api/credits/stats":{"get":{"operationId":"free__api_credits_stats","summary":"Public ledger health (no wallet data)","tags":["Free"],"x-price-usd":"0.000","responses":{"200":{"description":"OK"}}}},"/admin/usage":{"get":{"operationId":"internal__admin_usage","summary":"Internal only — loopback/private networks","tags":["Internal"],"responses":{"200":{"description":"OK"},"403":{"description":"Forbidden"}}}},"/api/info":{"get":{"operationId":"api_info","summary":"Block height, difficulty, peers, chain health","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getblockchaininfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"chain":"main","blocks":967742,"difficulty":132757073449487.5,"verificationprogress":1}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/info":{"get":{"operationId":"api_chain_info","summary":"Full chain state: height, size on disk, prune flag, softforks","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getblockchaininfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"chain":"main","blocks":967742,"size_on_disk":877319189666,"pruned":false}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/best":{"get":{"operationId":"api_chain_best","summary":"Current chain tip: hash, height, time, confirmations","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getbestblockhash+getblockheader","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"hash":"00000000000000000000710a...","height":967742,"time":1789849449}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/tips":{"get":{"operationId":"api_chain_tips","summary":"All known chain tips — detects forks and reorgs","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getchaintips","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"tips":[{"height":967742,"hash":"0000000000000000000071...","branchlen":0,"status":"active"}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/txstats":{"get":{"operationId":"api_chain_txstats","summary":"Transaction rate and volume over the window","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getchaintxstats","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"window_final_block_height":967742,"window_tx_count":138412233,"window_interval":1209600}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/utxo-set":{"get":{"operationId":"api_chain_utxo_set","summary":"CIRCULATING SUPPLY, UTXO count, total amount — cached 10 min","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"gettxoutsetinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"height":967742,"txouts":172334123,"total_amount":19873654.12345678}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/chain/index-status":{"get":{"operationId":"api_chain_index_status","summary":"Which indexes this node runs (txindex, blockfilter, coinstats)","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getindexinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"txindex":{"synced":true,"best_block_height":967742}}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/block/{hashOrHeight}":{"get":{"operationId":"api_block_hashOrHeight","summary":"Block by hash or height: txs, size, weight, merkleroot","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hashOrHeight","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getblock","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"hash":"00000000000000000000c7...","height":967742,"nTx":3211,"size":1745333,"weight":3998032}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/block/{hash}/header":{"get":{"operationId":"api_block_hash_header","summary":"Raw block header + prev/next links","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getblockheader","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"hash":"00000000000000000000c7...","height":967742,"time":1789849449,"nTx":3211}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/block/{hash}/stats":{"get":{"operationId":"api_block_hash_stats","summary":"Block economics: subsidy, total fees, fee-rate percentiles","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getblockstats","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"height":967742,"totalfee":0.0512,"subsidy":3.125,"avgfeerate":8,"feerate_percentiles":[2,3,4,6,12]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/block/{hash}/raw":{"get":{"operationId":"api_block_hash_raw","summary":"Raw block hex — for SPV and light clients","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getblock verbosity 0","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"hex":"00600020..."}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/blocks/recent":{"get":{"operationId":"api_blocks_recent","summary":"Last N blocks (default 10): height, hash, size, txcount, time","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getblockhash+getblockheader","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"count":10,"blocks":[{"height":967742,"hash":"00000000000000000000c7...","nTx":3211}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/tx/{hash}":{"get":{"operationId":"api_tx_hash","summary":"Transaction lookup + confirmations","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getrawtransaction","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"txid":"4a5e1e4b...","confirmations":12,"size":226,"vin":[],"vout":[]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/tx/{hash}/raw":{"get":{"operationId":"api_tx_hash_raw","summary":"Raw transaction hex","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getrawtransaction verbosity 0","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"hex":"0100000001..."}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/tx/{hash}/status":{"get":{"operationId":"api_tx_hash_status","summary":"Confirmed or pending: block, height, confirmations, fee","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getrawtransaction+getblockheader","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"confirmed":true,"block_height":967742,"confirmations":3}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/tx/{hash}/outspends":{"get":{"operationId":"api_tx_hash_outspends","summary":"Which outputs are already spent — UTXO hygiene check","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"hash","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"gettxout","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"outspends":[{"spent":false,"value":0.5}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/tx/decode":{"post":{"operationId":"api_tx_decode","summary":"Decode an arbitrary raw transaction hex","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"decoderawtransaction","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"txid":"...","version":2,"size":226,"vout":[]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hex"],"properties":{"hex":{"type":"string"}}}}}}}},"/api/tx/broadcast":{"post":{"operationId":"api_tx_broadcast","summary":"Broadcast a signed transaction to the network","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"sendrawtransaction","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"txid":"...","accepted":true}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hex"],"properties":{"hex":{"type":"string"}}}}}}}},"/api/tx/test":{"post":{"operationId":"api_tx_test","summary":"Would this transaction be accepted? Fee/relay/standardness check","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"testmempoolaccept","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"allowed":true,"vsize":226,"fees":{"base":0.00000226}}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hex"],"properties":{"hex":{"type":"string"}}}}}}}},"/api/trace/{txid}":{"get":{"operationId":"api_trace_txid","summary":"2-hop transaction tracing — follow the money","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"txid","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"getrawtransaction x2","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"txid":"...","depth":2,"hops":[]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/mempool":{"get":{"operationId":"api_mempool","summary":"Mempool congestion: pending tx, size, usage","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getmempoolinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"size":41233,"bytes":38291233,"mempoolminfee":0.00001}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/mempool/txs":{"get":{"operationId":"api_mempool_txs","summary":"Mempool transactions with fee + vsize","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getrawmempool verbose","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"count":100,"txs":[{"txid":"...","fee":0.00012,"vsize":141}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/mempool/histogram":{"get":{"operationId":"api_mempool_histogram","summary":"Fee-rate distribution — what everyone else is paying","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getrawmempool verbose","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"bands":[{"min_sat_vb":1,"max_sat_vb":2,"txs":12031}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/fees":{"get":{"operationId":"api_fees","summary":"Live fee rates (high/medium/low sat/vB)","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"estimatesmartfee","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"fast":12,"medium":8,"slow":4,"unit":"sat/vB"}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/fees/predict":{"get":{"operationId":"api_fees_predict","summary":"Current fees + next-3-block forecast","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"estimatesmartfee","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"now":{"fast":12,"medium":8},"forecast":[{"block":1,"sat_vb":12}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/fees/estimate":{"get":{"operationId":"api_fees_estimate","summary":"Fee estimate for ANY target block (1-1008)","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"target","in":"query","required":false,"schema":{"type":"string"}}],"x-backing-rpc":"estimatesmartfee","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"target":6,"feerate_sat_vb":6,"blocks":6}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/rbf/replacements":{"get":{"operationId":"api_rbf_replacements","summary":"Replace-by-fee activity in the mempool","tags":["Fees"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getrawmempool verbose","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"count":12,"replacements":[]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/addr/{address}":{"get":{"operationId":"api_addr_address","summary":"Address portfolio: balance, UTXOs, tx count","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"scantxoutset","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"bc1q...","balance_btc":0.5,"utxos":3,"tx_count":12}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/addr/{address}/balance":{"get":{"operationId":"api_addr_address_balance","summary":"Balance only — lean and fast","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"scantxoutset","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"address":"bc1q...","balance_btc":0.5,"unconfirmed_btc":0}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/utxo/{txid}/{vout}":{"get":{"operationId":"api_utxo_txid_vout","summary":"Single UTXO: value, script, confirmations","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"txid","in":"path","required":true,"schema":{"type":"string"}},{"name":"vout","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"gettxout","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"value_btc":0.5,"confirmations":12,"scriptPubKey":{"type":"witness_v0_keyhash"}}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/address/validate/{address}":{"get":{"operationId":"api_address_validate_address","summary":"Validate a Bitcoin address + script type","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"x-backing-rpc":"validateaddress","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"isvalid":true,"address":"bc1q...","scriptPubKey":"0014..."}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/descriptor/info":{"get":{"operationId":"api_descriptor_info","summary":"Descriptor checksum + metadata","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"d","in":"query","required":false,"schema":{"type":"string"}}],"x-backing-rpc":"getdescriptorinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"descriptor":"wpkh(...)","checksum":"abc123","isrange":false}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/descriptor/derive":{"get":{"operationId":"api_descriptor_derive","summary":"Derive addresses from a descriptor","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"parameters":[{"name":"d","in":"query","required":false,"schema":{"type":"string"}}],"x-backing-rpc":"deriveaddresses","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"addresses":["bc1q..."]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/network/info":{"get":{"operationId":"api_network_info","summary":"Node network state: version, subversion, connections","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getnetworkinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"version":270000,"subversion":"/Satoshi:27.0.0/","connections":23}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/network/peers":{"get":{"operationId":"api_network_peers","summary":"Connected peers: version, latency, direction, services","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getpeerinfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"count":23,"peers":[{"addr":"x.x.x.x:8333","pingtime":0.041}]}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/network/connections":{"get":{"operationId":"api_network_connections","summary":"Connection count only","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getconnectioncount","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"connections":23}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/network/traffic":{"get":{"operationId":"api_network_traffic","summary":"Bytes sent/received since start","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getnettotals","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"totalbytesrecv":148219384,"totalbytessent":32291833}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/node/uptime":{"get":{"operationId":"api_node_uptime","summary":"Node uptime in seconds","tags":["Bitcoin"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"uptime","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"uptime_seconds":2841200}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/mining/info":{"get":{"operationId":"api_mining_info","summary":"Mining state: difficulty, network hashrate, pooled tx","tags":["Mining"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}],"network":"eip155:8453","asset":"USDC"},"x-backing-rpc":"getmininginfo","responses":{"200":{"description":"OK","content":{"application/json":{"example":{"blocks":967742,"difficulty":132757073449487.5,"networkhashps":870000000000000000000}}}},"400":{"description":"Bad request"},"402":{"description":"Payment Required — $0.01 USDC on eip155:8453"},"429":{"description":"Rate limited"},"503":{"description":"Upstream node unavailable"}}}},"/api/mining/difficulty":{"get":{"operationId":"api_mining_difficulty","summary":"Current difficulty + next retarget estimate","tags":["Mining"],"x-price-usd":"0.01","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":

# --- truncated at 32 KB (46 KB total) ---
# Full source: https://artifacts.apis.io/btcnode-uk/openapi/_original/btcnode-uk-api-openapi.json