Skip to content
cccskills
FreePublished on GitHub

jupiter-swap-migration

Guides migration of existing Jupiter swap integrations from Metis or Ultra to Swap API v2. It helps choose a migration path and check endpoint URLs, parameters, response fields, and execution flow changes.

OriginalShow the original 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.

internet-court/internet-court-skill

Run score Not tested

See how to install

Good for

  • Migrating Ultra integrations to /order and /execute
  • Replacing the Metis two-call flow with /build
  • Moving Metis integrations to managed execution
  • Checking parameters and response handling after migration

Files included (6)

  • SKILL.md4.8 KB
  • examples/metis-to-build.md4.2 KB
  • examples/metis-to-order.md2.4 KB
  • examples/ultra-to-order.md2.1 KB
  • LICENSE1.0 KB
  • README.md1.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

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):

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

0g-compute

FreeSummary

Build chat, image generation, and speech transcription features on 0G Compute Network, a distributed GPU marketplace. This skill guides SDK integration, model fine-tuning, response processing for billing, and account funding through code patterns and CLI commands.

  • Integrating chat and image generation into an application
  • Preparing model fine-tuning jobs
  • Checking balances and funding provider accounts
internet-court/internet-court-skill7KUpdated Aug 20, 2026

a2a-protocol

FreeSummary

Build servers and clients for A2A, an open protocol that lets AI agents communicate across frameworks. Publish agent capabilities, exchange tasks and results, stream progress, and add notifications for workflows involving multiple agents.

  • Connect agents built with different frameworks
  • Publish agent capabilities through an Agent Card
  • Build a research, writing, and review workflow
internet-court/internet-court-skill7KUpdated Aug 20, 2026

agent-wallet

FreeSummary

Give an AI agent a wallet with administrator-defined transaction limits. The skill covers encrypted key storage, balance checks, and sending funds through code-enforced rules for destinations, amounts, transaction frequency, and emergency shutdown.

  • Give an agent a wallet with transaction limits
  • Restrict transfers to approved chains and addresses
  • Check balances and active rules before sending
internet-court/internet-court-skill7KUpdated Aug 20, 2026

agentic-wallet

FreeSummary

Manage a crypto wallet with the awal CLI, including sign-in, balance checks, transfers, swaps, and funding. Also find and pay for APIs through x402, a payment protocol, set up paid endpoints, and query blockchain data on Base.

  • Check wallet balances across supported networks
  • Send tokens to an address or ENS name
  • Swap tokens or add wallet funds
internet-court/internet-court-skill7KUpdated Aug 20, 2026

alkahest-developer

FreeSummary

Write TypeScript, Rust, or Python code for Alkahest escrow contracts, which hold assets until conditions are met. Covers creating escrows, submitting fulfillment, collecting payments, and building custom contracts that decide whether requirements have been satisfied.

  • Integrate Alkahest escrow into an application
  • Build a bot that creates escrows and submits fulfillment
  • Implement payment collection and fulfillment monitoring
internet-court/internet-court-skill7KUpdated Aug 20, 2026

alkahest-user

FreeSummary

Use the Alkahest CLI to manage escrow, where assets are held until agreed conditions are met. It covers buyer deposits, seller fulfillment and collection, third-party decisions, token swaps, and reclaiming expired, unfulfilled deposits.

  • Creating escrow with release conditions
  • Submitting work and collecting escrowed assets
  • Approving or rejecting fulfillment as an oracle
internet-court/internet-court-skill7KUpdated Aug 20, 2026

See all skills by internet-court

Report a problem with this skill