快速入門
5 條 curl 命令，從零完成一筆可追蹤的跨鏈訂單。Direct API 面向已審核 Partner 整合；可在這裡申請。
沙盒 vs 正式。 先用 sandbox 金鑰驗證 HTTP 流程。存款地址 UI、memo 處理和狀態追蹤通過 review 後，再切換到 live 金鑰。
1. 取得 API 金鑰
每次請求需要兩個 header：X-Key-Id 標識金鑰，Authorization: Bearer 攜帶密文。密文必須只放伺服器端，不能進入瀏覽器。
X-Key-Id: ak_live_yourapp
Authorization: Bearer sk_live_REPLACE_ME
Content-Type: application/json更多細節見 身份驗證，包括金鑰輪換和 scope 行為。
2. 列出可路由資產
資產使用 CAIP-19 標識。保存回傳的 assetId；後續作為 originAsset 和 destinationAsset 傳入。
curl https://api.allswap.io/v1/assets \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."3. 預覽報價
傳 dry: true 取得不具約束力的預覽。回應回傳 provider 候選、best provider、目標金額、費用估算和 ETA。
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 '{
"originAsset": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
"destinationAsset": "tron:mainnet/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1000000000",
"sender": "0xYourSourceAddress",
"recipient": "TYourDestinationAddress",
"dry": true
}'amount 永遠使用來源資產最小單位。使用者確認前應重新整理一次預覽，因為流動性和 provider 可用性會快速變化。
4. 建立訂單
把使用者接受的路由連同 providerId 一起提交。Allswap 回傳一次性 depositAddress；如果有 depositMemo，必須和地址一起展示，並要求使用者同時複製。
curl -X POST https://api.allswap.io/v1/order \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"originAsset": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
"destinationAsset": "tron:mainnet/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"amount": "1000000000",
"sender": "0xYourSourceAddress",
"recipient": "TYourDestinationAddress",
"providerId": "route_A"
}'存款地址模式。 你的應用不負責簽名交易。使用者從自己的錢包向存款地址轉帳；偵測到入金後，Allswap 執行後續兌換。
5. 追蹤狀態
每 10-15 秒輪詢 GET /v1/order/{id} 直到終態；Partner 帳號開通後也可以使用 webhook。
curl https://api.allswap.io/v1/order/ord_01HW9... \
-H "X-Key-Id: ak_live_yourapp" \
-H "Authorization: Bearer sk_live_..."