Execute Jupiter API operations on Solana - fetch quotes, sign transactions, execute swaps, prediction markets. Use when implementing token swaps, DCA, limit orders, lending, prediction markets, or any Jupiter integration. Includes scripts for Ultra and Metis swap flows.
Run pnpm install once per clone (and again after dependency changes) before any pnpm fetch-api, pnpm wallet-sign, pnpm execute-ultra, or pnpm send-transaction command.
API Key Setup
ALWAYS required. All Jupiter API endpoints require an x-api-key header.
-e, --endpoint (required): API path, e.g., /ultra/v1/order
-p, --params: Query params (GET) or body (POST) as JSON string
-b, --body: Request body for POST requests
-m, --method: HTTP method, GET (default) or POST
-k, --api-key: API key (or use JUP_API_KEY env var)
wallet-sign.ts
Sign transactions using a local wallet file.
SECURITY NOTE: The --wallet flag is required. This script does not accept private keys via command line arguments to prevent exposure in shell history and process listings.
-r, --request-id (required): Request ID from /ultra/v1/order response
-t, --signed-tx (required): Base64-encoded signed transaction
-k, --api-key: API key (or use JUP_API_KEY env var)
Output: Execution result JSON including signature and status.
send-transaction.ts
Send signed transactions to Solana RPC. Use for Metis swaps (Ultra handles RPC internally).
Warning: The default public Solana RPC (api.mainnet-beta.solana.com) is rate-limited and unreliable for production use. Use a dedicated RPC provider (Helius, QuickNode, Triton, etc.) for production applications.
# List your positions
pnpm fetch-api -e /prediction/v1/positions -p '{"ownerPubkey":"YOUR_WALLET_ADDRESS"}'
# Get specific position
pnpm fetch-api -e /prediction/v1/positions/{positionPubkey}
# View order history
pnpm fetch-api -e /prediction/v1/history -p '{"ownerPubkey":"YOUR_WALLET_ADDRESS"}'
Step 5: Claim Winnings
After market resolves, claim payout for winning positions:
WITHDRAW=$(pnpm fetch-api -e /lend/v1/earn/withdraw -m POST -b '{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "1000000",
"signer": "YOUR_WALLET_ADDRESS"
}')
# Sign and send as above
Portfolio API
Track DeFi positions, platform info, and staked JUP across Solana.
Get Positions
Fetch all positions for a wallet address across Jupiter products.
bash
# Get all positions
pnpm fetch-api -e /portfolio/v1/positions/YOUR_WALLET_ADDRESS
# Filter by specific platforms
pnpm fetch-api -e /portfolio/v1/positions/YOUR_WALLET_ADDRESS -p '{"platforms":"jupiter-exchange,jupiter-governance"}'
Response includes:
elements: Array of position types (Multiple, Liquidity, Leverage, BorrowLend, Trade)
tokenInfo: Token metadata indexed by network and address
fetcherReports: Status of each data fetcher
Get Platforms
List all available platforms tracked by the Portfolio API.
# Get active orders
pnpm fetch-api -e /trigger/v1/getTriggerOrders -p '{"user":"YOUR_WALLET","orderStatus":"active"}'
# Get order history
pnpm fetch-api -e /trigger/v1/getTriggerOrders -p '{"user":"YOUR_WALLET","orderStatus":"history","page":"1"}'
Cancel Order
bash
# Cancel single order
CANCEL=$(pnpm fetch-api -e /trigger/v1/cancelOrder -m POST -b '{
"maker": "YOUR_WALLET_ADDRESS",
"order": "ORDER_ACCOUNT_ADDRESS",
"computeUnitPrice": "auto"
}')
# Sign and send transaction
# Cancel all orders (batched in groups of 5)
CANCEL_ALL=$(pnpm fetch-api -e /trigger/v1/cancelOrders -m POST -b '{
"maker": "YOUR_WALLET_ADDRESS",
"computeUnitPrice": "auto"
}')
Trigger API Endpoints
Method
Endpoint
Description
POST
/trigger/v1/createOrder
Create limit order
GET
/trigger/v1/getTriggerOrders
Get orders by wallet
POST
/trigger/v1/cancelOrder
Cancel single order
POST
/trigger/v1/cancelOrders
Cancel multiple orders (batched)
Fees: 0.03% for stable pairs, 0.1% for other pairs.
Recurring API (DCA)
Automate recurring token purchases at specified intervals.
interval: Seconds between purchases (86400 = daily)
minPrice/maxPrice: Optional price bounds (null = any price)
startAt: Unix timestamp to start (null = immediate)
Get Orders
bash
# Get active DCA orders
pnpm fetch-api -e /recurring/v1/getRecurringOrders -p '{"user":"YOUR_WALLET","orderStatus":"active","recurringType":"time"}'
# Get order history
pnpm fetch-api -e /recurring/v1/getRecurringOrders -p '{"user":"YOUR_WALLET","orderStatus":"history","recurringType":"time","page":"1"}'
Cancel Order
bash
CANCEL=$(pnpm fetch-api -e /recurring/v1/cancelOrder -m POST -b '{
"user": "YOUR_WALLET_ADDRESS",
"order": "ORDER_ACCOUNT_ADDRESS",
"recurringType": "time"
}')
# Sign and send transaction
Recurring API Endpoints
Method
Endpoint
Description
POST
/recurring/v1/createOrder
Create DCA order
GET
/recurring/v1/getRecurringOrders
Get orders by wallet
POST
/recurring/v1/cancelOrder
Cancel order
Fees: 0.1% per execution. Token2022 tokens NOT supported.
Ultra rate limits increase as you execute more swaps. Base: 50 requests per 10-second window.
Fees
API
Fee
Ultra
5-10 basis points per swap
Metis
No Jupiter fee (you pay gas)
Integrators can add custom fees (50-255 bps). Jupiter takes 20% of integrator fees.
Gasless Requirements
Ultra offers "gasless" swaps where Jupiter pays the transaction fees, but with important caveats:
User still needs SOL for account rent (creating token accounts)
User must sign the transaction (not truly "zero-touch")
Minimum trade amount: ~$10 equivalent
Automatic when taker has <0.01 SOL
JupiterZ RFQ: market makers pay transaction fees
Transaction Size Limit
Solana transactions are limited to 1232 bytes. If you hit this:
Reduce maxAccounts parameter in quote request
Use dynamicComputeUnitLimit: true for Metis
Token Limitations
Token2022: NOT supported for Recurring (DCA) orders
Some tokens may have transfer fees or freeze authority
Ultra vs Metis
Feature
Ultra
Metis
RPC required
No (Jupiter handles)
Yes (your RPC)
Gasless
Yes (conditions apply)
No
Custom instructions
No
Yes
Transaction composition
No
Yes
Slippage
Auto-optimized
Manual
Use Ultra for most swaps. Use Metis only when you need to add custom instructions or compose transactions.
Common Errors
Error
Cause
Fix
TransactionExpiredBlockhashNotFound
Blockhash expired
Request fresh order/quote
SlippageToleranceExceeded
Price moved too much
Increase slippage or retry
InsufficientFunds
Not enough SOL/tokens
Check balances
RateLimited (429)
Too many requests
Wait and retry, or upgrade tier
InvalidSignature
Wrong signer or corrupted tx
Verify wallet matches taker address
Ultra Execute Error Codes
Code
Meaning
0
Success
-1 to -5
Client/validation errors
-1000 to -1999
Aggregator routing errors
-2000 to -2999
RFQ (market maker) errors
Environment Variables
Variable
Description
Default
JUP_API_KEY
Jupiter API key
(required)
SOLANA_RPC_URL
RPC endpoint for send-transaction
https://api.mainnet-beta.solana.com
Common Token Mints
Token
Mint Address
SOL (wrapped)
So11111111111111111111111111111111111111112
USDC
EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
USDT
Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB
JUP
JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
Resources
Freshness note: This skill includes Jupiter API guidance, but the API can change. After each new run/session, verify endpoints and params against the latest docs at dev.jup.ag.
