GET
/
api
/
markets
curl --request GET \
  --url https://api.data.adj.news/api/markets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "market_id": "<string>",
      "platform_id": "<string>",
      "ticker": "<string>",
      "adj_ticker": "<string>",
      "market_slug": "<string>",
      "platform": "<string>",
      "market_type": "<string>",
      "question": "<string>",
      "description": "<string>",
      "rules": "<string>",
      "result": "<string>",
      "link": "<string>",
      "status": "<string>",
      "reported_date": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "end_date": "<string>",
      "resolution_date": "<string>",
      "probability": 123,
      "volume": 123,
      "open_interest": 123,
      "liquidity": 123,
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "platform_ids": {},
      "status_details": {},
      "settlement_sources": [
        "<string>"
      ],
      "comments_count": 123,
      "has_comments": 123,
      "trades_count": 123,
      "event": "<string>"
    }
  ],
  "meta": {
    "count": 123,
    "limit": 123,
    "offset": 123,
    "hasMore": true
  }
}

​
List Markets with Advanced Filtering

This endpoint provides a comprehensive way to retrieve markets with powerful filtering, sorting, and pagination capabilities. It’s perfect for building market dashboards, search interfaces, and data visualizations.

​
Key Features

  • Flexible Filtering: Filter by platform, market type, status, category, and more
  • Content Search: Find markets containing specific keywords in questions or descriptions
  • Date Range Filtering: Filter by creation date, update date, or end date
  • Numerical Filtering: Filter by probability, volume, or liquidity ranges
  • Sorting Options: Sort by any field in ascending or descending order
  • Pagination: Control result size with limit and offset parameters

​
Response Format

The response includes both the market data and pagination metadata:

{
  "data": [
    {
      "market_id": "kalshi_KXSECPRESSMENTION-25JUN30-HOAX",
      "platform": "kalshi",
      "question": "Will the White House Press Secretary say Hoax at her next press briefing?",
      // ... other market fields
    },
    // ... more markets
  ],
  "meta": {
    "count": 1250,  // Total number of matching markets
    "limit": 100,   // Results per page
    "offset": 0,    // Current offset
    "hasMore": true // Whether there are more results
  }
}

​
Authentication

API key authentication is required for:

  • Retrieving more than 100 results
  • Accessing data older than 1 day

​
Common Use Cases

  1. Market Discovery: Build a browsing interface with filtering and sorting
  2. Data Analysis: Export filtered datasets for analysis
  3. Market Monitoring: Track markets matching specific criteria
  4. Custom Dashboards: Create personalized dashboards for specific market categories

Authorizations

​
Authorization
string
header
required

Enter your API key as the bearer token

Query Parameters

​
limit
integer
default:100

Number of results to return

​
offset
integer
default:0

Number of results to skip

​
platform
string

Filter by platform (e.g., kalshi, polymarket, etc.)

​
status
string

Filter by status (e.g., active, resolved, etc.)

​
category
string

Filter by category

​
market_type
string

Filter by market type (e.g., binary, scalar, etc.)

​
keyword
string

Search in question, description, and rules

​
tag
string

Filter by tag

​
created_after
string

Filter markets created after this date

​
created_before
string

Filter markets created before this date

​
probability_min
number

Minimum probability

​
probability_max
number

Maximum probability

​
sort_by
enum<string>
default:updated_at

Field to sort by

Available options:
created_at,
updated_at,
end_date,
probability,
volume,
liquidity
​
sort_dir
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
​
include_closed
boolean
default:false

Include closed markets

​
include_resolved
boolean
default:false

Include resolved markets

Response

200
application/json
List of markets
​
data
object[]
​
meta
object