Binance Agentic Wallet

安裝 Skill

支援 skills 生態的 Agent 執行環境（Claude Code、OpenClaw 等）：

npx skills add binance/binance-skills-hub/skills/binance-web3/binance-agentic-wallet

這會從 binance-skills-hub 倉庫安裝 skill 及 baw CLI（npm 套件 @binance/agentic-wallet）。只裝 CLI：

npm install -g @binance/agentic-wallet

登入錢包

baw auth signin --json

回應包含 urlForWeb 與 pairingCode。開啟該 URL，核對配對碼一致後在幣安 App 中確認登入。然後驗證：

baw auth verify --qrCodeId <signin 回傳的 qrCodeId> --json

baw wallet status 應顯示錢包已連接；baw wallet balance 可查看代幣餘額。

建立 Linkex 充值訂單

curl -s -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, "network": "eip155:56"}'

回應中的 data.challenge 是 x402 v2 PaymentRequired 物件。保存它——這是下一步的輸入。（network 可選；此處示範 BNB Chain，因為 B402 結算是幣安原生的。）

預覽付款

把 challenge 餵給 baw：

baw x402-payment preview --paymentRequirements '<challenge JSON>' --json

回應列出付款選項（index 從 1 開始），各自標註狀態：

• READY_TO_SIGN——可直接簽名
• ACTION_REQUIRED——如 INSUFFICIENT_BALANCE；先為錢包充值
• NOT_SIGNABLE——如不支援的網路；換一個選項

記下 paymentId 與所選選項的 index。

簽名

baw x402-payment sign --paymentId <paymentId> --selectedIndex 1 --json

回傳 paymentHeaderValue——base64 編碼的簽名 x402 payload。若 approveTxHash 非空（BSC 上 USDT/USDC 的首次 Permit2 付款），先等該授權交易確認再繼續；BSC 上授權的 Gas 由平台代付。

提交到 Linkex

paymentHeaderValue 解碼後就是支付端點期望的 JSON payload：

echo '<paymentHeaderValue>' | base64 -d > payload.json

curl -s -X POST https://linkex.ai/api/x402/pay/<order_id> \
  -H "Content-Type: application/json" \
  -d @payload.json

成功回應為 "status": "settled"（或 credit_pending——一兩分鐘內入帳）。

驗證到帳

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

quota_usd 應增加了訂單金額。完成——你的 Agent 為自己的推理預算付了款。