jupiter-solana

n8n community node for Solana token swaps via Jupiter Swap API v2 (quote + execute). Built for dedicated hot-wallet trading MCP tools.

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: the_gardener

Available Nodes

Documentation generating…

Solana Jupiter icon
Solana Jupiter
Quote or execute Solana swaps via Jupiter Swap API v2 (dedicated hot wallet)

Documentation

n8n-nodes-jupiter-solana

Community node for Solana token swaps via Jupiter Swap API v2 (/order + /execute).

Install on self-hosted n8n, then call it as a tool from an MCP workflow (dropdown operations).

Install (self-hosted n8n)

  1. Settings → Community Nodes → Install
  2. Package name: n8n-nodes-jupiter-solana
  3. Restart n8n if needed
  4. Search for Solana Jupiter in the node panel

Or: npm install n8n-nodes-jupiter-solana in your n8n custom extensions path (depending on your n8n setup).

Credentials

Jupiter API

Solana Hot Wallet

  • Private Key (Base58) — dedicated trading hot wallet only
  • RPC URL (optional) — for balance helpers (default public mainnet)

Never reuse an old shared wallet. Never commit keys.

Operations (dropdown)

Operation Behavior
Quote GET /order with no taker: pricing only. Never reads the wallet credential, never signs or sends
Execute Swap /order (with taker) → sign locally → POST /execute — LIVE, moves funds
Get Wallet Address Public key of the configured wallet
Get SOL Balance Native SOL via RPC
Get Token Balance SPL balance for one mint (Token Program + Token-2022) via RPC. Read-only
Get All Token Balances Non-zero SPL token accounts in the hot wallet (Token + Token-2022). Read-only

Token balance fields

  • mintAddress (Get Token Balance) — mint address to query

Swap fields

  • inputMint / outputMint — token mint addresses
  • amount — smallest units of input (lamports for SOL)
  • slippageBps — optional integer 0–10000; leave empty for Jupiter RTSE / ultra defaults
  • maxAmount (Execute only) — optional hard cap in smallest units; recommended when used as an AI tool

Use as an MCP / AI tool

  1. Set N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true on the n8n instance (required for community nodes to be used as tools) and restart.
  2. Create a workflow with an MCP Server Trigger and connect Solana Jupiter to its tools input (one node per operation, e.g. a Quote tool and an Execute tool with maxAmount set).
  3. Point your MCP client at the trigger's production URL (add auth on the trigger).

Safety

  1. Amounts, mints and slippage are validated before any request; credentials and RPC URL are never returned in output; Execute refuses to sign a transaction that does not list the configured wallet as a required signer
  2. Smoke-test Quote first
  3. Confirm wallet address + tiny balances before any Execute
  4. Keep private keys in n8n Credentials only
  5. Separate from any legacy JupiterAPI wallet

Common mints (mainnet)

Asset Mint
SOL (wrapped) So11111111111111111111111111111111111111112
USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Develop

npm install
npm run build
npm run lint

License

MIT

Discussion