x402 自動充值

x402 充值是加密錢包流程的程式化版本：同一套訂單機制，但由程式碼而非瀏覽器對話框驅動。本頁是面向人類讀者的概覽；完整協議參考（端點、challenge schema、錯誤碼）見 x402 協議。

四次呼叫

1. 建立訂單——用你的 API Key（或 Agent Key）認證：

curl -X POST https://linkex.ai/api/user/topup/x402/orders \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount_usd": 5}'

回應包含 x402 v2 challenge：鏈、代幣合約、原子單位金額、收款地址（payTo）與 10 分鐘有效期。

2. 簽署——使用任何支援 x402 v2 的錢包：

   • Binance Agentic Wallet（baw x402-payment preview / sign）
   • @linkexai/agent-sdk（EVM 用 buildX402PaymentPayload，Solana 用 buildSvmPaymentPayload）
   • Coinbase x402 工具鏈，或你自己的 EIP-3009 / Permit2 / Solana 簽名器

3. 提交簽名後的 payload——注意此端點是公開的，簽名本身即授權：

curl -X POST https://linkex.ai/api/x402/pay/ORDER_ID \
  -H "Content-Type: application/json" \
  -d @signed-payload.json

4. 確認——回應為 settled（立即入帳）或 credit_pending（鏈上確認後入帳）。驗證餘額：

curl https://linkex.ai/api/user/self/balance \
  -H "Authorization: Bearer sk-YOUR_KEY"

為什麼用 Agent Key

用普通帳戶 Key 也能下單，但 Agent Key 多一層防護：訂單綁定該 Agent 錢包，且單筆／每日／總額消費上限在結算時強制執行（超限回傳 SPEND_CAP_EXCEEDED）。失控的 Agent 無法超出你設定的上限掏空資金錢包。詳見 Agent 憑證。

保持 Agent 有錢可用

• 半自動（瀏覽器）： 控制台的 Keep Funded 頁面輪詢餘額，低於閾值時提示你簽名充值。
• 全自動： 在自己的執行環境用 @linkexai/agent-sdk 或 linkex/funder Docker 映像跑充值迴圈——輪詢 GET /api/user/self/balance，餘額低時下單、簽名、提交。