快速入門
5 條 curl 命令，從零完成一筆可追蹤的跨鏈兌換。預計 15 分鐘。你需要一個 API 金鑰（在這裡申請），以及目標鏈上的一個錢包地址。
沙盒 vs 正式。 每個金鑰預設是沙盒模式 —— 報價真實，但 swap 不會真的動鏈上資金。準備好之後在控制台把金鑰切到 live。
1. 取得 API 金鑰
每次請求需要兩個 header 驗證：X-Key-Id 標識金鑰（可以公開），Authorization: Bearer 攜帶密文（僅伺服器端使用 —— 絕不能打進瀏覽器 bundle）。
X-Key-Id: ak_live_yourapp
Authorization: Bearer sk_live_REPLACE_ME
Content-Type: application/json詳見 身份驗證 章節 —— 包括金鑰輪換、scope 權限、以及如何避免把密文暴露到前端 bundle 裡。
2. 列出支援的代幣
代幣用 CAIP-19 資產 ID 標識。這個介面回傳當前所有可路由的代幣，含鏈名、精度、logo URL。
curl https://api.allswap.io/v1/tokens \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."3. 報價
報價是不具約束力的價格預覽。我們並行聚合所有支援的路由，回傳最優 amount_out 以及後續要提交的 route ID。報價約 30 秒過期。
curl -X POST https://api.allswap.io/v1/quote \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"from": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
"to": "tron:mainnet/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1000000000",
"sender": "0xYourUserEvmAddress",
"recipient": "TYourUserTronAddress"
}'amount 永遠用最小單位（USDT 6 位精度 → 1,000,000,000 表示 1,000 USDT）。route 欄位對外不透明 —— 我們會根據當前流動性回傳 Route A 或 Route B。參見 概念 → 路由。
4. 提交兌換
把剛拿到的 quoteId 傳回來。我們產生一次性存款地址；使用者向該地址轉帳後，swap 自動觸發執行。
curl -X POST https://api.allswap.io/v1/swap \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{ "quoteId": "qt_01HW9..." }'存款地址模式。 你這邊不需要錢包 SDK。讓使用者把準確數額的
depositAmount 轉入 depositAddress —— 剩下的我們來。在 UI 上同時顯示 QR 碼和等寬字體的地址。5. 追蹤狀態
每 10–15 秒輪詢一次，或者接 webhook（推薦）。狀態在一個小型狀態機裡流轉 —— 參見 概念 → 交易。
curl https://api.allswap.io/v1/swap/sw_01HW9... \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."