MCPInstall

jupiter-swap-migration

by jup-agCode Quality & Workflow

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.

Installs
285
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/jup-ag/agent-skills --skill jupiter-swap-migration
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads jupiter-swap-migration automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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 (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

SourceTargetEffortWhen to choose
Ultra → /orderGET /swap/v2/order + POST /swap/v2/executeMinimal (URL change only)Default for Ultra users
Metis → /buildGET /swap/v2/buildModerate (parameter + response mapping)Need transaction composability
Metis → /orderGET /swap/v2/order + POST /swap/v2/executeModerate (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 — Minimal migration, base URL change only
  • Path 2: Metis → /build — Consolidates 2 calls into 1, parameter and response mapping
  • Path 3: Metis → /order — 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
  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):

FAQ

What does the jupiter-swap-migration skill do?

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.

How do I install jupiter-swap-migration?

Run npx skills add https://github.com/jup-ag/agent-skills --skill jupiter-swap-migration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/jupiter-swap-migration/ (personal) or .claude/skills/jupiter-swap-migration/ (project).

Which AI agents can use jupiter-swap-migration?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is jupiter-swap-migration safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains jupiter-swap-migration?

It is published by jup-ag in jup-ag/agent-skills. It has 285 recorded installs.

More from jup-ag/agent-skills

View all →

integrating-jupiter

jup-ag/agent-skills

Comprehensive guidance for integrating Jupiter APIs (Swap, Lend, Perps, Trigger, Recurring, Tokens, Price, Portfolio, Prediction Markets, Send, Studio, Lock, Routing). Use for endpoint selection, integration flows, error handling, and production hardening.

AI & Agents818 installs

jupiter-lend

jup-ag/agent-skills

Interact with Jupiter Lend Protocol. Read-only SDK (@jup-ag/lend-read) for querying liquidity pools, lending markets (jlTokens), and vaults. Write SDK (@jup-ag/lend) for lending (deposit/withdraw) and vault operations (deposit collateral, borrow, repay, manage positions).

AI & Agents316 installs

jupiter-vrfd

jup-ag/agent-skills

Use when a user mentions Jupiter token verification, VRFD eligibility, paying 1000 JUP to verify a token, submitting a verification request, or updating metadata via the Jupiter express verification flow.

Backend & APIs245 installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Code Quality & Workflow1.4M installs

improve-codebase-architecture

mattpocock/skills

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

Code Quality & Workflow1.2M installs

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

Code Quality & Workflow1.1M installs

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

Code Quality & Workflow890.6K installs

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

Code Quality & Workflow863.8K installs

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Code Quality & Workflow848.4K installs