給 AI Agent 用的

量化炒股的設計同時服務人類跟 LLM agent。兩個 endpoint 一定要記：/llms.txt（探索）跟 /v1/payments/x402（付費）。

/llms.txt — 機器可讀規格

扁平 markdown 規格，Claude / GPT / DeepSeek 等 agent 可以直接 fetch 後塞進 context，不用解析 Swagger UI。

# Quant ChaoGu
> Lean Taiwan-stock market-data API.

## Authentication
Header: X-API-Key: <key>   # or "Authorization: Bearer <key>"

## Endpoints
- GET  /v1/data/{dataset}   — query a dataset
- POST /v1/ask              — natural-language → SQL (Plus tier)
- GET  /v1/agent/{dataset}  — same data, paid per-call via x402

# (full spec: https://quantchaogu.duckdns.org/api/llms.txt)

x402 微支付

x402 標準把 HTTP 402 變成付款意圖。我們收 USDC，目前在 Base Sepolia 測試網，每次呼叫 0.001–0.005 USDC。

# 1. 沒帶 key、也沒付錢
$ curl https://quantchaogu.duckdns.org/api/v1/agent/TaiwanStockPrice?stock_id=2330
HTTP/1.1 402 Payment Required
payment-required: {
  "scheme": "exact",
  "network": "eip155:84532",      # Base Sepolia
  "asset":   "0x036CbD53...DCF7e", # USDC
  "amount":  "1000",               # $0.001 (USDC has 6 decimals)
  "payTo":   "0xec5005b6dF28...0bC"
}

# 2. agent 用本地錢包簽 EIP-712 付款意圖，retry
$ curl -H "X-PAYMENT: <eip-712-signed-intent>" \
       https://quantchaogu.duckdns.org/api/v1/agent/TaiwanStockPrice?stock_id=2330
HTTP/1.1 200 OK
{ "data": [...] }

為什麼我們重視 agent 流量

友商的訂閱流程是為人類 sign-up form 設計的——這對 agent 是結構性死角。Agent 不會填 CAPTCHA、不會記得更新信用卡、撐不過年度 KYC 審查。x402 + USDC 把這些麻煩全部拿掉。趁 agent 經濟還小，先卡位。