Skip to main content

​
Install

​
Credentials

Some operations require Coinbase CDP keys to sign payment transactions.
  1. In n8n, go to Credentials > New
  2. Search for BoltzPay
  3. 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

OperationDescriptionCredentials
FetchFetch and pay for API data. Handles x402/L402 automatically.Yes
QuoteGet price quote with multi-chain options. Returns protocol, price, and payment status.No
DiscoverBrowse compatible paid APIs. Filter by category.No
DiagnoseFull endpoint diagnostic: protocol, health, latency, pricing.No
BudgetView current spending budget status.No
HistoryList recent payments made during session.No
WalletCheck 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

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

​
API Discovery

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