Jupiter Prediction Market

Dev Tools

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.

Install

openclaw skills install jupiter-prediction-market

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:

Market Scanner - Find markets by volume, probability, category
Opportunity Finder - Detect mispriced markets
Portfolio Monitor - Track positions, P&L, claimable
Auto-Claim - Batch claim winnings
Portfolio Health - Risk checks (position limits, diversification)
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