Node reference
Swap with Jupiter
Sign and execute the best Jupiter route
Swap with Jupiter obtains a fresh mainnet order, signs it, and asks Jupiter to execute it. Review the verification mode as part of setting up the swap.
Try it step by step#
- Choose the wallet, input/output mints, and exact input Amount.
- Review slippage and Transaction Verification. Strict requires Fixed slippage and an explicit Maximum Extra SOL budget.
- Execute only after checking the route assumptions, then inspect transactionSignature and the reported total input and output amounts.
What to expect#
The result includes the executed transaction signature, router, fee fields, and total amount fields. The earlier quote remains an estimate rather than a locked order.
Things to check#
- Trust Jupiter accepts its trade instructions. Strict supports only recognized Metis token routes and can reject otherwise valid swaps.
- Strict does not support SOL routes, account setup, platform fees, or arbitrary routers. Increasing a fee budget does not enable these cases.
- An optional receiver must differ from the signing wallet. Leaving it empty uses the normal signer destination.
Keep learning#
Network setup: This node uses solana. See connections for RPC setup and Test mode for network selection.
Parameters#
| Setting | Default | What it does |
|---|---|---|
| Wallet | {{global.main_wallet}} | Wallet that owns the assets or position and signs this operation. |
| Input Mint | — | Mint of the token supplied to the swap route. |
| Output Mint | — | Mint of the token received from the swap route. |
| Amount | — | Decimal amount in input-token units, before conversion to the smallest units. |
| Input Decimals | — | Decimal scale for the input token when supplied explicitly. |
| Output Decimals | — | Decimal scale for the output token when supplied explicitly. |
| Look Up Missing Decimals | true | Read missing decimal scales from the token mints instead of entering them manually. |
| Slippage | automatic | Automatic uses Jupiter RTSE. Fixed sends your selected limit. |
| Slippage (%) | 0.5 | Maximum tolerated execution change in percent; 0.5 means half a percent. |
| Jupiter API key | (empty) | Uses your encrypted HTTP credential. Leave empty for Jupiter keyless access. |
| Maximum Priority Fee (SOL) | (empty) | Requests a maximum priority fee from Jupiter. Leave empty for automatic pricing. Base fees and account rent are additional. |
| Transaction Verification | trustJupiter | Trust Jupiter accepts its trade instructions. Strict checks recognized Metis token routes and may reject valid swaps; requires Fixed slippage. SOL, account setup, platform fees and other routes are unsupported. |
| Maximum Extra SOL | (empty) | Required in Strict mode. Maximum total SOL for base and priority fees. No budget is assumed. Routes needing rent, tips or other SOL transfers are rejected. |
| Receiver Wallet | — | Optional wallet that receives the output. It must differ from the signer. |
| Signing Layer | auto | Signing provider to use. Auto selects an available provider for this run. |
| On failure | stop | Choose whether a failed execution stops the workflow or only ends this path. |
| Retry attempts | 0 | How many additional attempts to make after the first failure. |
Input Decimals: Available under More options. Limits: minimum 0; maximum 18.
Output Decimals: Available under More options. Limits: minimum 0; maximum 18.
Look Up Missing Decimals: Available under More options.
Slippage: Choices: Automatic (automatic), Fixed (fixed).
Slippage (%): Shown when slippageMode is fixed.
Jupiter API key: Select your own http connection. See connection setup. Available under More options.
Maximum Priority Fee (SOL): Available under More options.
Transaction Verification: Choices: Trust Jupiter (trustJupiter), Strict (strict).
Maximum Extra SOL: Shown when verificationMode is strict.
Receiver Wallet: Available under More options.
Signing Layer: Choices: Auto (auto), Application (executable), Extension (extension), Web Vault (web). Available under More options.
On failure: Choices: Stop workflow (stop), Continue (continue). Available under More options.
Retry attempts: Available under More options. Limits: minimum 0.
Inputs#
| Port | Value | Description |
|---|---|---|
in | any | Payload to preserve with the Jupiter swap result. |
Outputs#
| Port | Value | Description |
|---|---|---|
out | object | A freshly quoted, signed, and executed Jupiter Meta-Aggregator swap. |
out fields#
| Field | Type |
|---|---|
inputMint | string |
outputMint | string |
inputAmountRaw | string |
outputAmountRaw | string |
router | string |
feeMint | string |
feeBps | number |
referralFeeApplied | boolean |
transactionSignature | string |
totalInputAmountRaw | string |
totalOutputAmountRaw | string |