Swap Instructions RPC Method

The jup_SwapInstructions RPC method generates a serialized set of instructions required to execute a token swap on the blockchain. This method supports advanced features such as dynamic slippage, compute unit prioritization, and shared accounts, offering developers precise control over token swap processes.

Endpoint: `https://solana-mainnet.backpac.xyz/{YOUR_API_KEY}`

Method: `POST`

Request Parameters

The request parameters are included in the params property of the RPC request body. Below is the interface definition and detailed description of each parameter.

Request Interface: `IGetSwapInstructionsRequest`

The request body includes the following properties:

Parameter	Type	Required	Default	Description
`params`	`any`	Yes		Additional parameters required for generating swap instructions.
`userPublicKey`	`string`	Yes		Public key of the user initiating the swap.
`wrapAndUnwrapSol`	`boolean`	No	`false`	Specifies if SOL should be wrapped/unwrapped during the swap.
`useSharedAccounts`	`boolean`	No	`false`	Enables the use of shared accounts for improved performance.
`feeAccount`	`string`	No		Fee payer account.
`trackingAccount`	`string`	No		Optional tracking account for analytics or reporting.
`computeUnitPriceMicroLamports`	`number`	No		Price per compute unit in micro-lamports.
`prioritizationFeeLamports`	`string \| number`	No		Fee for prioritizing the transaction in the network.
`asLegacyTransaction`	`boolean`	No	`false`	Enables legacy transaction format instead of the default versioned transaction.
`useTokenLedger`	`boolean`	No		Enables use of a token ledger for improved transparency and reconciliation.
`destinationTokenAccount`	`string`	No		The token account where the output tokens will be deposited.
`dynamicComputeUnitLimit`	`boolean`	No	`false`	Enables dynamic compute unit limits to optimize costs.
`skipUserAccountsRpcCalls`	`boolean`	No	`false`	Skips RPC calls related to user account validation.
`dynamicSlippage`	`object`	No		Dynamic slippage configuration.
├─ `minBps`	`number`	Yes (if provided)		Minimum slippage in BPS.
├─ `maxBps`	`number`	Yes (if provided)		Maximum slippage in BPS.
`quoteResponse`	`object`	Yes		Quote response object that contains the details of the swap.
├─ `inputMint`	`string`	Yes		Mint address of the input token.
├─ `inAmount`	`string`	Yes		Amount of the input token.
├─ `outputMint`	`string`	Yes		Mint address of the output token.
├─ `outAmount`	`string`	Yes		Amount of the output token.
├─ `otherAmountThreshold`	`string`	Yes		Threshold for the amount beyond which the swap is invalid.
├─ `swapMode`	`string`	Yes	`"ExactIn"`	Swap mode specifying input or output constraints.
├─ `slippageBps`	`number`	Yes		Slippage percentage in basis points (BPS).
├─ `platformFee`	`object`	No		Optional platform fee details.
│ ├─ `amount`	`string`	No		Platform fee amount.
│ ├─ `feeBps`	`number`	No		Platform fee in BPS.
├─ `priceImpactPct`	`string`	Yes		Percentage price impact of the swap.
├─ `routePlan`	`array`	Yes		Array of swap route details.
│ ├─ `swapInfo`	`object`	Yes		Details of each swap in the route.
│ │ ├─ `ammKey`	`string`	Yes		Address of the Automated Market Maker (AMM).
│ │ ├─ `label`	`string`	No		Label of the AMM.
│ │ ├─ `inputMint`	`string`	Yes		Mint address of the input token.
│ │ ├─ `outputMint`	`string`	Yes		Mint address of the output token.
│ │ ├─ `inAmount`	`string`	Yes		Input token amount for the swap.
│ │ ├─ `outAmount`	`string`	Yes		Output token amount for the swap.
│ │ ├─ `feeAmount`	`string`	Yes		Fee amount for the swap.
│ │ ├─ `feeMint`	`string`	Yes		Mint address of the token used for the fee.

Example Request

json

{
    "method": "jup_SwapInstructions",
    "jsonrpc": "2.0",
    "id": 1,
    "params": {
        "params": {
            "additionalParam": "value"
        },
        "userPublicKey": "user-public-key",
        "wrapAndUnwrapSol": true,
        "useSharedAccounts": false,
        "quoteResponse": {
            "inputMint": "input-mint-address",
            "inAmount": "1000",
            "outputMint": "output-mint-address",
            "outAmount": "950",
            "otherAmountThreshold": "900",
            "swapMode": "ExactIn",
            "slippageBps": 100,
            "priceImpactPct": "0.1"
        }
    }
}

Swap Instructions Response

The response contains details about the swap instructions, including the token ledger instructions, other instructions, compute budget instructions, setup instructions, swap instructions, and cleanup instructions. The response also includes an array of address lookup table addresses.

Response Interface: `IGetSwapQuoteResponse`

Parameter	Type	Required	Description
`tokenLedgerInstruction`	`object` (optional)	No	Instruction for token ledger, containing program ID, accounts, and data.
├─ `programId`	`string`	Yes	The program ID for the token ledger.
├─ `accounts`	`array`	Yes	List of account objects, each containing `pubkey`, `isSigner`, and `isWritable`.
├─ `data`	`string`	Yes	Data related to the token ledger instruction.
`otherInstructions`	`array`	No	Array of other instructions with program IDs, accounts, and data.
`computeBudgetInstructions`	`array`	No	Array of compute budget instructions with program IDs, accounts, and data.
`setupInstructions`	`array`	No	Array of setup instructions with program IDs, accounts, and data.
`swapInstruction`	`object`	Yes	The swap instruction, including program ID, accounts, and data.
├─ `programId`	`string`	Yes	The program ID for the swap instruction.
├─ `accounts`	`array`	Yes	List of account objects with `pubkey`, `isSigner`, and `isWritable`.
├─ `data`	`string`	Yes	Data related to the swap instruction.
`cleanupInstruction`	`object` (optional)	No	Cleanup instruction, if applicable, containing program ID, accounts, and data.
`addressLookupTableAddresses`	`array`	Yes	Array of address lookup table addresses.

Example Response

json

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "tokenLedgerInstruction": {
            "programId": "token-ledger-program-id",
            "accounts": [
                {
                    "pubkey": "account-1-public-key",
                    "isSigner": true,
                    "isWritable": true
                },
                {
                    "pubkey": "account-2-public-key",
                    "isSigner": false,
                    "isWritable": true
                }
            ],
            "data": "token-ledger-instruction-data"
        },
        "otherInstructions": [
            {
                "programId": "other-program-id",
                "accounts": [
                    {
                        "pubkey": "account-3-public-key",
                        "isSigner": true,
                        "isWritable": true
                    }
                ],
                "data": "other-instruction-data"
            }
        ],
        "computeBudgetInstructions": [
            {
                "programId": "compute-budget-program-id",
                "accounts": [
                    {
                        "pubkey": "account-4-public-key",
                        "isSigner": false,
                        "isWritable": true
                    }
                ],
                "data": "compute-budget-instruction-data"
            }
        ],
        "setupInstructions": [
            {
                "programId": "setup-program-id",
                "accounts": [
                    {
                        "pubkey": "account-5-public-key",
                        "isSigner": true,
                        "isWritable": false
                    }
                ],
                "data": "setup-instruction-data"
            }
        ],
        "swapInstruction": {
            "programId": "swap-program-id",
            "accounts": [
                {
                    "pubkey": "account-6-public-key",
                    "isSigner": true,
                    "isWritable": true
                }
            ],
            "data": "swap-instruction-data"
        },
        "cleanupInstruction": {
            "programId": "cleanup-program-id",
            "accounts": [
                {
                    "pubkey": "account-7-public-key",
                    "isSigner": false,
                    "isWritable": true
                }
            ],
            "data": "cleanup-instruction-data"
        },
        "addressLookupTableAddresses": [
            "address-lookup-table-1",
            "address-lookup-table-2"
        ]
    }
}

Swap Instructions RPC Method ​

Endpoint: https://solana-mainnet.backpac.xyz/{YOUR_API_KEY} ​

Method: POST ​

Request Parameters ​

Request Interface: IGetSwapInstructionsRequest ​

Example Request ​

Swap Instructions Response ​

Response Interface: IGetSwapQuoteResponse ​

Example Response ​