Skip to main content
GET
/
events
cURL
curl --request GET \
  --url https://api.jup.ag/prediction/v1/events \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "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
          }
        }
      ]
    }
  ],
  "pagination": {
    "start": 1,
    "end": 1,
    "total": 1,
    "hasNext": true
  }
}

Authorizations

x-api-key
string
header
required

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

Query Parameters

provider
enum<string>
default:polymarket

Data provider for events (defaults to polymarket)

Available options:
kalshi,
polymarket
includeMarkets
boolean | null
start
integer | null
Required range: x >= 0
end
integer | null
Required range: x >= 0
category
enum<string>
Available options:
all,
crypto,
sports,
politics,
esports,
culture,
economics,
tech
subcategory
sortBy
enum<string>

Sort field for events (volume or begin time). Pair with sortDirection to control ascending/descending.

Available options:
volume,
beginAt
sortDirection
enum<string>

Direction for the chosen sort field. Defaults to desc for volume and asc for beginAt.

Available options:
asc,
desc
filter
enum<string>

Apply named filters. Use new for events created in the last 24 hours, live for events that have begun, and trending for events with recent trade activity.

Available options:
new,
live,
trending

Response

200 - application/json

List of all events

data
object[]
required
pagination
object
required