Skip to main content
POST
/
swap-instructions
swap-instructions
curl --request POST \
  --url https://api.jup.ag/swap/v1/swap-instructions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userPublicKey": "<string>",
  "quoteResponse": {
    "inputMint": "<string>",
    "inAmount": "<string>",
    "outputMint": "<string>",
    "outAmount": "<string>",
    "otherAmountThreshold": "<string>",
    "swapMode": "ExactIn",
    "slippageBps": 1,
    "priceImpactPct": "<string>",
    "routePlan": [
      {
        "swapInfo": {
          "ammKey": "<string>",
          "inputMint": "<string>",
          "outputMint": "<string>",
          "inAmount": "<string>",
          "outAmount": "<string>",
          "label": "<string>",
          "feeAmount": "<string>",
          "feeMint": "<string>"
        },
        "percent": 123,
        "bps": 123
      }
    ],
    "platformFee": {
      "amount": "<string>",
      "feeBps": 123
    },
    "contextSlot": 123,
    "timeTaken": 123,
    "mostReliableAmmsQuoteReport": {
      "info": {}
    }
  },
  "payer": "<string>",
  "wrapAndUnwrapSol": true,
  "useSharedAccounts": true,
  "feeAccount": "<string>",
  "trackingAccount": "<string>",
  "prioritizationFeeLamports": {
    "priorityLevelWithMaxLamports": {
      "priorityLevel": "medium",
      "maxLamports": 123,
      "global": false
    }
  },
  "asLegacyTransaction": false,
  "destinationTokenAccount": "<string>",
  "nativeDestinationAccount": "<string>",
  "dynamicComputeUnitLimit": false,
  "skipUserAccountsRpcCalls": false,
  "dynamicSlippage": false,
  "computeUnitPriceMicroLamports": 123,
  "blockhashSlotsToExpiry": 123
}
'
{
  "computeBudgetInstructions": [
    {
      "programId": "ComputeBudget111111111111111111111111111111",
      "accounts": [],
      "data": "AsBcAA=="
    }
  ],
  "setupInstructions": [
    {
      "programId": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
      "accounts": [
        {
          "pubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
          "isSigner": true,
          "isWritable": true
        }
      ],
      "data": ""
    }
  ],
  "swapInstruction": {
    "programId": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
    "accounts": [
      {
        "pubkey": "BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV",
        "isSigner": true,
        "isWritable": true
      }
    ],
    "data": "3Dc2AAAAAAA..."
  },
  "cleanupInstruction": null,
  "otherInstructions": [],
  "addressLookupTableAddresses": [
    "GxS6FiQ9RbErBB48mE34U4Jv13MdEJov4R1e5KgFzRFY"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://dev.jup.ag/docs/llms.txt

Use this file to discover all available pages before exploring further.

Metis Swap API is no longer actively maintained and has been superseded by Swap V2.

Authorizations

​
x-api-key
string
header
required

Get API key via https://developers.jup.ag/portal

Body

application/json
​
userPublicKey
string
required
​
quoteResponse
object
required
​
payer
string
  • Allow a custom payer to pay for the transaction fees and rent of token accounts
  • Note that users can close their ATAs elsewhere and have you reopen them again, your fees should account for this
​
wrapAndUnwrapSol
boolean
default:true
  • To automatically wrap/unwrap SOL in the transaction, as WSOL is an SPL token while native SOL is not
  • When true and input mint is SOL, it will wrap the SOL amount to WSOL and swap
  • When true and output mint is SOL, it will unwrap the WSOL back to SOL
  • When true, the wSOL token account is always closed after the transaction, regardless of whether SOL is the input or output mint
  • When false and input mint is SOL, it will use existing WSOL amount to swap
  • When false and output mint is SOL, it will not unwrap the WSOL to SOL
  • To set this parameter to false, you need to have the WSOL token account initialized
​
useSharedAccounts
boolean
  • The default is determined dynamically by the routing engine, allowing us to optimize for compute units, etc
  • This enables the usage of shared program accounts, this is essential as complex routing will require multiple intermediate token accounts which the user might not have
  • If true, you do not need to handle the creation of intermediate token accounts for the user
  • Do note, shared accounts route will fail on some new AMMs (low liquidity token)
​
feeAccount
string
  • An initialized token account that will be used to collect fees
  • The mint of the token account can only be either the input or output mint of the swap
  • Swap API no longer requires the use of the Referral Program
  • If platformFeeBps is passed in /quote, the feeAccount must be passed as well
​
trackingAccount
string
  • Specify any public key that belongs to you to track the transactions
  • Useful for integrators to get all the swap transactions from this public key
  • Query the data using a block explorer like Solscan/SolanaFM or query like Dune/Flipside
​
prioritizationFeeLamports
priorityLevelWithMaxLamports · object
  • To specify a level or amount of additional fees to prioritize the transaction
  • It can be used for EITHER priority fee OR Jito tip (not both at the same time)
  • If you want to include both, you will need to use /swap-instructions to add both at the same time
  • Defaults to auto, but preferred to use priorityLevelWithMaxLamports as it may be more accurate when accounting local fee market
  • Fixed lamports can be passed in as an integer in the prioritizationFeeLamports parameter
​
asLegacyTransaction
boolean
default:false
  • Builds a legacy transaction rather than the default versioned transaction
  • Used together with asLegacyTransaction in /quote, otherwise the transaction might be too large
​
destinationTokenAccount
string
  • Public key of a token account that will be used to receive the token out of the swap
  • If not provided, the signer's token account will be used
  • If provided, we assume that the token account is already initialized
  • destinationTokenAccount and nativeDestinationAccount are mutually exclusive
​
nativeDestinationAccount
string
  • Public key of an account that will be used to receive the native SOL token out of the swap
  • If not provided, the swap will default unwrap the WSOL and transfer the native SOL to the swap authority account
  • If provided, we will unwrap the WSOL and transfer the native SOL to the account
  • Only works if the output mint is SOL, is using the V2 instructions and the account passed in is not owned by token program
  • When sending native SOL to a new account, you must swap at least enough to cover the rent required to create it.
  • destinationTokenAccount and nativeDestinationAccount are mutually exclusive
​
dynamicComputeUnitLimit
boolean
default:false
  • When enabled, simulates the swap to provide an accurate compute unit limit in the transaction
  • This incurs one extra RPC call to simulate
  • Recommended for all normal flows — reduces priority fees needed and improves transaction landing
​
skipUserAccountsRpcCalls
boolean
default:false
  • When enabled, it will not do any additional RPC calls to check on required accounts
  • The returned swap transaction will still attempt to create required accounts regardless if it exists or not
​
dynamicSlippage
boolean
default:false
  • When enabled, it estimates slippage and apply it in the swap transaction directly, overwriting the slippageBps parameter in the quote response.
  • This is no longer maintained, we are focusing efforts on RTSE on Ultra Swap API
​
computeUnitPriceMicroLamports
integer<uint64>
  • To use an exact compute unit price to calculate priority fee
  • computeUnitLimit (1400000) * computeUnitPriceMicroLamports
  • We recommend using prioritizationFeeLamports and dynamicComputeUnitLimit instead of passing in your own compute unit price
​
blockhashSlotsToExpiry
integer<uint8>
  • Pass in the number of slots we want the transaction to be valid for
  • Example: If you pass in 10 slots, the transaction will be valid for ~400ms * 10 = approximately 4 seconds before it expires

Response

200 - application/json

Successful response

​
otherInstructions
object[]
required
  • If you set jito tips using the prioritizationFeeLamports parameter, you will see a custom tip instruction to Jito here.
​
computeBudgetInstructions
object[]
required
  • To setup the compute budget for the transaction.
​
setupInstructions
object[]
required
  • To setup required token accounts for the users.
​
swapInstruction
object
required
  • The actual swap instruction.
​
addressLookupTableAddresses
string[]
required
  • The lookup table addresses if you are using versioned transaction.
​
cleanupInstruction
object
  • To wrap and unwrap the SOL.