# Bitcoin Network

Fee estimates, address and transaction status, network health, mining pools, supply and price from mempool.space.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://bitcoin-network.x402tookit.com/openapi.json
- x402 manifest: https://bitcoin-network.x402tookit.com/.well-known/x402
- Catalog (free): https://bitcoin-network.x402tookit.com/catalog
- Health (free): https://bitcoin-network.x402tookit.com/health
- Uptime (free): https://bitcoin-network.x402tookit.com/uptime

## Endpoints (8)

### GET /btc-address-check — $0.03
Validate a Bitcoin mainnet address and report its type, confirmed and pending balance, transaction count and USD value.
Params: address: string
Example: https://bitcoin-network.x402tookit.com/btc-address-check?address=bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq

### GET /btc-address-validate — $0.02
Validate a Bitcoin address checksum offline: base58check or bech32/bech32m, with type and network (mainnet or test).
Params: address: string
Example: https://bitcoin-network.x402tookit.com/btc-address-validate?address=bc1p0xlxvlhemja6c4dqv22uapctqupfhlxm9h8z3k2e72q4k9hcz7vqzk5jj0

### GET /btc-fee-estimate — $0.03
Bitcoin fee rates for next-block to economy confirmation, mempool congestion level and the cost of a typical transaction.
Params: vbytes?: integer
Example: https://bitcoin-network.x402tookit.com/btc-fee-estimate?vbytes=141

### GET /btc-mining-pools — $0.02
Mining pool share of recent Bitcoin blocks with concentration (top-3 share, HHI) and the 51 percent check.
Params: window?: string
Example: https://bitcoin-network.x402tookit.com/btc-mining-pools?window=1w

### GET /btc-network-health — $0.03
Bitcoin network health: tip height, block pace vs 10 minutes, difficulty retarget forecast, hashrate trend and Lightning size.
Params: window?: string
Example: https://bitcoin-network.x402tookit.com/btc-network-health?window=1m

### GET /btc-price — $0.02
Bitcoin price in USD, EUR, GBP, CAD, CHF, AUD and JPY, with optional conversion of an amount of BTC, sats or fiat.
Params: amount?: number, from?: string, to?: string
Example: https://bitcoin-network.x402tookit.com/btc-price?amount=0.05&from=BTC&to=USD

### GET /btc-supply — $0.02
Bitcoin issued supply, block subsidy, percent of 21 million mined and the next halving, computed exactly from protocol rules.
Params: unit?: string, height?: integer
Example: https://bitcoin-network.x402tookit.com/btc-supply?unit=btc

### GET /btc-tx-status — $0.03
Status of a Bitcoin transaction: unconfirmed or confirmed, confirmation depth, fee and fee rate, size and replaceability.
Params: txid: string
Example: https://bitcoin-network.x402tookit.com/btc-tx-status?txid=4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b

## Terms

Bitcoin network facts come from the public mempool.space API and local computation, provided as is. Fee estimates are predictions that can be wrong within minutes, balances reflect the indexer's view, and prices are indicative. This is not financial advice and not a custody or transaction service.