Get Quote

Please use the Swap API at your own discretion.

The Jupiter UI at https://jup.ag/ contains multiple safeguards, warnings and default settings to guide our users to trade safer. Jupiter is not liable for losses incurred by users on other platforms.

If you need clarification or support, please reach out to us in Discord.

Routing Engine

The quotes from Swap API are from the Jupiter Metis v1 Routing Engine.

The Quote API enables you to tap into the Jupiter Metis v1 Routing Engine, which accesses the deep liquidity available within the DEXes of Solana's DeFi ecosystem. In this guide, we will walkthrough how you can get a quote for a specific token pair and other related parameters.

Let’s Get Started

In this guide, we will be using the Solana web3.js package.

If you have not set up your environment to use the necessary libraries and the connection to the Solana network, please head over to Environment Setup.

API Reference

To fully utilize the Quote API, check out the Quote API Reference.

Quote API

note

Base URL: https://lite-api.jup.ag/swap/v1/quote

For higher rate limits, refer to the API Key Setup doc.

The most common trading pair on Solana is SOL and USDC, to get a quote for this specific token pair, you need to pass in the required parameters such as:

Parameters	Description
inputMint	The pubkey or token mint address e.g. So11111111111111111111111111111111111111112
outputMint	The pubkey or token mint address e.g. EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
amount	The number of input tokens before the decimal is applied, also known as the “raw amount” or “integer amount” in lamports for SOL or atomic units for all other tokens.
slippageBps	The number of basis points you can tolerate to lose during time of execution. e.g. 1% = 100bps

Get Quote

Using the root URL and parameters to pass in, it is as simple as the example code below!

const quoteResponse = await (
    await fetch(
        'https://lite-api.jup.ag/swap/v1/quote?inputMint=So11111111111111111111111111111111111111112&outputMint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=100000000&slippageBps=50&restrictIntermediateTokens=true'
    )
  ).json();
  
console.log(JSON.stringify(quoteResponse, null, 2));

Example response:

{
  "inputMint": "So11111111111111111111111111111111111111112",
  "inAmount": "100000000",
  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "outAmount": "16198753",
  "otherAmountThreshold": "16117760",
  "swapMode": "ExactIn",
  "slippageBps": 50,
  "platformFee": null,
  "priceImpactPct": "0",
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "5BKxfWMbmYBAEWvyPZS9esPducUba9GqyMjtLCfbaqyF",
        "label": "Meteora DLMM",
        "inputMint": "So11111111111111111111111111111111111111112",
        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "inAmount": "100000000",
        "outAmount": "16198753",
        "feeAmount": "24825",
        "feeMint": "So11111111111111111111111111111111111111112"
      },
      "percent": 100
    }
  ],
  "contextSlot": 299283763,
  "timeTaken": 0.015257836
}

tip

outAmount refers to the best possible output amount based on the route at time of quote, this means that slippageBps does not affect.

What’s Next

Now, you are able to get a quote, next steps is to submit a transaction to execute the swap based on the quote given. Let’s go!

---

Additional Resources

Restrict Intermediate Tokens

restrictIntermediateTokens can be set to true . If your route is routed through random intermediate tokens, it will fail more frequently. With this, we make sure that your route is only routed through highly liquid intermediate tokens to give you the best price and more stable route.

Legacy Transactions

All Jupiter swaps are using Versioned Transactions and Address Lookup Tables. However, not all wallets support Versioned Transactions yet, so if you detect a wallet that does not support versioned transactions, you will need to set the asLegacyTransaction parameter to true.

Adding Fees

By using the Quote API in your app, you can add a fee to charge your users. You can refer to the platformFeeBps parameter and to add it to your quote and in conjuction, add feeAccount (it can be any valid token account) to your swap request.

Direct Routes

In some cases, you may want to restrict the routing to only go through 1 market. You can use the onlyDirectRoutes parameter to achieve this. This will ensure routing will only go through 1 market.

note

• If there are no direct routes, there will be no quote.
• If there is only 1 market but it is illiquid, it will still return the route with the illiquid market.

unfavorable trades

Please be aware that using onlyDirectRoutes can often yield unfavorable trades or outcomes.

Max Accounts

In some cases, you may want to add more accounts to the transaction for specific use cases, but it might exceed the transaction size limit. You can use the maxAccounts parameter to limit the number of accounts in the transaction.

note

• We recommend setting maxAccounts to 64
• Keep maxAccounts as large as possible
• maxAccounts is only an estimation and the actual number of accounts may vary
• Example: If maxAccounts is set to 46, the computed routes may drop DEXes/AMMs like Meteora DLMM that require more than 46 accounts.

List of DEXes and their required accounts

Notes:

• Values in the table are only estimations and the actual number of accounts may vary.
• Min accounts occur when we already create the necessary ALTs for a specific pool resulting in less accounts needed in routing.
  • Only applies to simple routing pools which are pools that are instantly routed (most AMMs) and they only subject to our market crawler to check for liquidity on the 14th day.
• Sanctum and Sanctum Infinity are unique, and their accounts are dynamic.

DEX	Max	Min
Meteora DLMM	47	19
Meteora	45	18
Moonshot	37	15
Obric	30	12
Orca Whirlpool	30	12
Pumpfun AMM	42	17
Pumpfun Bonding Curve	40	16
Raydium	45	18
Raydium CLMM	45	19
Raydium CPMM	37	14
Sanctum	80	80
Sanctum Infinity	80	80
Solfi	22	9

unfavorable trades

Please be aware that the misuse of maxAccounts can yield unfavorable trades or outcomes.