n8n - BoltzPay

Install

Community Nodes (recommended)
npm

In n8n, go to Settings > Community Nodes
Click Install
Enter @boltzpay/n8n-nodes-boltzpay
Click Install

npm install @boltzpay/n8n-nodes-boltzpay

Credentials

Some operations require Coinbase CDP keys to sign payment transactions.

In n8n, go to Credentials > New
Search for BoltzPay
Enter your Coinbase CDP credentials (API Key ID, API Key Secret, Wallet Secret)

Get your keys from portal.cdp.coinbase.com.

Quote, Discover, Diagnose, Budget, History, and Wallet work without credentials. Only Fetch requires them.

Operations

Operation	Description	Credentials
Fetch	Fetch and pay for API data. Handles x402/L402 automatically.	Yes
Quote	Get price quote with multi-chain options. Returns protocol, price, and payment status.	No
Discover	Browse compatible paid APIs. Filter by category.	No
Diagnose	Full endpoint diagnostic: protocol, health, latency, pricing.	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, HTTP Method (GET/POST/PUT), Chain (Auto/EVM/SVM).

Output

{
  "status": 200,
  "body": "{\"data\": \"...\"}",
  "payment": {
    "protocol": "x402",
    "amount": "$0.05",
    "txHash": "0x..."
  }
}

Quote

Returns protocol, price, payment status, and multi-chain alternatives without executing payment. Useful for conditional workflow logic (IF node).

Discover

Lists API directory entries with name, URL, protocol, category, and pricing. Supports category filter: crypto-data, finance, research, utilities, dev-tools, ai-tools, social, demo, media.

Diagnose

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

Budget

View current spending budget status — daily/monthly spent, remaining, and per-transaction limits.

History

List recent payments made during the current session with protocol, amount, chain, and URL.

Wallet

Check wallet connectivity, addresses, balances, active protocols, and budget status.

Workflow Examples

Quote Before You Pay

Manual Trigger
BoltzPay (Quote) on https://invy.bot/api
IF branch on whether the endpoint requires payment
BoltzPay (Fetch) on the paid branch
HTTP Request on the free branch

API Discovery

Manual Trigger
BoltzPay (Discover) with category crypto-data
Filter to select matching APIs
BoltzPay (Quote) for live pricing on each result

​Install

​Credentials

​Operations

​Fetch

​Quote

​Discover

​Diagnose

​Budget

​History

​Wallet

​Workflow Examples

​Quote Before You Pay

​API Discovery

Install

Credentials

Operations

Fetch

Quote

Discover

Diagnose

Budget

History

Wallet

Workflow Examples

Quote Before You Pay

API Discovery