jupiter-swap-migration — скилл для Claude Code
Скилл jupiter-swap-migration для Claude Code помогает перевести код со старых API Jupiter Metis v1 и Ultra на единый Swap API v2. Подключается при обновлении эндпоинтов обмена и замене устаревших параметров.
MIT 307 установок ★ 90 обновлён 2026-07-07
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a claude-codeЧто делает jupiter-swap-migration
Скилл переводит интеграции Jupiter со старых адресов api.jup.ag/swap/v1/quote, api.jup.ag/swap/v1/swap-instructions и ultra-api.jup.ag на базовый адрес https://api.jup.ag/swap/v2. Для пользователей Ultra процесс сводится к смене URL на связку GET /swap/v2/order и POST /swap/v2/execute. Для Metis доступен переход на единый вызов /build, объединяющий котировку и сборку транзакции, либо на управляемое исполнение через /order.
Инструкции скилла учитывают изменения протокола v2. Режим ExactOut полностью удалён, поэтому интеграции с ним требуют переработки под ExactIn. Параметр userPublicKey в маршруте /build переименован в taker, а массив таблиц адресов заменён объектом addressesByLookupTableAddress, что исключает лишние запросы к RPC для резолва ALT. Значение slippageBps для /build по умолчанию равно 50 bps, если его не передали в запросе.
Для авторизации запросов к API v2 по-прежнему нужен заголовок x-api-key с портала developers.jup.ag. Скилл не предназначен для создания интеграций с нуля или работы с другими сервисами вроде Jupiter Lend.
Какие задачи решает
- обновить устаревшие эндпоинты Jupiter swap v1 и Ultra на Swap API v2
- заменить двухэтапную схему Metis на единый запрос /build
- переписать параметры запросов при отказе от ExactOut в пользу ExactIn
- исправить разбор ответа с переходом на inputAmountResult и outputAmountResult
Примеры запросов агенту
- Обнови вызовы Jupiter Metis v1 в сервисе обмена на Swap API v2
- Переведи код с ultra-api.jup.ag на новые методы /order и /execute
- Проверь проект на вызовы swap/v1/quote и замени userPublicKey на taker
Как установить jupiter-swap-migration
1Через Skills CLI (Vercel)
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a claude-code2Вручную: положить файлы
~/.claude/skills/jupiter-swap-migration/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/jupiter-swap-migration/
1Через Skills CLI (Vercel)
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a codex2Вручную: положить файлы
.agents/skills/jupiter-swap-migration/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a cursor2Вручную: положить файлы
.cursor/skills/jupiter-swap-migration/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install jup-ag/agent-skills skills/jupiter-swap-migration2Вручную: положить файлы
.github/skills/jupiter-swap-migration/SKILL.md1Через Skills CLI (Vercel)
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a gemini-cli2Командой платформы
gemini skills install https://github.com/jup-ag/agent-skills --path skills/jupiter-swap-migrationВручную: положить файлы
.devin/skills/jupiter-swap-migration/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о jupiter-swap-migration
Как установить jupiter-swap-migration в Claude Code?
Выполните команду npx skills add jup-ag/agent-skills --skill jupiter-swap-migration -a claude-code. Файл инструкции сохранится по пути ~/.claude/skills/jupiter-swap-migration/SKILL.md.
Что делает jupiter-swap-migration?
Скилл направляет агента при миграции кода со старых версий Jupiter Swap на v2, подсказывая сопоставление полей, замену URL и изменения в структуре транзакций.
Что нужно для работы jupiter-swap-migration?
Нужен действующий ключ x-api-key с сайта developers.jup.ag для выполнения запросов к новому эндпоинту https://api.jup.ag/swap/v2.
Исходный текст
SKILL.md · MIT
--- name: jupiter-swap-migration description: Migration guide from Jupiter Metis (v1) or Ultra to Swap API v2. Use when migrating existing Jupiter swap integrations, updating base URLs, or transitioning from quote+swap-instructions to the unified build endpoint. license: MIT metadata: author: jup-ag version: "1.1.0" tags: - jupiter - swap-migration - metis - ultra - swap-v2 - jup-ag --- # Jupiter Swap Migration Guide Migrate existing Jupiter swap integrations from **Metis (v1)** or **Ultra** to the unified **Swap API v2**. **Target Base URL**: `https://api.jup.ag/swap/v2` **Auth**: `x-api-key` from [developers.jup.ag](https://developers.jup.ag/) (unchanged) ## Use/Do Not Use Use when: - Migrating code that calls `api.jup.ag/swap/v1/quote`, `api.jup.ag/swap/v1/swap-instructions`, or `ultra-api.jup.ag`. - Updating Jupiter swap endpoints to v2. - Switching from Metis two-step flow to the unified `/build` or `/order` endpoint. Do not use when: - Building a new Jupiter integration from scratch (use `integrating-jupiter` skill instead). - Working with non-swap Jupiter APIs (Lend, Trigger, Recurring, etc.). **Triggers**: `ultra`, `metis`, `ultra swap`, `ultra api`, `ultra-api.jup.ag`, `/ultra/v1`, `swap/v1`, `swap-instructions`, `migrate swap`, `ultra migration`, `metis migration`, `swap v1 to v2`, `v1 to v2`, `upgrade jupiter`, `swap-instructions deprecated`, `deprecated swap`, `old jupiter api`, `swap upgrade`, `update swap api`, `quote endpoint deprecated`, `swap stopped working`, `swap broken`, `ExactOut removed`, `swapMode removed`, `userPublicKey`, `parameter rename`, `addressLookupTable`, `response format changed` --- ## Migration Paths | Source | Target | Effort | When to choose | |--------|--------|--------|----------------| | Ultra → `/order` | `GET /swap/v2/order` + `POST /swap/v2/execute` | Minimal (URL change only) | Default for Ultra users | | Metis → `/build` | `GET /swap/v2/build` | Moderate (parameter + response mapping) | Need transaction composability | | Metis → `/order` | `GET /swap/v2/order` + `POST /swap/v2/execute` | Moderate (flow change) | Don't need tx modification, want managed execution | ## Path Details Each path has a dedicated example with before/after code, parameter mappings, and response changes: - [Path 1: Ultra → `/order`](./examples/ultra-to-order.md) — Minimal migration, base URL change only - [Path 2: Metis → `/build`](./examples/metis-to-build.md) — Consolidates 2 calls into 1, parameter and response mapping - [Path 3: Metis → `/order`](./examples/metis-to-order.md) — Flow change to managed execution with multi-router competition --- ## Post-Migration Checklist 1. **URL audit**: Search codebase for `ultra-api.jup.ag`, `/ultra/v1/`, `/swap/v1/quote`, `/swap/v1/swap-instructions` — all should be replaced 2. **Parameter rename**: `userPublicKey` → `taker` (for `/build` path) 3. **`swapMode` removal**: V2 only supports `ExactIn`. If using `ExactOut`, redesign the flow — this mode is no longer available 4. **`slippageBps` default**: `/build` defaults to 50 bps if omitted. For `/order`, verify the default if your integration relies on a specific value 5. **Response field names**: Verify your code uses `inputAmountResult`/`outputAmountResult` for the `/execute` response (the canonical v2 field names) 6. **ALT handling**: If using `/build`, switch from `addressLookupTableAddresses` (array) to `addressesByLookupTableAddress` (object) — remove RPC ALT resolution code 7. **Fee event parsing**: V2 instructions don't emit fee events — update any transaction parser that depends on them 8. **Route plan format**: If parsing route plans, use `bps` field (canonical) instead of `percent` 9. **Error codes**: Update error handling to match [Swap v2 error codes](https://developers.jup.ag/docs/swap/order-and-execute.md) 10. **Test**: Run end-to-end swap on devnet/mainnet with small amount to verify ## Sunset Remove this skill once Jupiter decommissions the v1 (`/swap/v1`) endpoints and the Ultra (`ultra-api.jup.ag`) domain. At that point all integrations will already be on v2. **Review by**: 2026-09-01 — check if v1/Ultra endpoints have been decommissioned. ## References Migration is split into three profile-targeted guides (the old single `migration` page no longer exists): - [Migration: Ultra → /order](https://developers.jup.ag/docs/swap/migration/ultra-to-order.md) - [Migration: Metis → /build](https://developers.jup.ag/docs/swap/migration/metis-to-build.md) - [Migration: Metis → Meta-Aggregator (/order + /execute)](https://developers.jup.ag/docs/swap/migration/metis-to-meta-aggregator.md) - [Order & Execute](https://developers.jup.ag/docs/swap/order-and-execute.md) - [Build](https://developers.jup.ag/docs/swap/build/index.md) - [Swap overview](https://developers.jup.ag/docs/swap/index.md) (routing and fees) - [OpenAPI spec](https://developers.jup.ag/docs/openapi-spec/swap/v2/swap.yaml)
© jup-ag · MIT · jup-ag/agent-skills