Solaris AISolaris AI FlowDocs
Node ReferenceDeFi

Jupiter

Token swaps, quotes, search, and portfolio via Jupiter.

View as Markdown

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

OperationDescriptionRequires API keyRequires wallet
getQuoteGet a swap quote between two tokensYesNo
getPriceGet current price of token(s)YesNo
searchTokensSearch tokens by name or symbolYesNo
getTopTokensList top/trending/organic score tokensYesNo
getRecentTokensList recently added tokensYesNo
getPortfolioGet wallet token balancesYesNo
swapExecute a token swapYesYes
transferSend SOL to an addressNoYes

Configuration

FieldTypeRequiredDescription
CredentialselectFor all operations except transferYour Jupiter API key credential
Response NametextYesName used by downstream nodes, such as {jupiterResponse.data}
inputMinttemplateFor getQuote and swapToken to sell, as a mint address
outputMinttemplateFor getQuote and swapToken to buy, as a mint address
amounttemplateFor getQuote and swapAmount in the input token's smallest unit
slippageBpsnumberNoOptional manual slippage in basis points, 0-10000
tokenQuerytemplateFor getPrice and searchTokensMint address list for price, or text query for search
addresstemplateFor getPortfolio and transferWallet address for portfolio, or recipient address for transfer
transferAmounttemplateFor transferAmount of SOL to send, such as 0.1
categoryselectFor getTopTokensTop Traded, Top Trending, or Top Organic Score
intervalselectFor getTopTokens5 minutes, 1 hour, 6 hours, or 24 hours

For getQuote and swap, amount must be in the input token's smallest unit:

  • 1000000000 for 1 SOL
  • 1000000 for 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 holdingsFee discount
5,000,000+50% off
1,000,000+25% off
Below 1,000,000No 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

On this page