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>",
      "isActive": true,
      "isLive": true,
      "category": "<string>",
      "subcategory": "<string>",
      "volumeUsd": "<string>",
      "closeCondition": "<string>",
      "beginAt": "<string>",
      "rulesPdf": "<string>",
      "tags": [
        "<string>"
      ],
      "metadata": {
        "eventId": "<string>",
        "title": "<string>",
        "subtitle": "<string>",
        "slug": "<string>",
        "series": "<string>",
        "closeTime": "<string>",
        "imageUrl": "<string>",
        "isLive": true
      },
      "markets": [
        {
          "marketId": "<string>",
          "openTime": 123,
          "closeTime": 123,
          "resolveAt": "<string>",
          "eventId": "<string>",
          "title": "<string>",
          "marketResultPubkey": "<string>",
          "imageUrl": "<string>",
          "rulesPrimary": "<string>",
          "rulesSecondary": "<string>",
          "outcomes": [
            "<string>"
          ],
          "marketOptions": [
            {
              "label": "<string>",
              "buyYes": true
            }
          ],
          "clobTokenIds": [
            "<string>"
          ],
          "isTeamMarket": true,
          "team": {},
          "sportsLine": 123,
          "sportsMarketType": "<string>",
          "pricing": {
            "buyYesPriceUsd": 123,
            "buyNoPriceUsd": 123,
            "sellYesPriceUsd": 123,
            "sellNoPriceUsd": 123,
            "volume": 123
          }
        }
      ],
      "volume24hr": "<string>",
      "liveScore": "<unknown>"
    }
  ],
  "pagination": {
    "start": 1,
    "end": 1,
    "total": 1,
    "hasNext": true
  }
}

Authorizations

x-api-key
string
header
required

Query Parameters

provider
enum<string>
default:polymarket

Data provider for events (defaults to polymarket)

Available options:
kalshi,
polymarket
includeMarkets
boolean | null
includeAllMarkets
boolean

Include all allowed sports market types (moneyline, spread, totals) and extra (e.g. Saba) markets mapped onto Polymarket events. Defaults to false (moneyline only). F1 events always include every sportsMarketType.

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, trending for events with recent trade activity, and upcoming for events that have not begun yet.

Available options:
new,
live,
trending,
upcoming
tags
string

Filter events by tag (e.g. soccer).

Response

200 - application/json

List of all events

data
object[]
required
pagination
object
required