# bitcoind.app

> Complete Bitcoin Core RPC reference. All 142 RPC methods documented with parameters, return types, and code examples in curl, Python, and JavaScript. Programmatic API access with free single-method lookups and paid bulk access via the x402 payment protocol (v2).

## API

Agent-ready endpoints at `https://bitcoind.app/api/v1`. Payments settle in USDC on Base via x402. No accounts, no API keys. Discoverable via the x402 Bazaar.

- [OpenAPI Schema](https://bitcoind.app/api/v1/openapi): Machine-readable OpenAPI 3.1 spec
- [API Documentation](https://bitcoind.app/api): Human-readable endpoint reference with pricing and examples

### Free endpoints (rate limited to 100 requests/hour per IP)

- `GET /api/v1/methods/{name}`: Look up a single RPC method by name. Returns full method details with parameters, return schema, and code examples.
- `GET /api/v1/categories`: List all RPC method categories with method counts.
- `GET /api/v1/openapi`: OpenAPI 3.1 schema of the entire API.

### Paid endpoints via x402 ($0.001 per call)

- `GET /api/v1/methods`: Bulk list of all 142 RPC method summaries. One call replaces 142 individual lookups.
- `GET /api/v1/methods/search`: Search and filter methods by category, text query, or parameter name. Optional `examples=true` query param includes code snippets.

### Paid endpoints via x402 ($0.01 per call)

- `GET /api/v1/dump`: Complete structured dump of every RPC method with full parameters, return schemas, and code examples.

## Payment protocol

This API implements x402 protocol v2 for the paid tiers:

- Protocol version: 2
- Settlement asset: USDC
- Networks: Base mainnet (`eip155:8453`) and Base Sepolia testnet (`eip155:84532`)
- Request header (client → server): `PAYMENT-SIGNATURE`
- Requirements header (server → client, on 402): `PAYMENT-REQUIRED`
- Response header (server → client, on settlement): `PAYMENT-RESPONSE`

Payment settlement only occurs after a successful response. Failed lookups do not charge.

For x402 client libraries and SDK documentation, see https://github.com/coinbase/x402.

## Reference documentation

- [All commands](https://bitcoind.app): Browsable list of all 142 Bitcoin Core RPC commands.
- [Guides](https://bitcoind.app/guides): Longer-form guides for common Bitcoin Core RPC workflows.