Skip to main content
GET
/
events
/
{eventId}
cURL
curl --request GET \
  --url https://api.jup.ag/prediction/v1/events/{eventId} \
  --header 'x-api-key: <api-key>'
{
  "eventId": "<string>",
  "series": "<string>",
  "winner": "<string>",
  "multipleWinners": true,
  "isActive": true,
  "isLive": true,
  "isTrending": true,
  "isRecommended": true,
  "category": "<string>",
  "subcategory": "<string>",
  "tvlDollars": "<string>",
  "volumeUsd": "<string>",
  "closeCondition": "<string>",
  "beginAt": "<string>",
  "rulesPdf": "<string>",
  "metadata": {
    "eventId": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "imageUrl": "<string>",
    "isLive": true
  },
  "markets": [
    {
      "marketId": "<string>",
      "event": "<string>",
      "status": "open",
      "result": "",
      "openTime": 123,
      "closeTime": 123,
      "settlementTime": 123,
      "metadata": {
        "marketId": "<string>",
        "isTradable": true,
        "title": "<string>",
        "subtitle": "<string>",
        "description": "<string>",
        "status": "<string>",
        "result": "<string>",
        "closeTime": 123,
        "openTime": 123,
        "settlementTime": 123,
        "rulesPrimary": "<string>",
        "rulesSecondary": "<string>"
      },
      "pricing": {
        "buyYesPriceUsd": 123,
        "buyNoPriceUsd": 123,
        "sellYesPriceUsd": 123,
        "sellNoPriceUsd": 123,
        "volume": 123,
        "openInterest": 123,
        "volume24h": 123,
        "liquidityDollars": 123,
        "notionalValueDollars": 123
      }
    }
  ]
}

Authorizations

x-api-key
string
header
required

Get API key via https://portal.jup.ag

Path Parameters

eventId
string
required

Event identifier

Minimum string length: 1

Query Parameters

includeMarkets
boolean | null

Response

Event data

eventId
string
required

Application-level identifier

series
string
required

Series-level identifier

winner
string
required

Winning market public key (empty string when unresolved)

multipleWinners
boolean
required

Whether the event allows multiple winning markets

isActive
boolean
required

Whether the event is active (listed on events)

isLive
boolean
required

Whether the event is currently live

Whether the event is trending in the current response context

Whether the event is recommended in the current response context

category
string
required

The category for the event, allowed values: all, crypto, sports, politics, esports, culture, economics, tech

subcategory
string
required

The subcategory for the event

tvlDollars
string
required

Formatted TVL in USD (no currency symbol)

volumeUsd
string
required

Total volume for the event

closeCondition
string
required

Close condition for the event

beginAt
string | null
required

Unix timestamp (seconds) when the event begins

rulesPdf
string
required

Document to full rules for the event

metadata
object
markets
object[]