jupiter-prediction-market

name

jupiter-prediction-market

description

Complete Node.js client for Jupiter Prediction Market API. Use when building AI agents for prediction market trading, portfolio management, or automated trading bots on Solana. Covers: (1) Querying events, markets, orders, positions, payouts, history, and social features, (2) Creating/managing trading positions, (3) Claiming payouts after market settlement, (4) Building autonomous agent workflows for market scanning, opportunity finding, portfolio monitoring, and risk management.

Jupiter Prediction Skill v1.0

Purpose

Enable AI agents to interact with Jupiter Prediction Market API for autonomous trading and portfolio management.

When to Use

• Build autonomous trading bots or agents
• Query market data, events, and user positions
• Create automated market scanning and opportunity detection
• Monitor portfolio health and risk
• Claim payouts after market settlement

Scope

• Read/write access to Jupiter Prediction API
• Requires API key from Jupiter Portal
• All transactions require user signature via Solana wallet
• Beta API - subject to breaking changes

Quick Start

const { JupiterPrediction, parseEventsResponse, formatUsd } = require('./src');

const client = new JupiterPrediction();

const events = await client.list({ category: 'crypto', filter: 'trending', limit: 5 });
const parsed = parseEventsResponse(events);
console.log('Events:', parsed.data.map(e => e.title));

Configuration

export JUPITER_API_KEY=your-api-key

Or use config file config/api-key.json.

Supported Capabilities

Client Endpoints

Category	Methods
Events	list, search, getEvent, suggested
Markets	getMarket, orderbook
Orders	create, listOrders, status, cancelOrder
Positions	listPositions, getPosition, closePosition, closeAllPositions, claim
History	listHistory, getHistoryByPosition
Social	profile, pnlHistory, trades, leaderboards, follow/unfollow

Utility Functions

Function	Description
microUsdToUsd(microUsd)	Convert micro USD to USD
formatUsd(microUsd, decimals)	Format as currency string
calculateProbability(yesPrice)	Implied probability (%)
parseEventsResponse(response)	Parse event data
parseMarketResponse(market)	Parse market data
parsePositionsResponse(response)	Parse position data
filterClaimable(positions)	Filter claimable positions
filterOpen(positions)	Filter open positions
aggregatePnL(positions)	Calculate total P&L

Bundled Scripts

Run from project root:

# Scan markets by criteria
node scripts/scan-markets.js --crypto --limit=10 --min-volume=10000

# Find mispriced opportunities
node scripts/find-opportunities.js --threshold=20 --min-volume=50000

# Monitor portfolio
node scripts/monitor-portfolio.js <wallet-address>

# Auto-claim winnings
node scripts/auto-claim.js <wallet-address> [--dry-run] [--min=1]

# Portfolio health check
node scripts/portfolio-health.js <wallet-address>

Bundled Workflows

The bundled scripts provide complete autonomous agent workflows:

1. Market Scanner - Find markets by volume, probability, category
2. Opportunity Finder - Detect mispriced markets
3. Portfolio Monitor - Track positions, P&L, claimable
4. Auto-Claim - Batch claim winnings
5. Portfolio Health - Risk checks (position limits, diversification)
6. Trading Cycle - Complete discovery → evaluation → execution

Code Examples

See src/ for available endpoints and utilities:

• src/client.js - Main API client class
• src/index.js - Exports and utility functions
• src/endpoints/ - Individual endpoint modules
• src/utils/ - Helper functions (parser, prices, errors)

API Reference

Client methods are documented in code comments. Main classes:

• JupiterPrediction - Main client (src/client.js)
• Utility functions in src/index.js

Verification

Verify syntax:

node --check src/index.js
node --check src/client.js

Run a script (requires JUPITER_API_KEY):

export JUPITER_API_KEY=your-key
node scripts/scan-markets.js --crypto --limit=5

Version

• v1.0.0

License

MIT