Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.jup.ag/docs/llms.txt

Use this file to discover all available pages before exploring further.

BETAThe Prediction Market API is currently in beta and subject to breaking changes as we continue to improve the product. If you have any feedback, please reach out in Discord.
This doc covers how to discover prediction market events, search for specific topics, and retrieve detailed market information including pricing data. For conceptual background on how events, markets, and pricing work, see the Prediction Market Overview.

​
Prerequisite

To query events and markets data, you need:
API REFERENCEFor complete endpoint specifications, see the Prediction API Reference.

​
List Events

Use GET /events to retrieve a paginated list of prediction market events. You can filter by category, provider, and status.
ParameterTypeDescription
categorystringFilter by category: crypto, sports, politics, esports, culture, economics, tech
subcategorystringFilter by subcategory within the category
filterstringFilter by status: new, live, trending
sortBystringSort field
sortDirectionstringSort direction: asc or desc
includeMarketsbooleanInclude nested markets in response
startnumberPagination start index
endnumberPagination end index
Example: List Trending Crypto Events 
const response = await fetch(
  'https://api.jup.ag/prediction/v1/events?' + new URLSearchParams({
    category: 'crypto',
    filter: 'trending',
    includeMarkets: 'true'
  }),
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const events = await response.json();
console.log(events);

​
Search Events

Use GET /events/search to find events by keyword.
ParameterTypeDescription
querystringSearch term
limitnumberMaximum results to return
const response = await fetch(
  'https://api.jup.ag/prediction/v1/events/search?' + new URLSearchParams({
    query: 'nba',
    limit: '10'
  }),
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const searchResults = await response.json();

​
Get Event Details

Use GET /events/{eventId} to retrieve full details for a specific event, including all its markets. 
const eventId = 'event-123';
const response = await fetch(
  `https://api.jup.ag/prediction/v1/events/${eventId}`,
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const event = await response.json();

​
Get Suggested Events

Use GET /events/suggested/{pubkey} to get personalized event recommendations based on a user’s trading history. 
const userPubkey = 'YOUR_WALLET_PUBLIC_KEY';
const response = await fetch(
  `https://api.jup.ag/prediction/v1/events/suggested/${userPubkey}`,
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const suggestedEvents = await response.json();

​
Get Market Details

Use GET /markets/{marketId} to retrieve detailed information about a specific market, including current pricing.
There can be multiple markets for the same event.
const marketId = 'market-456';
const response = await fetch(
  `https://api.jup.ag/prediction/v1/markets/${marketId}`,
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const market = await response.json();
console.log(market);
Example response: 
{
  "marketId": "market-456",
  "status": "open",
  "result": null,
  "openTime": 1704067200,
  "closeTime": 1719792000,
  "resolveAt": null,
  "marketResultPubkey": null,
  "metadata": {
    "marketId": "market-456",
    "title": "SOL $500 by Q2 2026",
    "status": "open",
    "result": "",
    "closeTime": 1719792000,
    "openTime": 1704067200,
    "isTeamMarket": false,
    "rulesPrimary": "Resolves YES if SOL reaches $500..."
  },
  "pricing": {
    "buyYesPriceUsd": 650000,
    "buyNoPriceUsd": 380000,
    "sellYesPriceUsd": 620000,
    "sellNoPriceUsd": 350000,
    "volume": 450000
  }
}

​
Understanding Prices

Prices are in JupUSD or USDC native token unitsAll prices in the API are denominated in native token units where 1,000,000 native token units for JupUSD or USDC = $1.00.For example:
  • 650000 = $0.65 (650000 / 1,000,000 = $0.65)
  • 380000 = $0.38 (380000 / 1,000,000 = $0.38)
  • 10000 = $0.01 (10000 / 1,000,000 = $0.01)
The market response includes four price fields:
FieldDescription
buyYesPriceUsdCost to buy a YES contract
sellYesPriceUsdAmount received when selling a YES contract
buyNoPriceUsdCost to buy a NO contract
sellNoPriceUsdAmount received when selling a NO contract
volumeTrading volume for this market
Price as ProbabilityMarket prices reflect the implied probability of an outcome. A buyYesPriceUsd of 650000 ($0.65) suggests the market believes there’s roughly a 65% chance of YES being the outcome.

​
Market Status

StatusDescription
openMarket is actively trading
closedTrading has stopped, awaiting settlement
cancelledMarket voided, positions returned

​
Market Result

ResultDescription
"" (empty)Market not yet resolved
pendingResolution in progress
yesYES outcome confirmed
noNO outcome confirmed

​
Get Orderbook Data

Use GET /orderbook/{marketId} to retrieve the current orderbook with bid/ask depth. The response has four arrays. Each entry is a [price, quantity] pair:
FieldDescription
yesYES bids: [price_cents, quantity]. Price is in cents (e.g. 1 = $0.01).
noNO bids: [price_cents, quantity]. Same format as yes.
yes_dollarsYES bids with price as decimal string: ["0.0100", quantity].
no_dollarsNO bids with price as decimal string. Same format as yes_dollars.
Quantities are in base units (e.g. contract size). Arrays are ordered by price (typically best bid first). Example: Get orderbook data for a specific market 
const marketId = 'market-456';
const response = await fetch(
  `https://api.jup.ag/prediction/v1/orderbook/${marketId}`,
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const orderbook = await response.json();
Example response: 
{
  "yes": [
    [1, 346014],
    [2, 10568],
    [3, 12300]
  ],
  "no": [
    [1, 219],
    [2, 14],
    [3, 4400]
  ],
  "yes_dollars": [
    ["0.0100", 346014],
    ["0.0200", 10568],
    ["0.0300", 12300]
  ],
  "no_dollars": [
    ["0.0100", 219],
    ["0.0200", 14],
    ["0.0300", 4400]
  ]
}

​
Check Trading Status

Use GET /trading-status to verify if the exchange is actively trading. This is useful for conditional logic before placing orders. 
const response = await fetch(
  'https://api.jup.ag/prediction/v1/trading-status',
  {
    headers: {
      'x-api-key': 'your-api-key'
    }
  }
);

const status = await response.json();
console.log('Trading active:', status.trading_active);

​
What’s Next

Now that you know how to discover events and markets, you’re ready to open positions.

Open Positions

Create buy orders for YES or NO contracts