Get Order

Get a swap quote and assembled transaction

GET /order

Get Order

cURL

curl --request GET \
  --url https://api.jup.ag/swap/v2/order \
  --header 'x-api-key: <api-key>'

200

{
  "mode": "<string>",
  "inputMint": "<string>",
  "outputMint": "<string>",
  "inAmount": "<string>",
  "outAmount": "<string>",
  "inUsdValue": 123,
  "outUsdValue": 123,
  "priceImpact": 123,
  "swapUsdValue": 123,
  "otherAmountThreshold": "<string>",
  "swapMode": "<string>",
  "slippageBps": 123,
  "priceImpactPct": "<string>",
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "<string>",
        "label": "<string>",
        "inputMint": "<string>",
        "outputMint": "<string>",
        "inAmount": "<string>",
        "outAmount": "<string>"
      },
      "percent": 123,
      "bps": 123,
      "usdValue": 123
    }
  ],
  "referralAccount": "<string>",
  "feeMint": "<string>",
  "feeBps": 123,
  "platformFee": {
    "amount": "<string>",
    "feeBps": 123,
    "feeMint": "<string>"
  },
  "signatureFeeLamports": 123,
  "signatureFeePayer": "<string>",
  "prioritizationFeeLamports": 123,
  "prioritizationFeePayer": "<string>",
  "rentFeeLamports": 123,
  "rentFeePayer": "<string>",
  "swapType": "aggregator",
  "router": "iris",
  "transaction": "<string>",
  "lastValidBlockHeight": "<string>",
  "gasless": true,
  "requestId": "<string>",
  "totalTime": 123,
  "taker": "<string>",
  "quoteId": "<string>",
  "maker": "<string>",
  "expireAt": "<string>",
  "errorCode": 123,
  "errorMessage": "<string>",
  "error": "<string>"
}

Authorizations

x-api-key · string · header · required

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

Query Parameters

inputMint · string · required

The mint address of the input token

outputMint · string · required

The mint address of the output token

amount · string · required

The amount to swap in the smallest unit of the input token

taker · string

• The public key of the wallet that will sign the transaction
• If not provided, the response will contain a quote but no transaction
• Must be present if you intend to sign and execute the transaction via /execute

receiver · string

• The public key of the account that will receive the output tokens
• Must differ from taker
• Expects a wallet address, not a token account
• For non-SOL output: tokens are sent to the receiver's associated token account (ATA). If the ATA is not initialised, a create ATA instruction is added to the transaction
• For SOL output: native SOL is transferred directly to the receiver
• Does not support destination wSOL token accounts
• Disables RFQ routing (JupiterZ)

swapMode · enum<string>

• Swap mode. Currently only ExactIn is supported.

Available options: ExactIn

slippageBps · integer

• Slippage tolerance in basis points (0-10000)
• If not set, Jupiter automatically determines an appropriate slippage

Required range: 0 <= x <= 10000

referralAccount · string

• Address of your referral account for the Jupiter referral project
• Must be used together with referralFee
• Disables RFQ routing (JupiterZ)
• See the Referral Program for setup

referralFee · number

• Referral fee in basis points (50-255)
• Must be used together with referralAccount

Required range: 50 <= x <= 255

payer · string

• The public key of an account that will cover gas-related fees (signature fees, priority fees, and rent) on behalf of the taker
• Enabling this changes routing behaviour: Jupiter may route through a dedicated gasless flow if the taker lacks sufficient SOL for gas

priorityFeeLamports · number

• Priority fee in lamports
• If not set, Jupiter automatically determines an appropriate priority fee
• Setting this overrides the automatic optimisation

jitoTipLamports · number

• Jito MEV tip in lamports for faster block inclusion

broadcastFeeType · enum<string>

• Fee cap strategy: maxCap treats the fee as a maximum, exactFee uses the exact amount
• Ignored if neither priorityFeeLamports nor jitoTipLamports are set

Available options: maxCap, exactFee

excludeRouters · string

• Comma-separated list of routers to exclude
• Available routers: iris (Metis), jupiterz (JupiterZ), dflow, okx

excludeDexes · string

• Comma-separated list of DEXes to exclude from the Metis router
• Important: This only affects the Metis router, not other routers
• For example: excludeDexes=Raydium,Orca+V2,Meteora+DLMM

Response

200

application/json

Quote with optional assembled transaction

mode · string

"ultra" or "manual" based on parameters used

inputMint · string

outputMint · string

inAmount · string

outAmount · string

inUsdValue · number

outUsdValue · number

priceImpact · number

Price impact as a decimal (e.g. -0.001 = -0.1%)

swapUsdValue · number

otherAmountThreshold · string

Minimum output amount after slippage

swapMode · string

slippageBps · number

priceImpactPct · string · deprecated

Deprecated: use priceImpact instead

routePlan · object[]

Show child attributes

referralAccount · string

feeMint · string

feeBps · number

Total fees including platform fee and other fees

platformFee · object

Show child attributes

signatureFeeLamports · number

signatureFeePayer · string | null

prioritizationFeeLamports · number

Includes priority fees and tips (Jito, Nozomi)

prioritizationFeePayer · string | null

rentFeeLamports · number

Estimated rent fee

rentFeePayer · string | null

swapType · enum<string> · deprecated

Deprecated: use router instead

Available options: aggregator, rfq, aggregator+rfq, dflow, okx

router · enum<string>

Which router won the quote

Available options: iris, jupiterz, dflow, okx

transaction · string | null

• Base64-encoded transaction. Null if taker is not provided.
• Empty string if taker is provided but transaction could not be built (check errorCode).

lastValidBlockHeight · string

gasless · boolean

requestId · string

Unique request ID. Pass this to /execute.

totalTime · number

Response time in milliseconds

taker · string | null

quoteId · string

Quote ID for RFQ swaps

maker · string

Market maker address for RFQ swaps

expireAt · string

Quote expiration timestamp for RFQ swaps

errorCode · number

Present when taker is defined but transaction is empty string

errorMessage · string

Human-readable error description

error · string

Duplicate of errorMessage for backwards compatibility