開發者文件
x402 / AI Agents
Clarifindata 同時服務人類與 AI agent。兩個 endpoint 最重要：/llms.txt（探索）與 /v1/payments/x402（付費）。
/llms.txt — machine-readable spec
扁平 Markdown 規格，Claude / GPT / DeepSeek 等 LLM agent 可以直接 fetch 後塞進 context，不需要解析 Swagger UI。
bash
# Fetch the manifest curl "https://api.clarifindata.com/llms.txt" # Or in your agent's system prompt / tool setup: # GET https://api.clarifindata.com/llms.txt
ℹ
/llms.txt 是 AI agent 的 canonical 規格來源。它包含所有資料集名稱、tier、欄位和範例查詢——比文件更適合直接放進 LLM context。
x402 微支付
x402 標準把 HTTP 402 變成付款意圖。我們在 Base 主網收 USDC，每次呼叫 $0.05（Lite 資料集）/ $0.20（Plus），由 xpay 非託管結算。
| 資料集 Tier | 每次費用 | 結算網路 | 代幣 |
|---|---|---|---|
| Lite | $0.05 USDC | Base mainnet | USDC |
| Plus | $0.20 USDC | Base mainnet | USDC |
Agent 流程（偽代碼）
python
import httpx
# Step 1: Agent sends a request without payment — gets 402
resp = httpx.get(
"https://api.clarifindata.com/v1/data/TaiwanStockPrice",
params={"stock_id": "2330", "limit": 5},
)
# resp.status_code == 402
# resp.headers["X-Payment-Instructions"] contains payment details
# Step 2: Agent signs USDC payment intent (via xpay / Base wallet)
payment_header = sign_x402_payment(resp.headers["X-Payment-Instructions"])
# Step 3: Agent retries with the signed payment header
resp = httpx.get(
"https://api.clarifindata.com/v1/data/TaiwanStockPrice",
params={"stock_id": "2330", "limit": 5},
headers={"X-Payment": payment_header},
)
# resp.status_code == 200 ← data is served while settlement happens on-chain為什麼我們重視 agent 流量
現有友商的訂閱流程是為人類 sign-up form 設計的——對 agent 是結構性死角。Agent 不會填 CAPTCHA、不會記得更新信用卡、撐不過年度 KYC 審查。x402 + USDC 把這些麻煩全部拿掉。趁 agent 經濟還小，先卡位。