Jupiter — Swap API V2 — Get a swap quote

Retrieve a swap quote with the Jupiter API. Supply an input mint and an output mint. Sample fields include labels. Use it in a transaction-routing workflow. The GET request schema also lists inputMint, outputMint, amount. Use the response in a DeFi workflow for the selected protocol, and compare the request and response with the provider example.

Selected price
$0 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
The mint address of the input token
The mint address of the output token
The amount to swap in the smallest unit of the input token
Optional parameters (13)
- 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`
- 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 Dflow and OKX routing. Metis and JupiterZ RFQ still compete
- Swap mode. Currently only `ExactIn` is supported.
- Slippage tolerance in basis points (0-10000) - If not set, Jupiter automatically determines an appropriate slippage
- Address of your referral account for the Jupiter referral project - Must be used together with `referralFee` - See the [Referral Program](/tool-kits/referral-program) for setup
- Referral fee in basis points (50-255) - Must be used together with `referralAccount`
- The public key of an account that will cover gas-related fees (signature fees, priority fees, and rent) on behalf of the taker - Has no effect when set equal to `taker`. Must be a different wallet to activate integrator-sponsored gas - Disables Dflow and OKX routing. Metis and JupiterZ RFQ still compete - On JupiterZ routes the market maker pays signature and priority fees, and `payer` only pays rent for the output token accounts the transaction creates. When the output is native SOL there are none, so `payer` is not a signer - Sign with `payer` only if it is a required signer of the returned transaction
- Priority fee in lamports - If not set, Jupiter automatically determines an appropriate priority fee - Setting this overrides the automatic optimisation
- Jito MEV tip in lamports for faster block inclusion
- Fee cap strategy: `maxCap` treats the fee as a maximum, `exactFee` uses the exact amount - Ignored if neither `priorityFeeLamports` nor `jitoTipLamports` are set
- Comma-separated list of routers to exclude - Available routers: `metis`, `jupiterz`, `dflow`, `okx`
- 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` - Labels are case sensitive (`SolFi`, not `solfi`). Full list of DEXes here using the `/program-id-to-label` endpoint. - On `/order` only `excludeDexes` is honoured, not `dexes`. Use `/build` to restrict routing to specific DEXes.
- The highest Solana transaction version your client can accept, `"0"` or `"1"`. Defaults to `"0"`. - This is a ceiling, not a force. You get v1 only when Metis wins the route and the order is not gasless; other routers and gasless orders (including automatic sponsorship for low-SOL takers) return v0. Wider v1 support is in progress. - Read the response `transactionVersion` to see the version you got. v1 transactions must be deserialized and signed with a v1-capable SDK (`@solana/kit` v8 or later).

Sample response

{
  "feeBps": 2,
  "feeMint": "So11111111111111111111111111111111111111112",
  "gasless": false,
  "guaranteedPrice": false,
  "inAmount": "10000000",
  "inUsdValue": 0.9787736369730227,
  "inputMint": "So11111111111111111111111111111111111111112",
  "jitOptimized": false,
  "mode": "ultra",
  "otherAmountThreshold": "979505",
  "outAmount": "979505",
  "outUsdValue": 0.978802141647989,
  "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "platformFee": {
    "feeBps": 2,
    "feeMint": "So11111111111111111111111111111111111111112"
  },
  "priceImpact": 0.002912284709102304,
  "priceImpactPct": "0.000029122847091023042",
  "prioritizationFeeLamports": 0,
  "prioritizationFeePayer": null,
  "rentFeeLamports": 0,
  "rentFeePayer": null,
  "requestId": "01a18b73-ff83-77ca-ad88-be39d1b45085",
  "routePlan": [
    {
      "bps": 10000,
      "percent": 100,
      "swapInfo": {
        "ammKey": "7DyH4hFA9KY2Uf3ZC2fUGP9ATsLqAEq3pUpyJPA2Mjft",
        "inAmount": "10000000",
        "inputMint": "So11111111111111111111111111111111111111112",
        "label": "ZeroFi",
        "outAmount": "979700",
        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
      },
      "usdValue": 0.978802141647989
    }
  ],
  "router": "metis",
  "signatureFeeLamports": 0,
  "signatureFeePayer": null,
  "slippageBps": 0,
  "swapMode": "ExactIn",
  "swapType": "aggregator",
  "swapUsdValue": 0.978802141647989,
  "taker": null,
  "totalTime": 208,
  "transaction": null
}

Response result

Response structure

Inferred from examples
  • feeBpsinteger
  • feeMintstring
  • gaslessboolean
  • guaranteedPriceboolean
  • inAmountstring
  • inUsdValuenumber
  • inputMintstring
  • jitOptimizedboolean
  • modestring
  • otherAmountThresholdstring
  • outAmountstring
  • outUsdValuenumber
  • outputMintstring
  • platformFeeobject
    • feeBpsinteger
    • feeMintstring
  • priceImpactnumber
  • priceImpactPctstring
  • prioritizationFeeLamportsinteger
  • prioritizationFeePayernull
  • rentFeeLamportsinteger
  • rentFeePayernull
  • requestIdstring
  • routePlanobject[]
    • bpsinteger
    • percentinteger
    • swapInfoobject
      • ammKeystring
      • inAmountstring
      • inputMintstring
      • labelstring
      • outAmountstring
      • outputMintstring
    • usdValuenumber
  • routerstring
  • signatureFeeLamportsinteger
  • signatureFeePayernull
  • slippageBpsinteger
  • swapModestring
  • swapTypestring
  • swapUsdValuenumber
  • takernull
  • totalTimeinteger
  • transactionnull

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Jupiter — Swap API V2 — Get a swap quote with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.