Menu
Use Mirra to jupiter dex integration for solana token swaps and portfolio management. Covers all Jupiter SDK operations via REST API.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | mirra-jupiter |
| description | Use Mirra to jupiter dex integration for solana token swaps and portfolio management. Covers all Jupiter SDK operations via REST API. |
| allowed-tools | Read, Bash(curl:*, jq:*) |
Jupiter DEX integration for Solana token swaps and portfolio management
You need the user's API key. Ask for these if not provided:
API_KEY: Mirra API key (generated in Mirra app > Settings > API Keys)API_URL: Defaults to https://api.fxn.world (only ask if they mention a custom server)All operations use a single POST endpoint with the resource ID and method in the body:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{
"resourceId": "jupiter",
"method": "{operation}",
"params": { ...args }
}' | jq .
Replace {operation} with the operation name from the table below.
Legacy alternative:
POST ${API_URL}/api/sdk/v1/jupiter/{operation}with args as the request body also works but is not recommended for new integrations.
| Operation | Description |
|---|---|
swap | Execute a token swap on Jupiter DEX. Provide EITHER amount (input to spend) OR outputAmount (... |
getHoldings | Get token holdings for a wallet with live USD prices. Returns normalized FLAT structure with owne... |
getTokenSecurity | Get token security information using Jupiter Shield. Returns normalized FLAT structure with riskL... |
searchTokens | Search for tokens by symbol, name, or mint address. Returns top 10 slim results for quick identif... |
refreshSwap | Refresh an expired swap with a new quote. Only feedItemId and swapId are required — original swap... |
launchToken | Launch a new token on Solana via Jupiter Studio. Creates a DBC (Dynamic Bonding Curve) pool. The ... |
swapExecute a token swap on Jupiter DEX. Provide EITHER amount (input to spend) OR outputAmount (output to receive), not both. When user says "buy 1000 TOKEN_B", use outputAmount: 1000 — the adapter auto-calculates input from live prices. SOL mint: So11111111111111111111111111111111111111112.
Arguments:
inputMint (string, required): Mint address of the token you are SPENDING (e.g. SOL: So11111111111111111111111111111111111111112)outputMint (string, required): Mint address of the token you are BUYINGamount (number, optional): Amount of INPUT token to spend (in UI units, e.g. 0.5 SOL). Use this when user says "spend X SOL on tokens". Provide this OR outputAmount, not both.outputAmount (number, optional): Amount of OUTPUT token to receive (UI units). Adapter auto-calculates input from live prices. Use this when user says "buy X tokens". Provide this OR amount, not both.inputDecimals (number, optional): Number of decimals for input token. Auto-resolved from Jupiter token registry if not provided.slippageBps (number, optional): Slippage tolerance in basis points (default: 50)Returns:
AdapterOperationResult: Returns { type, transaction, requestId, signerWallet, expiresAt, inputMint, outputMint, inputAmount, inputDecimals, expectedOutputAmount, expectedOutputAmountUi, priceImpact, slippageBps, hasRoutePlan, routeStepCount }. FLAT structure. Use expectedOutputAmountUi (human-readable token count) when reporting to users, NOT expectedOutputAmount (raw units).
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"swap","params":{"inputMint":"<value>","outputMint":"<value>"}}' | jq .
getHoldingsGet token holdings for a wallet with live USD prices. Returns normalized FLAT structure with owner, solBalance, solValueUsd, totalValueUsd, tokenCount, and tokens array. Each token includes priceUsd and valueUsd.
Arguments:
walletAddress (string, optional): Wallet address to check (uses actor wallet if not provided)Returns:
AdapterOperationResult: Returns { owner, solBalance, solValueUsd, totalValueUsd, tokenCount, tokens[] }. Each token has FLAT fields: mint, symbol, name, decimals, balance, uiBalance, logoURI, priceUsd, valueUsd, accountCount. No nested objects.
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"getHoldings","params":{}}' | jq .
getTokenSecurityGet token security information using Jupiter Shield. Returns normalized FLAT structure with riskLevel, warningCount, and security flags.
Arguments:
tokenMint (string, required): Token mint address to check security forReturns:
AdapterOperationResult: Returns { mint, riskLevel, warningCount, hasCriticalWarning, hasFreezableWarning, hasMintableWarning, warnings[] }. Each warning has FLAT fields: type, message, severity, source. No nested objects.
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"getTokenSecurity","params":{"tokenMint":"<value>"}}' | jq .
searchTokensSearch for tokens by symbol, name, or mint address. Returns top 10 slim results for quick identification. Use getTokenSecurity for detailed token analysis.
Arguments:
query (string, required): Search query (symbol, name, or mint address)Returns:
AdapterOperationResult: Returns { query, count, totalFound, results[] }. Each result: mint, symbol, name, priceUsd, marketCap, liquidity, isVerified, isSuspicious, holderCount, tags[].
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"searchTokens","params":{"query":"search term"}}' | jq .
refreshSwapRefresh an expired swap with a new quote. Only feedItemId and swapId are required — original swap parameters are loaded automatically from the feed item. Optionally override slippageBps.
Arguments:
feedItemId (string, required): Feed item ID containing the swap to refreshswapId (string, required): Original swap IDinputMint (string, optional): Optional override. If omitted, uses value from original swap.outputMint (string, optional): Optional override. If omitted, uses value from original swap.amount (number, optional): Optional override (in UI units). If omitted, uses value from original swap.inputDecimals (number, optional): Optional override. If omitted, auto-resolved from original swap or token registry.slippageBps (number, optional): Slippage tolerance in basis points (default from original swap or 50)Returns:
AdapterOperationResult: Returns { type, transaction, requestId, signerWallet, expiresAt, refreshedAt, inputMint, outputMint, inputAmount, inputDecimals, expectedOutputAmount, priceImpact, slippageBps, hasRoutePlan, routeStepCount }. FLAT structure.
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"refreshSwap","params":{"feedItemId":"<ID>","swapId":"<ID>"}}' | jq .
launchTokenLaunch a new token on Solana via Jupiter Studio. Creates a DBC (Dynamic Bonding Curve) pool. The user must have uploaded a token image in this conversation — pass the image URL provided in the chat. Returns a pending_transaction for the user to sign. FLAT structure.
Arguments:
tokenName (string, required): Name of the tokentokenSymbol (string, required): Token ticker symboltokenDescription (string, optional): Description for the token metadatatokenImageUrl (string, required): URL of the uploaded token image (from user message)quoteMint (string, optional): Quote token mint address. Defaults to USDC (EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v). Can also use SOL or JUP mint.preset (string, optional): Market cap preset: "meme" (16k→69k, default), "mid" (69k→420k), "premium" (420k→1M). Sets initialMarketCap and migrationMarketCap. Explicit values override preset.initialMarketCap (number, optional): Initial market cap in quote token units. Overrides preset value if provided.migrationMarketCap (number, optional): Market cap threshold for graduation/migration. Overrides preset value if provided.antiSniping (boolean, optional): Enable anti-sniping protection (default: false)feeBps (number, optional): Creator trading fee in basis points: 100 (1%) or 200 (2%). Default: 100isLpLocked (boolean, optional): Lock LP tokens (default: true)website (string, optional): Project website URL for token metadatatwitter (string, optional): Twitter/X URL for token metadatatelegram (string, optional): Telegram URL for token metadataReturns:
AdapterOperationResult: Returns { type, transaction, mint, signerWallet, expiresAt, tokenName, tokenSymbol, imageUrl }. FLAT structure.
Example:
curl -s -X POST "${API_URL}/api/sdk/v2/resources/call" \
-H "Content-Type: application/json" \
-H "x-api-key: ${API_KEY}" \
-d '{"resourceId":"jupiter","method":"launchToken","params":{"tokenName":"<value>","tokenSymbol":"<value>","tokenImageUrl":"https://example.com"}}' | jq .
All SDK responses return the operation payload wrapped in a standard envelope:
{
"success": true,
"data": { ... }
}
The data field contains the operation result. Error responses include:
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message"
}
}
jq . to pretty-print responses, jq .data to extract just the payloaddata.results or directly in data (check examples)--fail-with-body to curl to see error details on HTTP failuresexport API_KEY="your-key"Use Mirra to living dashboards — natively-rendered grids of typed widgets (stat, image_card, list, progress, sparkline) that flows keep current by pushing data into them..... Covers all Dashboards SDK operations via REST API.
Use Mirra to execute user-defined scripts in aws lambda. Covers all Scripts SDK operations via REST API.
Use Mirra to the places a space publishes to — its corporate x, blog, newsletter — and the drafted copy waiting to go out to them. use listchannels to see what this space.... Covers all Space Channels SDK operations via REST API.
Use Mirra to the space's shared work-ledger. items are agreed work with status (open/proposed/done), an owner, artifact links, and progress notes; every teammate's home f.... Covers all Work Items SDK operations via REST API.
The team work-ledger ritual for agents on a Mirra space: track agreed work, propose discoveries (then ask in chat), relay approvals, close what ships, and publish ONE narrated update card per work burst — revise, never stack. Rides the Mirra items adapter / MCP work-ledger tools.
START HERE for anything Mirra. Load this whenever the repo you're working in has a .mirra/ directory (it's linked to a Mirra team space), or your human mentions their Mirra space, teammates' updates, or the team ledger. Directs the ambient team rituals — record work in the shared ledger, publish update cards, ask the space before expanding scope — and indexes every detail-level mirra-* skill.