> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boltzpay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# n8n

> Community node for paying APIs directly in n8n workflows.

## Install

<Tabs>
  <Tab title="Community Nodes (recommended)">
    1. In n8n, go to **Settings > Community Nodes**
    2. Click **Install**
    3. Enter `@boltzpay/n8n-nodes-boltzpay`
    4. Click **Install**
  </Tab>

  <Tab title="npm">
    ```bash theme={null}
    npm install @boltzpay/n8n-nodes-boltzpay
    ```
  </Tab>
</Tabs>

## 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](https://portal.cdp.coinbase.com/).

<Info>
  `Quote`, `Discover`, `Diagnose`, `Budget`, `History`, and `Wallet` work without credentials. Only `Fetch` requires them.
</Info>

## 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).

```json title="Output" theme={null}
{
  "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