QUICKSTART · 5 分钟
从 curl 到第一笔付费调用
resolve 永久免费。付费端点走 x402：没有账户、没有 API Key、没有预充值——付款凭证就是身份凭证。下面每一段代码都在生产环境实测跑通后才放上来。
01
免费起步：解析一台设备
# 1) 免费解析（无需任何密钥）
curl https://cvin.org/v1/resolve/cvin%3Anv.h100.sxm.80g%3A6a1kfvdo43buqm34
# 2) 看一眼 402 挑战长什么样（不花钱）
curl -i https://cvin.org/v1/history/cvin%3Anv.h100.sxm.80g%3A6a1kfvdo43buqm34 | head -30
# 3) 挑战体里的关键信息：收款地址 / 网络 / 金额
# payTo: 0x230cd9cd33589bcf33cd32e5aa4f9e0c3994a63b
# network: eip155:8453 · asset: USDC · $0.05/次resolve 返回存在性、身份分级（M/L0/L1/L2）、最近观测与风险信号计数。想用哪台设备，先看它的 身份级别 能不能支撑你的用途。
02
付费调用：完整历史（x402 真结算）
# pip install "x402[requests]" eth-account
# 已在 2026-11-02 用 x402 SDK 2.25 实测跑通（真实付款 0.05 USDC 上链）
import requests
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import wrapRequestsWithPayment
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme
account = Account.from_key("0x你的私钥") # 只在本地签名，私钥不发网络
client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(signer=EthAccountSigner(account)))
session = wrapRequestsWithPayment(requests.Session(), client)
r = session.get("https://cvin.org/v1/history/cvin:nv.h100.sxm.80g:6a1kfvdo43buqm34", timeout=120)
print(r.status_code) # 200 —— 付款已上链，服务端核对后才放行
print(r.json()["billing"]) # {"via": "x402-onchain", "tx": "0x…", "amount_usd": 0.05}
# 结算回执在响应头 PAYMENT-RESPONSE（base64 JSON），可与 Basescan 对账流程：第一次请求拿到 402 + PAYMENT-REQUIRED 挑战 → SDK 用你的钱包签 EIP-3009 授权 → facilitator 验签并在 Base 主网结算 → 结算成功服务端才返回 200。结算回执在
PAYMENT-RESPONSE 头里，可拿 tx 去 Basescan 核对。失败时看什么：402 响应体里的
reason 字段会写明原因——facilitator_rejected: invalid_exact_evm_signature（签名无效）、insufficient amount（金额不足）、payment already spent（同一回执重复使用）。503 settlement_unavailable 表示结算通道暂时不可用，本次未计费，稍后重试。03
Agent 接入：MCP 端点
# MCP 端点（Agent 原生调用）：POST https://cvin.org/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"cvin_resolve","arguments":{"cvin":"cvin:nv.h100.sxm.80g:6a1kfvdo43buqm34"}}}
# cvin_resolve / cvin_encode / cvin_events / cvin_clauses 免费
# cvin_history / cvin_verify 按次 $0.05（x402，回执放 X-PAYMENT 或 PAYMENT-SIGNATURE 头）工具清单：POST https://cvin.org/mcp + {"method":"tools/list"}。 resolve / encode / events / clauses 免费，history / verify 按次计费。
04
规模化使用：订阅 Key
高频风控场景按次付款不划算：年订阅含完整历史、连续性证明、抵押权 webhook 与额度。走 订阅 或直接联系，签发后请求带 X-Api-Key 头即可，付费端点自动直通。