Skip to main content

​
Order Response

  • Success
  • Failed
{
    "mode": "ultra",
    "inAmount": "100000000",
    "outAmount": "461208958",
    "otherAmountThreshold": "460024271",
    "swapMode": "ExactIn",
    "slippageBps": 26,
    "priceImpactPct": "-0.0001311599520149334",
    "routePlan": [
        {
        "swapInfo": {
            "ammKey": "HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR",
            "label": "MeteoraDLMM",
            "inputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
            "outputMint": "So11111111111111111111111111111111111111112",
            "inAmount": "52000000",
            "outAmount": "239879552",
            "feeAmount": "0",
            "feeMint": "11111111111111111111111111111111"
        },
        "percent": 52,
        "bps": 5200
        }
    ],
    "feeMint": "So11111111111111111111111111111111111111112",
    "feeBps": 2,
    "taker": "taker-address",
    "gasless": false,
    "signatureFeeLamports": 5000,
    "transaction": "AQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAAQAEB+r/6dWfRh5QZq1pS2FU/a5CQmMX/HcgLK4+zaeSlI5cZdTk+KNaH68Jj2ISScdmgdJ/88PKxKtXPavfMK2A5TFvQBO6cleTQsKnQWYpDA5PurAceVrkoCVPKJSGBw6LARo6wTdxxXRAzu6pCAqBH8SnExvClVC1O8bT5gyQxm5oAwZGb+UhFzL/7K26csOb57yM5bvF9xJrLEObOkAAAAAEedVb8jHAbu50xW7OaBUH/bGy3qP0jlECsc2iVrwTjwbd9uHXZaGT2cvhRs7reawctIXtX1s3kTqM9YV+/wCpeE6XgwQiPQTdYGYpJIn7N9ynBymyDkUCCC1aA3Klx+cFBAAFAjh+AQAEAAkD75JsAAAAAAAFBQEAFAYQCZPxe2T0hK52/wUhAAIBEhQGBgURBQcWCggLCQwCAQAGFRcADQECDw4DFQYTLrtk+swxxK8UAOH1BQAAAAAbtn0bAAAAABoAAgAAAAIAAABDUBQAAlYB/8ASAAIGAwEAAAEJAym/lQcqT78E33F1k+c4vMwhJygVwkcagNn59VWw1IQlASAFEwAoAhdSojJcrqzlDmuUV2ZVdk3ihN14mZpQMxrnUJS463C7xAUxLhQVMAItL7MrMZDyYzurr+hCn5YjvrvmsR9/EdfdhYUISn5ODzRsA8vPzAHO",
    "prioritizationFeeLamports": 696237,
    "rentFeeLamports": 0,
    "inputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "outputMint": "So11111111111111111111111111111111111111112",
    "swapType": "aggregator",
    "router": "metis",
    "requestId": "019974a8-5fbb-7395-9355-9ebf8f844884",
    "inUsdValue": 99.96761068334662,
    "outUsdValue": 99.95449893632635,
    "priceImpact": -0.013115995201493341,
    "swapUsdValue": 99.96761068334662,
    "totalTime": 359
}

​
Execute Response

  • Success
  • Failed
Use the signature field to view the transaction in an explorer.
{
    "status": "Success",
    "signature": "transaction-signature",
    "slot": "323598314",
    "code": 0,
    "inputAmountResult": "9995000",
    "outputAmountResult": "1274698",
    "swapEvents": [
        {
        "inputMint": "So11111111111111111111111111111111111111112",
        "inputAmount": "9995000",
        "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "outputAmount": "1274698"
        }
    ]
}

​
Ultra Endpoint Codes

CodeDescriptionDebugging
0Success-
-1Missing cached orderrequestId not found in cache, likely expired or not found
-2Invalid signed transactionsignedTransaction is invalid, likely failed to sign the transaction correctly
-3Invalid message bytessignedTransaction is invalid, likely due to incorrect usage like modification of transaction field in the order response
-4Missing request idrequestId is not found in the request to /execute
-5Missing signed transactionsignedTransaction is not found in the request to /execute

​
Aggregator Swap Type Codes

CodeDescriptionDebugging
-1000Failed to landTransaction failed to land on the network
-1001Unknown errorPlease try again, if it persists please reach out in Discord
-1002Invalid transactionPlease try again, if it persists please reach out in Discord
-1003Transaction not fully signedFailed to sign the transaction correctly
-1004Invalid block heightThe block height is invalid
-1005ExpiredThe submitted transaction has been attempted but has expired
-1006Timed outThe submitted transaction has been attempted but has timed out
-1007Gasless unsupported walletThe wallet is not supported for gasless

​
RFQ Swap Type Codes

CodeDescriptionDebugging
-2000Failed to landPlease try again, if it persists please reach out in Discord
-2001Unknown errorPlease try again, if it persists please reach out in Discord
-2002Invalid payloadPlease try again, if it persists please reach out in Discord
-2003Quote expiredUser did not respond in time or RFQ provider did not execute in time
-2004Swap rejectedUser or RFQ provider rejected the swap
-2005Internal errorPlease try again, if it persists please reach out in Discord
For Jupiter V6 Aggregator Program Codes, the error message will be parsed with description.

IDL

For the full and most up to date list of Jupiter V6 Aggregator Program Codes, you can refer to the IDL on an explorer.
If you need help identifying the other DEX program codes, please reach out in Discord.

​
Best Practices

It is important to understand the error codes to provide a better experience for your users, helping them make an informed decision or follow up step to help their transaction succeed.
See https://jup.ag/ as a reference to understand how we handle errors on the UI.
Example ErrorBest Practice
Slippage exceeding thresholdShow the user the current slippage tolerance and the incurred slippage
Insufficient fundsDisable swap widget but still provide quote visibility
Non Jupiter Program ErrorsAllow the user to retry with a new route by requoting and/or exclude the specific DEX from the quote request
⌘I