---
title: "List live prediction markets"
method: GET
path: "/prediction/markets"
tags: ["prediction"]
---

# List live prediction markets

`GET /prediction/markets`

## Request

- Base URL: `https://kresmion.com/v1`
- URL: `https://kresmion.com/v1/prediction/markets`
- Auth: HTTP bearer

Active (unresolved, in-window) Polymarket markets, volume-ranked. Filter by category, asset class, free-text question search, and a minimum USD volume floor. Resolved markets are served separately via `/v1/prediction/resolutions`; passing `active=false` returns 400 with that pointer. Each row carries the current YES probability, 24h/7d point-change, volume, liquidity, event grouping, and the canonical Polymarket URL.

## Query parameters

- `category` string, nullable: Exact category, case-insensitive (e.g. 'crypto', 'politics').
- `active` boolean: Only active markets are served; false → 400 (see /resolutions).
- `min_volume` number: Minimum lifetime USD volume.
- `q` string, nullable: Free-text match on question / event title.
- `asset_class` string, nullable: Kresmion asset-class tag (crypto, equity, macro, forex, commodity).
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kresmion/apis/kresmion-api.md) · [All operations](https://skmtc.dev/kresmion/apis/kresmion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kresmion/apis/kresmion-api/revisions/a94962dddccb?raw)