---
title: "POST /swap"
method: POST
path: "/swap"
---

# POST /swap

`POST /swap`

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

## Request body

- SwapRequest
  - `userPublicKey` string, required — The user public key.
  - `wrapAndUnwrapSol` boolean — Default is true. If true, will automatically wrap/unwrap SOL. If false, it will use wSOL token account. Will be ignored if `destinationTokenAccount` is set because the `destinationTokenAccount` may belong to a different user that we have no authority to close.
  - `useSharedAccounts` boolean — Default is true. This enables the usage of shared program accountns. 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.
  - `feeAccount` string — Fee token account, same as the output token for ExactIn and as the input token for ExactOut, it is derived using the seeds = ["referral_ata", referral_account, mint] and the `REFER4ZgmyYx9c6He5XfaTMiGfdLwRnkV4RPp9t9iF3` referral contract (only pass in if you set a feeBps and make sure that the feeAccount has been created).
  - `computeUnitPriceMicroLamports` union — 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.
    - integer
    - 'auto'
  - `prioritizationFeeLamports` union — Prioritization fee lamports paid for the transaction in addition to the signatures fee. Mutually exclusive with compute_unit_price_micro_lamports. If `auto` is used, Jupiter will automatically set a priority fee and it will be capped at 5,000,000 lamports / 0.005 SOL.
    - integer
    - 'auto'
  - `asLegacyTransaction` boolean — Default is false. 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.
  - `useTokenLedger` boolean — Default is false. This is useful when the instruction before the swap has a transfer that increases the input token amount. Then, the swap will just use the difference between the token ledger token amount and post token amount.
  - `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.
  - `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. Default is `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.
  - `programAuthorityId` integer — The program authority id [0;7], load balanced across the available set by default
  - `quoteResponse` QuoteResponse, required
    - `inputMint` string, required
    - `inAmount` string, required
    - `outputMint` string, required
    - `outAmount` string, required
    - `otherAmountThreshold` string, required
    - `swapMode` 'ExactIn' | 'ExactOut', required
    - `slippageBps` integer, required
    - `computedAutoSlippage` integer
    - `platformFee` PlatformFee
      - `amount` string
      - `feeBps` integer
    - `priceImpactPct` string, required
    - `routePlan` RoutePlanStep[], required
      - `swapInfo` SwapInfo, required
        - `ammKey` string, required
        - `label` string
        - `inputMint` string, required
        - `outputMint` string, required
        - `inAmount` string, required
        - `outAmount` string, required
        - `feeAmount` string, required
        - `feeMint` string, required
      - `percent` integer, required
    - `contextSlot` number
    - `timeTaken` number

## Response `200`

Successful response

- SwapResponse
  - `swapTransaction` string, required
  - `lastValidBlockHeight` number, required
  - `prioritizationFeeLamports` number

## Changes

- **2024-05-14** `fff6d63fb209` — 1 info
  - added the new optional request property `programAuthorityId`
- **2024-03-13** `dcb687454346` — 1 info
  - added the new optional request property `quoteResponse/computedAutoSlippage`
- **2024-02-13** `f90147586d42` — 1 warning, 2 info
  - removed the request property `restrictIntermediateTokens`
  - request property `computeUnitPriceMicroLamports` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `prioritizationFeeLamports` list-of-types was widened by adding types `string` to media type `application/json`
- **2023-12-27** `194dfbeeaeff` — 2 info
  - added the new optional request property `skipUserAccountsRpcCalls`
  - added the optional property `prioritizationFeeLamports` to the response with the `200` status
- **2023-12-19** `4920fcf26458` — 2 breaking, 1 info
  - the `computeUnitPriceMicroLamports` request property type changed from `integer` to `integer, string`
  - the `prioritizationFeeLamports` request property type changed from `integer` to `integer, string`
  - added the new optional request property `restrictIntermediateTokens`

[Full history](https://skmtc.dev/jup-ag/apis/swap-api/changes/swap/post.md)

---

[API](https://skmtc.dev/jup-ag/apis/swap-api.md) · [All operations](https://skmtc.dev/jup-ag/apis/swap-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jup-ag/swap-api/revisions/a977dff6eddf/schema)