Skip to main content
GET
/
events
/
search
cURL
curl --request GET \
  --url https://api.jup.ag/prediction/v1/events/search \
  --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
          }
        }
      ]
    }
  ]
}

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
query
string
required

Search term matched against event titles

Required string length: 1 - 200
limit
integer
Required range: 1 <= x <= 20

Response

200 - application/json

Events matching the search query

data
object[]
required