開發者文件
x402 / AI Agents
金晰數據同時支援人類使用者與 AI agent。agent 只需兩個 endpoint：/llms.txt 用於讀取規格，/v1/payments/x402 用於付款流程。
/llms.txt — machine-readable spec
一份純文字 Markdown 規格。Claude、GPT、DeepSeek 等 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 是 agent 的主要規格來源。資料集名稱、tier、欄位與範例查詢都列於其中，格式可放入 LLM context。
x402 微支付
x402 將 HTTP 402 用作付款要求。金晰數據在 Base 主網收取 USDC，Lite 資料集每次呼叫 $0.05，Plus 資料集每次呼叫 $0.20，並由 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 流量
傳統訂閱流程通常假設使用者可填寫表單；agent 無法處理 CAPTCHA、信用卡到期更新或定期 KYC。x402 與 USDC 取消這些前提，agent 可按次付費使用資料。