x402 AI Agent 支付协议

基于 HTTP 402 状态码与稳定币的 AI Agent 自主支付协议。

什么是 x402？

x402 是一种面向互联网原生应用的开放支付标准。它使 AI Agent 能够在无需账户或人工干预的前提下，自动使用稳定币为 API 调用付费。

工作原理：

1. Agent 向 API 端点发起请求
2. 服务端返回 HTTP 402 状态码及支付详情
3. Agent 对支付授权进行签名
4. 支付在区块链上完成结算
5. 请求被自动响应并完成

核心优势：

• 无需账户或 API 密钥
• 即时结算
• 按次请求的微支付（micropayments）
• 链无关设计（支持 EVM 与 Solana）
• 专为自主 Agent 设计

快速开始

检查端点是否支持 x402

neckr0ik-x402-payments check https://api.example.com/premium

为 API 访问付费

neckr0ik-x402-payments pay https://api.example.com/premium --amount 0.01

接收支付（为你的 API 启用）

neckr0ik-x402-payments serve --port 8080 --price 0.01

支付流程

Agent                x402 Facilitator           API Server
  |                        |                        |
  |-- GET /premium ------>|----------------------->|
  |                        |                        |
  |<-- HTTP 402 -----------|------------------------|
  |    (payment required)  |                        |
  |    {amount, address,   |                        |
  |     chain, facilitator}|                        |
  |                        |                        |
  |-- Sign payment ------>|                        |
  |                        |                        |
  |                        |-- Submit to chain --->|
  |                        |                        |
  |                        |<-- Confirmation ------|
  |                        |                        |
  |-- GET /premium --------|----------------------->|
  |    PAYMENT-SIGNATURE   |                        |
  |                        |                        |
  |<-- 200 OK -------------|------------------------|
  |    (data)              |                        |

支持的区块链

• Ethereum（主网、L2）
• Polygon
• Base
• Arbitrum
• Optimism
• Solana

支持的稳定币

• USDC
• USDT
• DAI

命令

check

检查某个端点是否支持 x402 支付。

neckr0ik-x402-payments check 

选项：
  --timeout     请求超时时间（默认：10000）

pay

为 API 访问付费并获取数据。

neckr0ik-x402-payments pay  [options]

选项：
  --amount     最高支付金额（单位：USD）
  --chain       首选区块链（默认：base）
  --token       稳定币代币（默认：usdc）
  --wallet 
   用于支付的钱包地址
  --dry-run            显示支付详情但不实际执行支付

serve

启动一个启用 x402 的 API 服务端。

neckr0ik-x402-payments serve [options]

选项：
  --port         服务端口（默认：8080）
  --price      每次请求价格（单位：USD）
  --chain       接收支付所用区块链（默认：base）
  --token       接收的稳定币类型（默认：usdc）
  --wallet 
   接收付款的钱包地址

balance

查看你的支付钱包余额。

neckr0ik-x402-payments balance [options]

选项：
  --chain       查询所用区块链（默认：all）

history

查看支付历史记录。

neckr0ik-x402-payments history [options]

选项：
  --limit          交易条目数量（默认：10）
  --chain       按区块链筛选

配置

为支付设置你的钱包：

# 设置钱包私钥（安全存储）
neckr0ik-x402-payments config set wallet.private_key 

# 或通过环境变量设置
export X402_PRIVATE_KEY=

# 设置收款钱包地址
neckr0ik-x402-payments config set wallet.address 

典型应用场景

作为 Agent（为 API 访问付费）

# 之前：需 API 密钥、账户、订阅
response = requests.get("https://api.example.com/data", 
    headers={"Authorization": "Bearer YOUR_API_KEY"})

# 之后：自主支付，无需账户
response = x402.get("https://api.example.com/data")

作为服务提供方（接收支付）

from x402 import PaymentMiddleware

app = Flask(__name__)
app.wsgi_app = PaymentMiddleware(app.wsgi_app, price=0.01)

@app.route("/premium-data")
def premium_data():
    return {"data": "only accessible after payment"}

# 对 /premium-data 的请求将自动触发支付要求

安全性

• 私钥永不离开本地设备
• 支付签名在本地完成
• 交易通过 Facilitator 广播上链
• 所有结算均经链上验证
• 支付凭证留存以供审计

参阅

• references/x402-spec.md — 完整协议规范
• references/facilitators.md — 已知 Facilitator 列表
• scripts/x402.py — 支付实现代码