买方快速开始 · Quickstart

三分钟,跑通你的第一次付费调用

无需注册、无需 API Key。下面每一条命令都可以直接复制运行——402 不是报错,是价目牌。

第 0 步 · 60 秒看到明码标价(零依赖)

不用装任何东西。这条命令会返回 402 Payment Required——这不是报错,是 x402 的「价目牌」。

terminal · 复制即跑
curl -i https://feegate.org/api/supply/asset/case_status

返回的 accepts 里写清了全部收费要素:eip155:8453(Base 主网)、USDC 合约、amount 60000(6 位小数 = $0.06)、收款地址。响应里的 _feegate.how_to_pay 列出了三条付款方式,本页第 3 步会各给一条可跑的命令。

第 1 步 · 免费先调通(一分钱不花)

免费层每天有额度,先把链路跑通再谈付费。

免费工具调用(当日有免费额度)
curl https://feegate.org/api/supply/asset/talent_quota
免费数据集查询 API · 163,501 条记录 · 无需任何 Key
curl "https://feegate.org/free/api/search?dataset=defillama-protocols&q=uniswap&limit=3"

6 个免费公开数据集(x402 付费资源索引、MCP 服务器目录、DeFi TVL、交易所行情…)都走这套 API,也有免费 MCP 端点:https://feegate.org/free/mcp(工具 free_datasets / free_search / free_get)。

第 2 步 · 准备钱包(唯一的前置条件)

只需要 USDC

Base 主网 USDC(合约 0x8335…2913)。不需要 ETH——签名走 EIP-3009,gas 由 facilitator 代付。

多少钱够用

$1 = 20 次($0.05/次 GPU 行情)或 100 次($0.01/次 RWA 快讯)。从 4 美分开始都能调。

怎么拿到

交易所提币选 Base 网络,或用官方跨链桥。国内团队也可以不碰 USDC:人民币充值积分(1 积分 = ¥0.01)。

第 3 步 · 第一次付费调用(两条路任选)

A

x402 客户端(推荐给 Agent,自动签名)

x402 官方库自动完成「拿到 402 → 签名付款 → 重发 → 拿数据」整个循环。

client.py
# pip install "mcp<2" "x402==2.25.0" web3
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
from x402.mcp import create_payment_hook
from eth_account import Account

account  = Account.from_key("你的私钥")    # 只需有 Base 主网 USDC
MCP_URL  = "https://api.feegate.org/mcp/gpu-market"

async with streamablehttp_client(MCP_URL) as (r, w, _):
    async with ClientSession(r, w, hooks=[create_payment_hook(account)]) as s:
        await s.initialize()
        print(await s.call_tool("list_gpu_models", {}))          # 免费
        print(await s.call_tool("gpu_price", {"gpu": "H100"}))  # $0.05
B

已付交易凭证(零依赖,人类最短路径)

先用任何钱包转 $0.06 USDC(Base 网络)到 402 响应里的 payTo 地址,再带上交易哈希重发:

terminal · 不装任何库
curl -H "X-Payment-Tx: 0x你的交易哈希" \\
     https://feegate.org/api/supply/asset/case_status

服务端只认 USDC 合约的 transfer(address,uint256) 事件:收款地址必须等于该资产的 payTo、金额不得少于标价、且 status=0x1。第三条通道是人民币积分:Authorization: Bearer fg_…。

402 报错对照表

看到什么它是什么怎么办
402 + accepts JSON正常的付费挑战(价目牌)按 accepts 付款后重发同一请求
402 + 积分余额不足fg_ Key 的积分不够扣充值积分,或改走链上 USDC 通道
连接超时 / 代理报错本地代理拦截了请求设 NO_PROXY 环境变量后重试
MCP 报 _meta 相关错误自写客户端没透传参数把 params["_meta"] 原样透传给服务端
isError=true 且未扣费源站暂时取不到数据平台不收这笔钱(已扣自动退回),稍后重试