@boltzpay/n8n-nodes-boltzpay

n8n community node for BoltzPay — pay for API data directly in your workflows via x402 and L402 protocols.

Installation

Via n8n Community Nodes (recommended)

1. In n8n, go to Settings > Community Nodes
2. Click Install
3. Enter @boltzpay/n8n-nodes-boltzpay
4. Click Install

Via npm

npm install @boltzpay/n8n-nodes-boltzpay

Features

• 7 operations — Fetch, Quote, Discover, Diagnose, Budget, History, Wallet
• Credential management — Native n8n credential type for Coinbase CDP keys
• Explore without keys — Quote, Discover, Diagnose, Budget, History, and Wallet work without credentials
• Multi-protocol — x402 (USDC on Base/Solana) and L402 (Lightning)

Credentials

Some operations (like Fetch) require Coinbase CDP credentials to sign payment transactions.

1. In n8n, go to Credentials > New
2. Search for BoltzPay
3. Enter your Coinbase CDP credentials:
   • API Key ID — Your Coinbase CDP API Key ID
   • API Key Secret — Your Coinbase CDP API Key Secret
   • Wallet Secret — Your Coinbase CDP Wallet Secret

Get your keys from the Coinbase Developer Platform.

Note: Only the Fetch operation requires credentials to execute payments. All other operations work without credentials.

Operations

| Operation | Description | Requires Credentials | | ------------- | ---------------------------------------------------- | :------------------: | | Fetch | Fetch and pay for API data | Yes | | Quote | Get price quote for URL | No | | Discover | Browse compatible API directory | No | | Diagnose | Diagnose endpoint protocol, health, and latency | No | | Budget | View current spending budget status | No | | History | List recent payments made during session | No | | Wallet | Check wallet connectivity, credentials, and balances | No |

Fetch

Fetches data from a paid API endpoint. Handles payment negotiation automatically.

Parameters:

• URL — The API endpoint URL
• HTTP Method — GET, POST, or PUT (default: GET)
• Chain — Auto, EVM (Base), or SVM (Solana) (default: Auto)

Quote

Gets the price quote for a URL without executing payment.

Discover

Browses the built-in API directory of compatible paid endpoints. Optionally filter by category.

Categories: crypto-data, utilities, demo

Diagnose

Full diagnostic of a URL: DNS resolution, protocol detection (x402/L402), format version, pricing, health status, and latency. Returns a complete report in one call.

Parameters:

• URL — The endpoint URL to diagnose

Budget

View current spending budget status including daily/monthly limits, amount spent, and remaining balance.

History

List recent payments made during the current session, including URLs, amounts, protocols, chains, and timestamps.

Wallet

Check wallet connectivity, credentials, balances, and budget. Tests the CDP connection when credentials are configured.

Usage Examples

Diagnose Before You Pay

1. Manual Trigger — Start the workflow
2. BoltzPay (Diagnose) — Diagnose https://invy.bot/api
3. IF — Branch on isPaid === true
4. BoltzPay (Fetch) — Fetch and pay for the data (true branch)
5. HTTP Request — Use standard HTTP for free endpoints (false branch)

API Discovery

1. Manual Trigger — Start the workflow
2. BoltzPay (Discover) — List all APIs (or filter by category)
3. Filter — Select APIs matching your criteria
4. BoltzPay (Quote) — Get live pricing for each API

Diagnose Before Integrating

1. Manual Trigger — Start the workflow
2. BoltzPay (Diagnose) — Diagnose https://api.example.com/endpoint
3. IF — Branch on health === "live" and isPaid === true
4. BoltzPay (Fetch) — Fetch data from healthy paid endpoints

Monitor Budget and Spending

1. Schedule Trigger — Run every hour
2. BoltzPay (Budget) — Get current budget status
3. IF — Check if daily remaining is below threshold
4. Slack/Email — Send alert when budget is running low

Audit Payment History

1. Manual Trigger — Start the workflow
2. BoltzPay (History) — Get all payments from session
3. Spreadsheet — Export payment records for accounting

Links

• GitHub
• SDK
• boltzpay.ai
• x402.org

Part of BoltzPay

This package is part of the BoltzPay open-source SDK — giving AI agents the ability to pay for APIs automatically.

License

MIT