GET
/
api
/
markets
/
{market_id}
/
related
curl --request GET \
  --url https://api.data.adj.news/api/markets/{market_id}/related \
  --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>"
    }
  ]
}

This endpoint retrieves markets that are semantically related to a specified market. It uses advanced vector search technology to find markets with similar topics, questions, or outcomes.

​
How It Works

The API uses two methods to find related markets:

  1. Vector Similarity: Using Cloudflare Vectorize to find markets with semantically similar questions
  2. Attribute Matching: Finding markets with matching platforms, categories, or market types

The system automatically falls back to attribute matching if vector search doesn’t return sufficient results.

​
Response Format

The response includes an array of related markets:

{
  "data": [
    {
      "market_id": "kalshi_KXSECPRESSMENTION-25JUN30-LIE",
      "platform": "kalshi",
      "question": "Will the White House Press Secretary say Lie at her next press briefing?",
      // ... other market fields
    },
    {
      "market_id": "polymarket_will-biden-say-hoax-during-next-press-conference",
      "platform": "polymarket",
      "question": "Will Biden say 'hoax' during next press conference?",
      // ... other market fields
    },
    // ... more related markets
  ]
}

​
Query Parameters

  • limit (optional): Number of related markets to return (default: 5)

​
Use Cases

  1. Market Discovery: Help users find related markets they might be interested in
  2. Cross-platform Analysis: Compare similar markets across different prediction platforms
  3. Content Recommendations: Provide “You might also like” recommendations
  4. Research: Identify market clusters around specific topics or events

​
Example

Finding markets related to a presidential election market:

curl https://api.data.adj.news/api/markets/polymarket_will-donald-trump-win-the-2024-us-presidential-election/related?limit=3

This might return markets about swing states, vice presidential candidates, or election-related prediction markets from other platforms.

Authorizations

​
Authorization
string
header
required

Enter your API key as the bearer token

Path Parameters

​
market_id
string
required

Unique identifier for the market

Query Parameters

​
limit
integer
default:5

Number of related markets to return

Response

200
application/json
Related markets
​
data
object[]