boltzpay

自动支付API数据——多协议（x402 + L402）、多链

# BoltzPay — Paid API Access for AI Agents

BoltzPay lets AI agents pay for API data automatically. It supports multiple payment protocols (x402 and L402) and multiple blockchains (Base and Solana), paying with USDC or Bitcoin Lightning. Agents can discover, evaluate, and purchase API data in a single workflow.

## Quick Start

Fetch data from a paid API endpoint:

```
npx @boltzpay/cli fetch https://invy.bot/api
```

## Commands

| Command | Description | Credentials Needed |
|---------|-------------|--------------------|
| `npx @boltzpay/cli fetch <url>` | Fetch and pay for API data | Yes |
| `npx @boltzpay/cli check <url>` | Check if URL requires payment | No |
| `npx @boltzpay/cli quote <url>` | Get a price quote | No |
| `npx @boltzpay/cli discover` | Browse compatible APIs | No |
| `npx @boltzpay/cli budget` | Check spending budget | No |
| `npx @boltzpay/cli history` | View payment history | No |
| `npx @boltzpay/cli wallet` | Check wallet address and balance | No |
| `npx @boltzpay/cli demo` | Interactive demo walkthrough | No |

## Setup

Set the following environment variables for paid API access:

- `COINBASE_API_KEY_ID` — Your Coinbase CDP API key ID
- `COINBASE_API_KEY_SECRET` — Your Coinbase CDP API key secret
- `COINBASE_WALLET_SECRET` — Your Coinbase CDP wallet secret
- `BOLTZPAY_DAILY_BUDGET` — Daily spending limit in USD (optional, default: unlimited)

Get your Coinbase CDP keys at [portal.cdp.coinbase.com](https://portal.cdp.coinbase.com).

## Examples

### 1. Discover available APIs

```
npx @boltzpay/cli discover
```

Browse the directory of paid APIs compatible with BoltzPay. No credentials needed.

### 2. Check price before paying

```
npx @boltzpay/cli check https://invy.bot/api
```

See the payment protocol, amount, and chain options without spending anything.

### 3. Fetch paid data

```
npx @boltzpay/cli fetch https://invy.bot/api
```

Automatically detects the payment protocol, pays with USDC, and returns the API response.

## No Credentials?

Seven of the eight commands work without any Coinbase credentials:

- `check` — see if a URL requires payment
- `quote` — get detailed pricing
- `discover` — browse the API directory
- `budget` — check spending limits
- `history` — view past transactions
- `wallet` — check wallet address and balance
- `demo` — interactive demo walkthrough

Only `fetch` requires credentials (it makes actual payments).

## Links

- [GitHub](https://github.com/leventilo/boltzpay)
- [npm](https://www.npmjs.com/package/@boltzpay/sdk)
- [Documentation](https://boltzpay.ai)

---

## 中文说明

# BoltzPay — 面向 AI 智能体的付费 API 访问

BoltzPay 让 AI 智能体能够自动为 API 数据付费。它支持多种支付协议（x402 和 L402）以及多条区块链（Base 和 Solana），可使用 USDC 或比特币闪电网络付款。智能体可以在单个工作流中发现、评估并购买 API 数据。

## 快速开始

从付费 API 端点获取数据：

```
npx @boltzpay/cli fetch https://invy.bot/api
```

## 命令

| 命令 | 说明 | 是否需要凭证 |
|---------|-------------|--------------------|
| `npx @boltzpay/cli fetch <url>` | 获取并支付 API 数据 | 是 |
| `npx @boltzpay/cli check <url>` | 检查 URL 是否需要付费 | 否 |
| `npx @boltzpay/cli quote <url>` | 获取价格报价 | 否 |
| `npx @boltzpay/cli discover` | 浏览兼容的 API | 否 |
| `npx @boltzpay/cli budget` | 查看支出预算 | 否 |
| `npx @boltzpay/cli history` | 查看支付历史 | 否 |
| `npx @boltzpay/cli wallet` | 查看钱包地址和余额 | 否 |
| `npx @boltzpay/cli demo` | 交互式演示引导 | 否 |

## 设置

设置以下环境变量以启用付费 API 访问：

- `COINBASE_API_KEY_ID` — 你的 Coinbase CDP API 密钥 ID
- `COINBASE_API_KEY_SECRET` — 你的 Coinbase CDP API 密钥 secret
- `COINBASE_WALLET_SECRET` — 你的 Coinbase CDP 钱包 secret
- `BOLTZPAY_DAILY_BUDGET` — 每日支出上限，以美元计（可选，默认：无限制）

在 [portal.cdp.coinbase.com](https://portal.cdp.coinbase.com) 获取你的 Coinbase CDP 密钥。

## 示例

### 1. 发现可用的 API

```
npx @boltzpay/cli discover
```

浏览与 BoltzPay 兼容的付费 API 目录。无需凭证。

### 2. 付款前检查价格

```
npx @boltzpay/cli check https://invy.bot/api
```

查看支付协议、金额和可选链路，且不花费任何费用。

### 3. 获取付费数据

```
npx @boltzpay/cli fetch https://invy.bot/api
```

自动检测支付协议，使用 USDC 付款，并返回 API 响应。

## 没有凭证？

八个命令中有七个无需任何 Coinbase 凭证即可使用：

- `check` — 查看某个 URL 是否需要付费
- `quote` — 获取详细定价
- `discover` — 浏览 API 目录
- `budget` — 查看支出上限
- `history` — 查看历史交易
- `wallet` — 查看钱包地址和余额
- `demo` — 交互式演示引导

只有 `fetch` 需要凭证（因为它会进行实际付款）。

## 链接

- [GitHub](https://github.com/leventilo/boltzpay)
- [npm](https://www.npmjs.com/package/@boltzpay/sdk)
- [Documentation](https://boltzpay.ai)