Skip to main content
GET
/
api
/
v1
/
events
/
{id}
Get event details
curl --request GET \
  --url https://v2.api.adj.news/api/v1/events/{id} \
  --header 'Authorization: Bearer <token>'
{
  "event_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "region": "<string>",
  "election_date": "2023-12-25",
  "status": "<string>",
  "markets": [
    {
      "market_id": "<string>",
      "market_name": "<string>",
      "platform": "<string>",
      "market_position": "<string>",
      "latest_price": 123,
      "total_volume": 123
    }
  ]
}
Retrieve detailed information about a specific event with all linked markets.

​
Path Parameters

​
id
string
required
The unique event identifier (e.g., senate-co-26, pres-2028-party).

​
Response

{
  "event_id": "pres-2028-party",
  "name": "2028 Presidential Election by Party",
  "description": "Which party will win the 2028 US Presidential Election?",
  "category": "presidential",
  "region": "US",
  "election_date": "2028-11-03",
  "status": "active",
  "markets": [
    {
      "market_id": "KXPRESPARTY-2028-R",
      "market_name": "Republican wins 2028 Presidential",
      "platform": "kalshi",
      "market_position": "Republican",
      "latest_price": 47.0,
      "total_volume": 75000.0
    },
    {
      "market_id": "KXPRESPARTY-2028-D",
      "market_name": "Democrat wins 2028 Presidential",
      "platform": "kalshi",
      "market_position": "Democrat",
      "latest_price": 52.0,
      "total_volume": 72000.0
    }
  ]
}
FieldTypeDescription
event_idstringUnique identifier
namestringHuman-readable name
descriptionstringDetailed description
categorystringEvent category
regionstringState/region code
election_datedateElection date
statusstringEvent status
marketsarrayList of linked markets

​
Market Fields

FieldTypeDescription
market_idstringUnique market identifier
market_namestringMarket name/question
platformstringSource platform
market_positionstringPosition (e.g., “Republican”, “Democrat”)
latest_pricenumberCurrent probability (0-100)
total_volumenumberTotal trading volume

​
Example

curl "https://v2.api.adj.news/api/v1/events/pres-2028-party" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Error

StatusDescription
404Event not found

Authorizations

​
Authorization
string
header
required

Auth0 JWT Bearer token

Path Parameters

​
id
string
required

Event ID

Response

Event details

​
event_id
string
​
name
string
​
description
string | null
​
category
string
​
region
string
​
election_date
string<date> | null
​
status
string
​
markets
object[]