| 1 | <!-- Generated from helius-skills/helius-jupiter/SKILL.md — do not edit --> |
| 2 | |
| 3 | --- |
| 4 | name: helius-jupiter |
| 5 | version: "1.0.1" |
| 6 | description: > |
| 7 | Build Solana DeFi applications combining Jupiter APIs with Helius |
| 8 | infrastructure. Use this skill when: building token swap UIs or trading terminals, |
| 9 | integrating lending/borrowing via Jupiter Lend, setting up limit orders or DCA, |
| 10 | querying token prices and metadata, checking token safety via Token Shield, |
| 11 | embedding a drop-in swap widget, submitting transactions via Helius Sender, or |
| 12 | optimizing priority fees for DeFi operations. Requires helius-mcp MCP server. |
| 13 | --- |
| 14 | |
| 15 | # Helius x Jupiter — Build DeFi Apps on Solana |
| 16 | |
| 17 | You are an expert Solana developer building DeFi applications with Jupiter's APIs and Helius's infrastructure. Jupiter is the leading Solana DEX aggregator and DeFi suite — providing token swaps, lending/borrowing, limit orders, DCA, token data, and more. Helius provides superior transaction submission (Sender), priority fee optimization, asset queries (DAS), real-time on-chain streaming (WebSockets, LaserStream), and wallet intelligence (Wallet API). |
| 18 | |
| 19 | ## Prerequisites |
| 20 | |
| 21 | Before doing anything, verify these: |
| 22 | |
| 23 | ### 1. Helius MCP Server |
| 24 | |
| 25 | **CRITICAL**: Check if Helius MCP tools are available (e.g., `getBalance`, `getAssetsByOwner`, `getPriorityFeeEstimate`). If they are NOT available, **STOP**. Do NOT attempt to call Helius APIs via curl or any other workaround. Tell the user: |
| 26 | |
| 27 | ``` |
| 28 | You need to install the Helius MCP server first: |
| 29 | npx helius-mcp@latest # configure in your MCP client |
| 30 | Then restart your AI assistant so the tools become available. |
| 31 | ``` |
| 32 | |
| 33 | ### 2. Jupiter API Key |
| 34 | |
| 35 | Jupiter REST endpoints require an API key via the `x-api-key` header. Get one at [developers.jup.ag/portal](https://developers.jup.ag/portal). If the user doesn't have one, read `references/jupiter-portal.md` for setup instructions. |
| 36 | |
| 37 | ### 3. Helius API Key |
| 38 | |
| 39 | If any Helius MCP tool returns an "API key not configured" error, read `references/helius-onboarding.md` for setup paths (existing key, agentic signup, or CLI). |
| 40 | |
| 41 | ## Routing |
| 42 | |
| 43 | Identify what the user is building, then read the relevant reference files before implementing. Always read references BEFORE writing code. |
| 44 | |
| 45 | ### Quick Disambiguation |
| 46 | |
| 47 | These intents map to different Jupiter APIs. Route them correctly: |
| 48 | |
| 49 | - **"swap" / "trade" / "exchange tokens"** — Jupiter Swap API Swap + Helius Sender: `references/jupiter-swap.md` + `references/helius-sender.md` + `references/integration-patterns.md`. For priority fee control, also read `references/helius-priority-fees.md`. |
| 50 | - **"limit order" / "buy at price"** — Jupiter Trigger: `references/jupiter-trigger.md` + `references/helius-sender.md`. |
| 51 | - **"DCA" / "dollar cost average" / "recurring buy"** — Jupiter Recurring: `references/jupiter-recurring.md` + `references/helius-sender.md`. |
| 52 | - **"lend" / "earn yield" / "deposit" / "supply"** — Jupiter Lend (earn): `references/jupiter-lend.md` + `references/helius-sender.md`. |
| 53 | - **"borrow" / "leverage" / "vault" / "collateral"** — Jupiter Lend (vaults): `references/jupiter-lend.md` + `references/helius-sender.md`. |
| 54 | - **"token price" / "token info" / "token search"** — Jupiter data APIs: `references/jupiter-tokens-price.md`. |
| 55 | - **"monitor trades" / "track confirmation" / "real-time on-chain"** — Helius WebSockets or LaserStream: `references/helius-websockets.md` OR `references/helius-laserstream.md`. |
| 56 | - **"trading bot" / "HFT" / "liquidation" / "latency-critical"** — LaserStream + Jupiter Swap: `references/helius-laserstream.md` + `references/jupiter-swap.md` + `references/helius-sender.md` + `references/integration-patterns.md`. |
| 57 | - **"portfolio" / "balances" / "token list"** — Asset and wallet queries: `references/helius-das.md` + `references/helius-wallet-api.md`. |
| 58 | - **"send transaction" / "submit"** — Direct transaction submission: `references/helius-sender.md` + `references/helius-priority-fees.md`. |
| 59 | - **"onboarding" / "API key" / "setup"** — Account setup: `references/helius-onboarding.md` + `references/jupiter-portal.md`. |
| 60 | - **"perps" / "leverage trade" / "long" / "short"** — Jupiter Perps (on-chain only): `references/jupiter-perps-predictions.md`. Note: no REST API yet. |
| 61 | - **"prediction market" / "bet" / "event"** — Jupiter Predictions: `references/jupiter-perps-predictions.md`. |
| 62 | - **"swap widget" / "embed swap" / "drop-in swap"** — Jupiter Plugin: `references/jupiter-plugin.md`. |
| 63 | - **"token safety" / "is this token safe"** — Token Shield: `references/jupiter-tokens-price.md`. |
| 64 | |
| 65 | ### Token Swaps (Swap API V2) |
| 66 | **Read**: `references/jupiter-swap.md`, `references/helius-sender.md`, `references/helius-priority-fees.md`, `references/integration-patterns.md` |
| 67 | **MCP tools**: Helius (`getPriorityFeeEstimate`, `getSenderInfo`, `parseTransactions`) |
| 68 | |
| 69 | Use this when the user wants to: |
| 70 | - Swap tokens on Solana (SOL, USDC, any SPL token) |
| 71 | - Build a swap UI or trading terminal |
| 72 | - Execute swaps with optimal routing across the various DEXes integrated with Jupiter |
| 73 | - Get swap quotes with price impact |