用途:本技能用于把既有的 Jupiter 兑换集成从 Metis(v1)或 Ultra 迁移到统一的 Swap API v2,适用于调用 api.jup.ag/swap/v1/quote、swap-instructions 或 ultra-api.jup.ag 的代码,以及需要更新端点到 v2、把 Metis 两步流程改为统一 /build 或 /order 端点的场景。全新集成或非兑换类 API(Lend、Trigger、Recurring 等)不应使用本技能。
主要能力与目标:目标 Base URL 为 https://api.jup.ag/swap/v2,鉴权方式不变,使用 developers.jup.ag 的 x-api-key。资料给出三条迁移路径:Ultra → /order(改动最小,仅换 URL,为 Ultra 用户默认选择);Metis → /build(改动中等,需做参数与响应映射,适合需要交易可组合性);Metis → /order(改动中等,改为托管执行并支持多路由器竞争)。每条路径均有专门的示例。
迁移后检查清单:审计代码库中的 ultra-api.jup.ag、/ultra/v1/、/swap/v1/quote、/swap/v1/swap-instructions 并替换;/build 路径将 userPublicKey 重命名为 taker;V2 仅支持 ExactIn,swapMode 被移除,ExactOut 需重新设计流程;/build 省略 slippageBps 时默认 50 bps,/order 的默认值需自行确认;/execute 响应使用 inputAmountResult/outputAmountResult;/build 中 addressLookupTableAddresses(数组)改为 addressesByLookupTableAddress(对象)并移除 RPC ALT 解析代码;V2 指令不再发出 fee 事件;路由计划使用 bps 字段而非 percent;更新错误码处理;最后在 devnet/mainnet 用小额完成端到端测试。
限制与下线:当 Jupiter 停用 v1 端点与 Ultra 域名后应移除本技能;建议在 2026-09-01 复核 v1/Ultra 端点是否已下线。迁移内容现拆分为三份面向不同目标的指南,原单一迁移页已不存在。其余细节资料暂未提供。