# FastPath Bitcoin API

> Bitcoin RPC for EVM bots. FastPath lets agents request Bitcoin block data, fees, balances, UTXOs, transaction details, mempool intelligence, Core v31 template signals, and bump plans through Web3-style JSON-RPC and x402-paid REST endpoints. No API key is required for paid routes.

## Primary Resources

- [Developer overview](https://api.nativebtc.org/) - Human and agent-readable API overview, pricing, examples, endpoints, and x402 flow.
- [x402 section](https://api.nativebtc.org/#x402) - Payment flow, supported chains, and copy-paste client examples.
- [Live mempool dashboard](https://api.nativebtc.org/dashboard) - Read-only Bitcoin mempool telemetry and fee opportunity dashboard.
- [Template capabilities](https://api.nativebtc.org/v1/template/capabilities) - Public capability report for the Core v31 optimizer cache.
- [OpenAPI specification](https://api.nativebtc.org/openapi.json) - Machine-readable OpenAPI 3.0 endpoint catalogue with x402 payment metadata.
- [Health](https://api.nativebtc.org/health) - Public service health.

## x402 Paid Endpoints

- [POST /v1/rpc](https://api.nativebtc.org/v1/rpc) - JSON-RPC endpoint. Accepts Ethereum-style methods such as `eth_blockNumber`, `eth_gasPrice`, `eth_getBalance`, `eth_getBlockByNumber`, `eth_getTransactionByHash`, plus FastPath methods such as `fastpath_feeLadder` and `fastpath_bitcoinInsight`.
- [GET /v1/block-height](https://api.nativebtc.org/v1/block-height) - Current Bitcoin block height.
- [GET /v1/fee-estimate?blocks=6](https://api.nativebtc.org/v1/fee-estimate?blocks=6) - Bitcoin fee estimate in sat/vB.
- [GET /v1/balance/:address](https://api.nativebtc.org/v1/balance/bc1qexample) - Bitcoin address balance in satoshis.
- [GET /v1/utxos/:address](https://api.nativebtc.org/v1/utxos/bc1qexample) - UTXO set for a Bitcoin address.
- [GET /v1/tx/:txid](https://api.nativebtc.org/v1/tx/81c97a6c5b98a1019095de132727cda868694fb5d92534ebb07e475619e38325) - Decoded Bitcoin transaction details.
- [POST /v1/bitcoin/insight](https://api.nativebtc.org/v1/bitcoin/insight) - Unified fee verdict, RBF/CPFP bump plan, mempool state, and Core v31 template check.
- [POST /v1/template/check](https://api.nativebtc.org/v1/template/check) - Check one txid against the live cached optimized template signal.
- [POST /v1/template/fee-ladder](https://api.nativebtc.org/v1/template/fee-ladder) - Urgent, normal, and cheap Bitcoin fee bands.
- [POST /v1/template/bump-plan](https://api.nativebtc.org/v1/template/bump-plan) - Non-custodial fee bump plan. FastPath never signs or holds funds.
- [GET /v1/mempool/stream-ticket](https://api.nativebtc.org/v1/mempool/stream-ticket) - Pay once for a short-lived WebSocket ticket.

## Payment

- Protocol: x402 HTTP 402 Payment Required.
- Supported networks: Base `eip155:8453`, Polygon `eip155:137`, Arbitrum `eip155:42161`, World Chain `eip155:480`.
- Typical prices: `$0.001` for basic Bitcoin reads, `$0.01` for insight/template/bump intelligence, `$0.005` for a short-lived mempool stream ticket.
- Pay-to address: `0x0300E73759B357ceeE5A248d1801eCb8abf7A1d4`.
- Asset: USDC on the selected supported network.

## Optional

- [Full LLM context](https://api.nativebtc.org/llms-full.txt) - Longer agent guide with examples and endpoint intent.
- [Agent instructions](https://api.nativebtc.org/AGENTS.md) - Operational instructions for agents using this API.
- [Sitemap](https://api.nativebtc.org/sitemap.xml) - Discoverable URL list.
- [Markdown sitemap](https://api.nativebtc.org/sitemap.md) - Human-readable documentation hierarchy for agents.
- [Glossary](https://api.nativebtc.org/glossary.md) - Definitions for x402, RBF, CPFP, sat/vB, UTXO, Core v31, and template signals.
- [OpenAPI .well-known copy](https://api.nativebtc.org/.well-known/openapi.json) - Alternate discovery location for OpenAPI-aware registries.