用途:该技能用于集成 Jupiter 系列 API,帮助在 Ultra Swap、Lend、Perps、Trigger(限价单)、Recurring(定投)、Tokens、Price、Portfolio、Prediction Markets、Send、Studio、Lock 及路由等场景中选择并调用正确端点,也可用于调试 Jupiter API 调用。不适用于不涉及 Jupiter API 的通用 Solana 配置,或仅做 UI、不涉及 API 行为决策的任务。
主要能力:提供意图路由表,将交换/报价、借贷/收益、杠杆/永续、限价单、定投、代币搜索与验证、价格查询、持仓、预测市场、邀请转账、发币与费用、归属/分发锁、DEX/RFQ 集成等意图映射到对应 API family 与首个动作。各 API playbook 给出 Base URL、认证、端点、费用、分页、约束与注意事项。
必要用法:Base URL 为 https://api.jup.ag,认证使用来自 portal.jup.ag 的 x-api-key(Jupiter REST 端点必需)。示例:const headers = { 'x-api-key': API_KEY };。订单类流程普遍为创建/签名/执行分离,例如 Ultra Swap:GET /ultra/v1/order -> 签名 -> POST /ultra/v1/execute。
限制与注意:Ultra 签名载荷约 2 分钟 TTL;Trigger 前端 5 USD 最低、链上无最低、默认零滑点、不支持 Token-2022;Recurring 最低总额 100 USD、每单 50 USD、至少 2 单、不支持 Token-2022,且已弃用基于价格的订单;Price 每次最多 50 个 mint;Perps 暂无 REST 端点,仅链上 Anchor IDL;Prediction Markets 处于 Beta、美国与韩国 IP 受限;Lock 无 REST API;Studio 必须通过 /dbc-pool/submit 提交。遇 429 应退避并等待 10 秒滑动窗口刷新,其余细节以官方最新文档为准。