Jupiter
Token swaps, quotes, search, and portfolio via Jupiter.
Jupiter is Solana's leading DEX aggregator. The Jupiter node supports quotes, swaps, token search, and SOL transfers.
Prerequisites
- Jupiter API key required for all operations except transfer. Add one in Connections.
- Connected Privy wallet required for swap and transfer operations.
Operations
| Operation | Description | Requires API key | Requires wallet |
|---|---|---|---|
| getQuote | Get a swap quote between two tokens | Yes | No |
| getPrice | Get current price of token(s) | Yes | No |
| searchTokens | Search tokens by name or symbol | Yes | No |
| getTopTokens | List top/trending/organic score tokens | Yes | No |
| getRecentTokens | List recently added tokens | Yes | No |
| getPortfolio | Get wallet token balances | Yes | No |
| swap | Execute a token swap | Yes | Yes |
| transfer | Send SOL to an address | No | Yes |
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Credential | select | For all operations except transfer | Your Jupiter API key credential |
| Response Name | text | Yes | Name used by downstream nodes, such as {jupiterResponse.data} |
| inputMint | template | For getQuote and swap | Token to sell, as a mint address |
| outputMint | template | For getQuote and swap | Token to buy, as a mint address |
| amount | template | For getQuote and swap | Amount in the input token's smallest unit |
| slippageBps | number | No | Optional manual slippage in basis points, 0-10000 |
| tokenQuery | template | For getPrice and searchTokens | Mint address list for price, or text query for search |
| address | template | For getPortfolio and transfer | Wallet address for portfolio, or recipient address for transfer |
| transferAmount | template | For transfer | Amount of SOL to send, such as 0.1 |
| category | select | For getTopTokens | Top Traded, Top Trending, or Top Organic Score |
| interval | select | For getTopTokens | 5 minutes, 1 hour, 6 hours, or 24 hours |
For getQuote and swap, amount must be in the input token's smallest unit:
1000000000for 1 SOL1000000for 1 USDC
You can use variables in amount and transferAmount, such as {trigger.amountLamports} or {conditionResponse.value}.
Leave Slippage empty to let Jupiter choose its routing defaults. Entering a slippage value switches to manual slippage mode.
Transfer
The transfer operation sends SOL from your connected Privy wallet. It does not require a Jupiter API key, but it does require:
- Recipient Address
- Amount (SOL)
- Enough SOL for the transfer and network fee
Use this for simple SOL payouts. Token transfers are not supported by the Jupiter transfer operation.
Swap fees
Swaps may include a platform fee deducted from the input amount before the swap executes.
- Base fee is 0.4% before SOLARIS holder discounts
- Fee is collected for SOL and supported SPL tokens (USDC, USDT, mSOL, jitoSOL, bSOL)
- Token-2022 mints with extensions (transfer hooks, transfer fees) are not fee-eligible
- Fee is non-refundable once collected, even if the swap itself fails after fee collection
SOLARIS token holder discounts
Holding SOLARIS tokens in your executing Privy wallet reduces swap fees:
| SOLARIS holdings | Fee discount |
|---|---|
| 5,000,000+ | 50% off |
| 1,000,000+ | 25% off |
| Below 1,000,000 | No discount |
Tokens must be in your Privy embedded wallet (the same wallet executing the swap). Tokens in external wallets are not counted.
Output (getQuote)
{
"success": true,
"operation": "getQuote",
"data": {
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmount": "1000000000",
"outAmount": "150230000",
"priceImpactPct": "0.01"
}
}Next steps
- Raydium - alternative DEX
- Credentials - adding your Jupiter API key
