🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Jupiter Prediction Market
πŸ¦€ ClawHub

Jupiter Prediction Market

by @moltbotteam

Complete Node.js client for Jupiter Prediction Market API. Use when building AI agents for prediction market trading, portfolio management, or automated trad...

Versionv0.1.0
Downloads834
Stars⭐ 1
#clawhub
TERMINAL
clawhub install jupiter-prediction-market

πŸ“– About This Skill

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 
    Auto-claim winnings
    
node scripts/auto-claim.js  [--dry-run] [--min=1]
    Portfolio health check
    
node scripts/portfolio-health.js

    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

    ⚑ When to Use

    TriggerAction
    - Query market data, events, and user positions
    - Create automated market scanning and opportunity detection
    - Monitor portfolio health and risk
    - Claim payouts after market settlement

    πŸ’‘ Examples

    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.