Skip to main content
GET
/
markets
/
{marketId}
cURL
curl --request GET \
  --url https://api.jup.ag/prediction/v1/markets/{marketId} \
  --header 'x-api-key: <api-key>'
{
  "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
  }
}

Authorizations

​
x-api-key
string
header
required

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

Path Parameters

​
marketId
string
required

Market identifier

Minimum string length: 1

Response

Market data

Market fields are returned flat (there is no nested metadata object).

​
marketId
string
required

Market identifier

​
status
enum<string>
required

Current market status

Available options:
open,
closed,
cancelled
​
result
enum<string> | null
required

Market result. null until resolved, then "yes" or "no"

Available options:
yes,
no
​
openTime
number
required

Unix timestamp (seconds) when the market opens

​
closeTime
number
required

Unix timestamp (seconds) when the market closes

​
resolveAt
required

When the market resolved. null while open; returned as an ISO 8601 string once resolved

​
eventId
string

Parent event identifier

​
provider
enum<string>

Market data provider

Available options:
polymarket,
gx,
bisonfi
​
title
string

Market title

​
marketResultPubkey
string | null

Public key of the market result account

​
imageUrl
string<uri> | null

Market image URL

​
rulesPrimary
string

Primary resolution rules

​
rulesSecondary
string

Secondary resolution rules

​
outcomes
string[]

Outcome labels for the market

​
marketOptions
object[]

Selectable options for team or multi-outcome markets

​
clobTokenIds
string[]

Underlying CLOB token IDs (provider-specific)

​
isTeamMarket
boolean

True for team or sports markets

​
team
object

Team metadata, present for team markets

​
sportsLine
number | null

Sports line or handicap, when applicable

​
sportsMarketType
string | null

Sports market type, when applicable

​
pricing
object