@bolthub/cli

CLI for the bolthub tool directory. Search, explore, and call paid APIs from the terminal.

Install

npm install -g @bolthub/cli

Or run directly with npx:

npx @bolthub/cli search bitcoin

Commands

search - Find APIs

bolthub search bitcoin
bolthub search --tag finance
bolthub search                  # list all

info - API details

bolthub info btc-intel

Shows all endpoints, pricing models, and usage instructions.

call - Call an endpoint

bolthub call btc-intel "/v1/history/candles?timeframe=1h&limit=2"
bolthub call btc-intel /v1/market/snapshot --max-cost 10

| Option | Description | |--------|-------------| | --method <METHOD> | HTTP method (default: GET) | | --max-cost <sats> | Refuse invoices above this amount | | --budget <sats> | Total session spending limit | | --body <json> | JSON request body for POST/PUT/PATCH |

receipts - Export and verify payments

bolthub receipts export --format csv --redact
bolthub receipts verify

export serializes your local receipt ledger (~/.bolthub/receipts.jsonl) to JSON or CSV; --redact strips preimages for a shareable expense report. verify runs the offline proof-of-payment checks on every receipt. export also takes --from/--to (ISO dates) and --file <path>.

Wallet Configuration

The CLI needs a Lightning wallet to pay for API calls. Set one of these environment variable pairs:

| Variables | Wallet | Speed | |-----------|--------|-------| | LND_REST_HOST + LND_MACAROON | LND (recommended) | <200ms | | NWC_URI | NWC (bundled, no extra install) | 1-3s | | LNBITS_URL + LNBITS_ADMIN_KEY | LNbits | <300ms | | PHOENIXD_URL + PHOENIXD_PASSWORD | Phoenixd (if you already run it) | <200ms |

License

MIT