核心概念
Allswap API 裡有 4 個反覆出現的名詞：路由 (route) 是穿越流動性的路徑，報價 (quote) 是該路徑上的價格預覽，訂單 (order) 是已提交的存款地址兌換，費用 (fees) 是成本結構。這一頁是介面背後的心智模型。
路由
一條路由是把 A 鏈上的來源資產搬到 B 鏈上的目標資產的某種方式。我們對接了上游多條聚合路由 —— 內部分別記作 route_A、route_B 等 —— 每次報價選擇一條 provider 路由。
從你的視角看，路由選擇是不透明的：你發起報價、拿到選定路徑的 amount_out 加上一個字串標識。除非你想記日誌，否則不需要關心走了哪條。
為什麼屏蔽細節： 上游路由一直在變。報價模型在變、欄位在變、新路由上線舊路由被棄用。我們把這些全吸收在穩定的對外契約後面，讓你的整合不需要每季度返工。
報價
報價是一份 不具約束力 的價格預覽。它告訴你此刻這筆輸入在目標鏈上能拿到多少。報價的特點：
- 約 30 秒過期。 行情在動；我們不接受過期價格。
- 免費。 報價不收費，只佔用你當前檔位的
quotes/month配額，不佔用任何 swap 配額。 - 回傳 provider 候選。 dry quote 會回傳可用 provider 路由和選定的
best標識。提交時把使用者接受的報價參數和providerId發到POST /v1/order。
在 swap 確認頁上，建議每 ~10 秒重新整理一次報價。我們按金鑰限速，但 10 秒重新整理在任何檔位都遠低於限額。
訂單
一筆訂單就是已提交的動作 —— 你把使用者接受的報價參數和 provider 呼叫 POST /v1/order，我們就會產生一次性存款地址並開始監聽資金。這筆訂單在以下狀態機裡流轉：
你可能遇到的狀態：
PENDING—— 存款地址已生效，等待資金到達。部分 provider 會回傳 deadline，過期後訂單取消。PROCESSING—— 入金已偵測或確認，路由執行中。多數訂單從這一步算起幾分鐘內結算。SUCCESS—— 目標鏈資金已交付，含settlementTxHash。REFUNDED—— 中途出現問題且退款處理已完成，含refundTxHash。FAILED—— 收到存款但無法透過正常路徑結算，也無法在不經支援核驗的情況下完成退款處理。極少發生；請帶上 orderId 聯絡技術支援。
可以選擇每 10–15 秒輪詢 GET /v1/order/:id，也可以在 Partner 帳號開通後消費 webhook。Webhook 是 at-least-once 投遞 —— 把處理邏輯寫成對 orderId 冪等。
費用
報價回應把成本拆成兩塊：
fee.platformBps—— 平台費率，按輸入金額的 bps 收取。已經從amount_out裡扣過，不會另外加收。預設 25 bps (0.25%)，Enterprise 檔可協商。fee.networkUsd—— gas + 結算成本，折算成美元用於展示。從流動性中支付，不會額外加到使用者錢包上。
我們不做的事： 我們絕不按筆向你收費。月度帳單只包含檔位費用本身。平台 bps 是從 swap 流程內部收取，不走你的帳戶。