Market Correlations

GET/gateway/v1/prediction-market/correlations

Returns 30-day Pearson price correlation pairs between Polymarket markets within a category.

Correlation data covers the top 100 markets by 7-day volume globally; lower-volume markets may not have correlation data.

Filter by `condition_id` to find all markets correlated with a specific market, or set `min_correlation` to control the threshold.

The `category` parameter is required.

Data refresh: ~5 minutes.

Query Parameters

categoryenum<string>required

Category (correlations are within-category only)

Available options:cryptocultureeconomicsfinancialspoliticsstemsports

condition_idstring

Filter to pairs involving this market

min_correlationnumber

Minimum absolute correlation

limitinteger

Results per page

offsetinteger

Pagination offset

Market Correlations

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/prediction-market/correlations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseCorrelationItem.json",
  "data": [
    {
      "category": "<string>",
      "correlation": 123,
      "market_a_condition_id": "<string>",
      "market_a_question": "<string>",
      "market_b_condition_id": "<string>",
      "market_b_question": "<string>",
      "overlapping_days": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}