Skip to main content
GET
/
api
/
v1
/
markets
List markets
curl --request GET \
  --url https://v2.api.adj.news/api/v1/markets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "market_id": "<string>",
      "ticker": "<string>",
      "platform": "<string>",
      "question": "<string>",
      "probability": 123,
      "volume": 123,
      "status": "<string>",
      "category": "<string>",
      "end_date": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "total": 123,
    "page": 123,
    "per_page": 123,
    "total_pages": 123,
    "has_next": true,
    "has_prev": true
  }
}
Returns a paginated list of markets with filtering options.

​
Query Parameters

​
Pagination

​
page
integer
default:1
Page number (1+)
​
per_page
integer
default:100
Results per page (1-500)

​
Filters

​
platform
string
Filter by platform: kalshi, polymarket
​
category
string
Filter by category: presidential, senate, house, governor
​
tag
string
Filter by tag substring
​
keyword
string
Search in questions and descriptions (case-insensitive)
​
start_date
datetime
Markets created after this date (ISO 8601)
​
end_date
datetime
Markets created before this date (ISO 8601)
​
end_date_after
datetime
Markets ending after this date
​
end_date_before
datetime
Markets ending before this date
​
probability_min
number
Minimum probability (0-100)
​
probability_max
number
Maximum probability (0-100)
​
volume_min
number
Minimum trading volume
​
volume_max
number
Maximum trading volume
​
min_liquidity
number
Minimum liquidity
​
include_closed
boolean
default:false
Include closed markets
​
include_resolved
boolean
default:false
Include resolved markets
​
sort_dir
string
default:"desc"
Sort direction: desc (highest volume first), asc

​
Response

{
  "data": [
    {
      "market_id": "SENATECO-26-R",
      "ticker": "SENATECO-26-R",
      "platform": "kalshi",
      "question": "Will the Republican party win the Senate seat in Colorado",
      "probability": 5.0,
      "volume": 355.07,
      "status": "active",
      "category": "senate",
      "end_date": "2027-11-03T15:00:00Z",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-02-08T14:22:00Z"
    }
  ],
  "meta": {
    "total": 1247,
    "page": 1,
    "per_page": 100,
    "total_pages": 13,
    "has_next": true,
    "has_prev": false
  }
}

​
Examples

# Get Kalshi markets
curl "https://v2.api.adj.news/api/v1/markets?platform=kalshi&per_page=20"

# Senate markets with high probability
curl "https://v2.api.adj.news/api/v1/markets?category=senate&probability_min=80"

# Search by keyword
curl "https://v2.api.adj.news/api/v1/markets?keyword=presidential"

# Paginate
curl "https://v2.api.adj.news/api/v1/markets?page=2&per_page=50"

Authorizations

​
Authorization
string
header
required

Clerk JWT Bearer token

Query Parameters

​
platform
string

Filter by platform (kalshi, polymarket)

​
category
string

Filter by category

​
keyword
string

Search in questions and descriptions

​
tag
string

Filter by tag

​
start_date
string<date-time>

Filter by creation date (after)

​
end_date
string<date-time>

Filter by creation date (before)

​
end_date_after
string<date-time>

Filter markets ending after this date

​
end_date_before
string<date-time>

Filter markets ending before this date

​
probability_min
number

Minimum probability (0-100)

​
probability_max
number

Maximum probability (0-100)

​
volume_min
number

Minimum volume

​
volume_max
number

Maximum volume

​
min_liquidity
number

Minimum liquidity

​
include_closed
boolean
default:false

Include closed markets

​
include_resolved
boolean
default:false

Include resolved markets

​
sort_dir
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
page
integer
default:1

Page number

​
per_page
integer
default:100

Items per page

Required range: x <= 500

Response

200 - application/json

List of markets

​
data
object[]
​
meta
object