@bolthub/cli

CLI for the BoltHub L402 API marketplace. Search, explore, and call paid APIs from the terminal.

Install

npm install -g @bolthub/cli

Or run directly with npx:

npx @bolthub/cli search weather

Commands

search - Find APIs

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

info - API details

bolthub info pokemon

Shows all endpoints, pricing models, and usage instructions.

call - Call an endpoint

bolthub call pokemon /v2/pokemon/pikachu
bolthub call ai-text /v1/summarize --method POST --body '{"text":"hello"}'
bolthub call bitcoin-data /v1/prices --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 |

Wallet Configuration

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

| Variables | Wallet | Speed | |-----------|--------|-------| | PHOENIXD_URL + PHOENIXD_PASSWORD | Phoenixd (recommended) | <200ms | | LND_REST_HOST + LND_MACAROON | LND | <200ms | | LNBITS_URL + LNBITS_ADMIN_KEY | LNbits | <300ms | | NWC_URI | NWC (requires @getalby/sdk) | 1-3s |

For NWC support, install the Alby SDK: npm install @getalby/sdk.

License

MIT