Skip to main content

/swap REST API Endpoint - Swap API

Returns a transaction that you can use from the quote you get from /quote.

Updated on
Oct 14, 2026
Please note that this method is only available for paid subscribers of Swap API.
Solana Kit includes the ability to customize RPC methods and transports, allowing you to seamlessly integrate Quicknode add-ons into your applications. For more information on how to use Quicknode add-ons with Solana Kit, check out these guides: How to Use Quicknode Add-ons using Solana Kit (Part 1) and How to Use Quicknode Add-ons using Solana Kit (Part 2)

GooseFX Gamma API: When using the /quote endpoint with the setting of dexes=Gamma, you should include the query parameter dexes=Gamma when using this endpoint if you want to route directly to the GooseFX Gamma API. This is in addition to setting dexes=Gamma on your initial /quote request.

Query Parameters

userPublicKey
string
REQUIRED

The user public key

payer
string

A custom payer address that will cover transaction fees and token account rent. Ensure your fee model accounts for cases where users close their ATAs and you must reopen them.

wrapAndUnwrapSol
boolean

If set to true, it will automatically wrap/unwrap SOL. If it is false, it will use wSOL token account. It will be ignored if destinationTokenAccount is set because the destinationTokenAccount may belong to a different user that we have no authority to close. By default it is set to true

useSharedAccounts
boolean

This enables the usage of shared program accounts. That means no intermediate token accounts or open orders accounts need to be created for the users. But it also means that the likelihood of hot accounts is higher. By default, it is set to true

feeAccount
string

The fee token account is derived using the seeds ['referral_ata', referral_account, mint], along with the REFER4ZgmyYx9c6He5XfaTMiGfdLwRnkV4RPp9t9iF3 referral contract. Only pass in if you set a feeBps and make sure that the feeAccount has been created

trackingAccount
string

Any public key associated with your system to track swap transactions. Useful for analytics using Solana block explorers or services like Dune or Flipside.

computeUnitPriceMicroLamports
integer

The compute unit price to prioritize the transaction, the additional fee will be computeUnitLimit (1400000) * computeUnitPriceMicroLamports. If auto is used, Jupiter will automatically set a priority fee and it will be capped at 5,000,000 lamports / 0.005 SOL

prioritizationFeeLamports
object

To specify a level or amount of additional fees to prioritize the transaction. It can be used for either the priority fee or the JITO tip. If you want to include both, you will need to use /swap-instructions to add both at the same time

priorityLevelWithMaxLamports
object

Specifies the priority level and maximum lamports for transaction prioritization

priorityLevel
string

The priority level to use for transaction prioritization. Can be set to either medium, high or veryHigh

maxLamports
integer

The maximum amount of lamports to cap the priority fee estimation to prevent overpaying

global
boolean

When set to true, the priority fee estimation will use a global estimate across the network rather than a localized estimate based on the specific accounts involved in the transaction

jitoTipLamports
integer

The exact amount of tip to use in a tip instruction for JITO. You can estimate how much to set using Jito tip percentiles endpoint. It should be used together with the Lil' JIT - Jito Bundles & Transactions add-on or Jito RPC.

jitoTipLamportsWithPayer
object

Specifies the Jito tip amount and a custom payer account to pay for the tip

lamports
integer
REQUIRED

Exact amount of lamports to use for the tip

payer
string
REQUIRED

Public key of an account that will be used to pay for the tip

asLegacyTransaction
boolean

Request a legacy transaction rather than the default versioned transaction, needs to be paired with a quote using asLegacyTransaction otherwise the transaction might be too large. By default it is set as 'False'

destinationTokenAccount
string

Public key of the token account that will be used to receive the token out of the swap. If not provided, the user's ATA will be used. If provided, we assume that the token account is already initialized

nativeDestinationAccount
string

Public key of an account that will be used to receive native SOL out of the swap. This only works when the output mint is SOL. The account must not be owned by the token program. If not provided, the wrapped SOL will be unwrapped and the native SOL will be sent to the swap authority account. When sending native SOL to a new account, you must swap at least enough to cover the rent required to create it. This parameter is mutually exclusive with destinationTokenAccount

dynamicComputeUnitLimit
boolean

When enabled, it will do a swap simulation to get the compute unit used and set it in ComputeBudget's compute unit limit. This will increase latency slightly since there will be one extra RPC call to simulate this. By default, it is set to false

skipUserAccountsRpcCalls
boolean

When enabled, it will not do any rpc calls check on user's accounts. Enable it only when you already setup all the accounts needed for the trasaction, like wrapping or unwrapping sol, destination account is already created.

dynamicSlippage
boolean

When enabled, the swap transaction estimates slippage dynamically and overrides the slippageBps value from the /quote response. This must be used together with dynamicSlippage in the /quote call; otherwise, the static slippageBps from /quote will be used instead. Default is false.

blockhashSlotsToExpiry
integer

The number of slots for which the transaction remains valid

quoteResponse
object
REQUIRED

The quoteResponse object which you can get from the response from the /quote method

inputMint
string
REQUIRED

The source token's mint address

inAmount
string
REQUIRED

The amount of the source token being swapped

outputMint
string
REQUIRED

The destination token's mint address

outAmount
string
REQUIRED

Calculated output amount from the routing engine. Value includes platform fees and DEX fees, excluding slippage

otherAmountThreshold
string
REQUIRED

Calculated minimum output amount after accounting for slippageBps on the outAmount value

swapMode
string
REQUIRED

Indicates the swap mode

slippageBps
integer
REQUIRED

Slippage tolerance in basis points

platformFee
object

The platform Fee object which contains the following fields:

amount
string

The amount of the platform fee

feeBps
integer

The fee percentage in basis points

priceImpactPct
string
REQUIRED

The percentage of price impact due to the swap

routePlan
array
REQUIRED

An array containing detailed information about each step of the swap process

swapInfo
object
REQUIRED

Detailed information about a specific swap step

ammKey
string
REQUIRED

The key identifying the Automated Market Maker (AMM) responsible for the swap

label
string

A label or identifier for the AMM

inputMint
string
REQUIRED

The mint address of the token being swapped from in this step

outputMint
string
REQUIRED

The mint address of the token being received in this step

inAmount
string
REQUIRED

The amount of the token being swapped from in this step

outAmount
string
REQUIRED

The amount of the token being received after the swap in this step

feeAmount
string
REQUIRED

The amount of fee charged for this step of the swap

feeMint
string
REQUIRED

The mint address of the token used for paying fees in this step

percent
integer
REQUIRED

The percentage allocation of the swap for this step

bps
integer

The basis points allocation of the swap for this step

instructionVersion
string

The version of instruction used in the swap program. Possible values: V1 or V2, or null

contextSlot
integer

A contextual identifier

timeTaken
integer

Time taken for the request to be processed

Returns

swapTransaction
string

The serialized transaction for the swap

lastValidBlockHeight
integer

The last valid block height

prioritizationFeeLamports
integer

The prioritization fee in lamports

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free
Last updated on