Market Event Screener

Data Freshness & Historical Coverage

For data freshness and historical coverage, see Data Coverage by Chain; this endpoint follows it except where noted below.

• Returns a current, point-in-time snapshot of market activity metrics (volume, liquidity, and trader counts) — these reflect the latest state within the standard live latency rather than a historical look-back.

Get Prediction Market Event Screener

post

Browse and filter Polymarket events (groups of related markets). Includes aggregated volume, liquidity, and trader counts across all markets in each event.

What it helps to answer:

1. What are the most popular prediction market events?

2. How much total volume does an event have across all its markets?

3. Which events have the most active trading?

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Body

application/json

Request for event screener endpoint.

order_byany ofOptional

Sort order

Example: [{"direction":"DESC","field":"volume_24hr"}]

sort_bystring · enumOptionalDeprecated

Deprecated: use 'order_by' instead.

Default: volume_24hrPossible values:

querystring · max: 200Optional

Search query to filter results

Default: ""Example: bitcoin

statusstring · enumOptional

Filter by status (active, closed, or empty for all)

Default: ""Example: activePossible values:

tagsstring[] · max: 50Optional

Filter by tags

Example: ["Crypto","Bitcoin"]

min_liquiditynumber · min: -1Optional

Minimum liquidity filter (-1 = no filter)

Default: -1

max_liquiditynumber · min: -1Optional

Maximum liquidity filter (-1 = no limit)

Default: -1

max_unique_traders_24hinteger · min: -1Optional

Maximum unique traders in 24h (-1 = no limit)

Default: -1

min_volume_24hrnumber · min: -1Optional

Minimum 24h volume filter (-1 = no filter)

Default: -1

neg_riskany ofOptional

Filter by neg-risk framework (null = no filter)

booleanOptional

min_open_interestnumber · min: -1Optional

Minimum open interest filter (-1 = no filter)

Default: -1

max_open_interestnumber · min: -1Optional

Maximum open interest filter (-1 = no limit)

Default: -1

end_date_beforestring · max: 100Optional

Filter markets ending before this datetime (ISO 8601)

Default: ""Example: 2025-12-31T23:59:59Z

end_date_afterstring · max: 100Optional

Filter markets ending after this datetime (ISO 8601)

Default: ""Example: 2025-01-01T00:00:00Z

Responses

200

Event screener data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

402

Payment Required

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

502

Bad Gateway

application/json

503

Service Unavailable

application/json

504

Gateway Timeout

application/json

post/api/v1/prediction-market/event-screener

HTTPcURLJavaScriptPython

POST /api/v1/prediction-market/event-screener HTTP/1.1
Host: api.nansen.ai
apikey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 389

{
  "order_by": [
    {
      "direction": "DESC",
      "field": "volume_24hr"
    }
  ],
  "query": "bitcoin",
  "status": "active",
  "tags": [
    "Crypto",
    "Bitcoin"
  ],
  "min_liquidity": -1,
  "max_liquidity": -1,
  "max_unique_traders_24h": -1,
  "min_volume_24hr": -1,
  "neg_risk": true,
  "min_open_interest": -1,
  "max_open_interest": -1,
  "end_date_before": "2025-12-31T23:59:59Z",
  "end_date_after": "2025-01-01T00:00:00Z",
  "pagination": {
    "page": 1,
    "per_page": 10
  }
}

{
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  },
  "data": [
    {
      "event_id": "text",
      "event_title": "text",
      "tags": [
        "text"
      ],
      "neg_risk": true,
      "market_count": 1,
      "total_volume": 1,
      "total_volume_24hr": 1,
      "total_volume_1wk": 1,
      "total_volume_1mo": 1,
      "total_liquidity": 1,
      "total_open_interest": 1,
      "total_volume_change_pct": 1,
      "total_traders_24h": 1,
      "max_age_hours": 1,
      "top_market_id": "text",
      "top_market_question": "text",
      "top_market_volume_24hr": 1,
      "markets": [
        {
          "market_id": "text",
          "question": "text",
          "volume_24hr": 1,
          "open_interest": 1,
          "best_bid": 1,
          "best_ask": 1,
          "last_trade_price": 1,
          "one_day_price_change": 1,
          "volume_change_pct": 1,
          "unique_traders_24h": 1,
          "end_date": "2026-08-12T11:33:34.515Z"
        }
      ]
    }
  ]
}