helius-jupiter

Files (19)

• LICENSE
• SKILL.md
• install.sh
• helius-das.md · references/
• helius-laserstream.md · references/
• helius-onboarding.md · references/
• helius-priority-fees.md · references/
• helius-sender.md · references/
• helius-wallet-api.md · references/
• helius-websockets.md · references/
• integration-patterns.md · references/
• jupiter-lend.md · references/
• jupiter-perps-predictions.md · references/
• jupiter-plugin.md · references/
• jupiter-portal.md · references/
• jupiter-recurring.md · references/
• jupiter-swap.md · references/
• jupiter-tokens-price.md · references/
• jupiter-trigger.md · references/

SKILL.md (first lines)

# Helius x Jupiter — Build DeFi Apps on Solana

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).

## MCP Router Surface

Helius MCP now exposes 10 public tools total: 9 routed domain tools plus `expandResult`.
`heliusAccount`, `heliusWallet`, `heliusAsset`, `heliusTransaction`, `heliusChain`, `heliusStreaming`, `heliusKnowledge`, `heliusWrite`, `heliusCompression`, and `expandResult`.

This skill still names Helius action names such as `getPriorityFeeEstimate`, `getAssetsByOwner`, or `parseTransactions`. Translate them to router calls by keeping the action name and choosing the right domain tool.

Examples:
- `heliusChain({ action: "getPriorityFeeEstimate", accountKeys: ["..."] })`
- `heliusAsset({ action: "getAssetsByOwner", ownerAddress: "..." })`
- `heliusTransaction({ action: "parseTransactions", transactions: ["..."] })`

## Prerequisites

Before doing anything, verify these:

### 1. Helius MCP Server

**CRITICAL**: Check if Helius MCP public tools are available (e.g., `heliusWallet`, `heliusAsset`, `heliusChain`). If they are NOT available, **STOP**. Do NOT attempt to call Helius APIs via curl or any other workaround. Tell the user:

```
You need to install the Helius MCP server first:
claude mcp add helius npx helius-mcp@2.3.0
Then restart Claude so the tools become available.
```

### 2. Jupiter API Key

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.

### 3. Helius API Key

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).

## Routing

Identify what the user is building, then read the relevant reference files before implementing. Always read references BEFORE writing code.

### Quick Disambiguation

These intents map to different Jupiter APIs. Route them correctly:

- **"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`.
- **"limit order" / "buy at price"** — Jupiter Trigger: `references/jupiter-trigger.md` + `references/helius-sender.md`.
- **"DCA" / "dollar cost average" / "recurring buy"** — Jupiter Recurring: `references/jupiter-recurring.md` + `references/helius-sender.md`.
- **"lend" / "earn yield" / "deposit" / "supply"** — Jupiter Lend (earn): `references/jupiter-lend.md` + `references/helius-sender.md`.
- **"borrow" / "leverage" / "vault" / "collateral"** — Jupiter Lend (vaults): `references/jupiter-lend.md` + `references/helius-sender.md`.
- **"token price" / "token info" / "token search"** — Jupiter data APIs: `references/jupiter-tokens-price.md`.
- **"monitor trades" / "track confirmation" / "real-time on-chain"** — Helius WebSockets or LaserStream: `references/helius-websockets.md` OR `references/helius-laserstream.md`.
- **"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`.
- **"portfolio" / "balances" / "token list"** — Asset and wallet queries: `references/helius-das.md` + `references/helius-wallet-api.md`.
- **"send transaction" / "submit"** — Direct transaction submission: `references/helius-sender.md` + `references/helius-priority-fees.md`.
- **"onboarding" / "API key" / "setup"** — Account setup: `references/helius-onboarding.md` + `references/jupiter-portal.md`.
- **"perps" / "leverage trade" / "long" / "short"** — Jupiter Perps (on-chain only): `references/jupiter-perps-predictions.md`. Note: no REST API yet.
- **"prediction market" / "bet" / "event"** — Jupiter Predictions: `references/jupiter-perps-predictions.md`.
- **"swap widget" / "embed swap" / "drop-in swap"** — Jupiter Plugin: `references/jupiter-plugin.md`.
- **"token safety" / "is this token safe"** — Token Shield: `references/jupiter-tokens-price.md`.

### Token Swaps (Swap API V2)
**Read**: `references/jupiter-swap.md`, `references/helius-sender.md`, `references/helius-priority-fees.md`, `references/integration-patterns.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `getSenderInfo`, `parseTransactions`)

Use this when the user wants to:
- Swap tokens on Solana (SOL, USDC, any SPL token)
- Build a swap UI or trading terminal
- Execute swaps with optimal routing across the various DEXes integrated with Jupiter
- Get swap quotes with price impact

### Lending & Borrowing (Lend Protocol)
**Read**: `references/jupiter-lend.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `parseTransactions`)

Use this when the user wants to:
- Earn yield by depositing tokens (jlTokens)
- Borrow against collateral using vaults
- Query lending rates and pool data
- Build a lending/borrowing UI
- Manage leveraged positions

### Limit Orders (Trigger API V2)
**Read**: `references/jupiter-trigger.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `parseTransactions`)

Use this when the user wants to:
- Place limit orders (buy/sell at a USD price target)
- Set up OCO (take-profit + stop-loss) or OTOCO orders
- View, update, or cancel open orders
- Build an order book UI

### Dollar-Cost Averaging (Recurring API)
**Read**: `references/jupiter-recurring.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `parseTransactions`)

Use this when the user wants to:
- Set up recurring token purchases (DCA)
- View or cancel DCA orders
- Build a DCA interface

### Perpetuals & Prediction Markets
**Read**: `references/jupiter-perps-predictions.md`, `references/helius-sender.md`
**MCP tools**: Helius (`getPriorityFeeEstimate`, `parseTransactions`, `getAccountInfo`)

Use this when the user wants to:
- Open long/short leveraged positions (perps — on-chain only)
- Trade on prediction markets (events, YES/NO outcomes)
- Query position data or market orderbooks
- Build a perps or prediction market UI

### Swap Widget (Jupiter Plugin)
**Read**: `references/jupiter-plugin.md`

Use this when the user wants to:
- Embed a swap UI without building from scratch
- Add a floating swap widget to an existing app
- Integrate Jupiter swaps with minimal code

From helius-labs/core-ai, MIT.

More from helius-labs/core-ai