Markets & settlements
Market search, one-market detail, and the on-chain resolution per condition.
Market search, one-market detail, and the on-chain resolution per condition.
Coverage and cadence
Cadence. Kept by the market recorder; state derived per request
Recorded markets with derived state: closed when the chain resolved the condition OR Polymarket's own feed closed it. /markets filters by slug substring and active | closed (never both), newest end_date first, limit up to 100. /markets/{condition_id} answers a market outside the recorded set from Polymarket's full market catalog; its source says which list answered. /settlements/{condition_id} is the on-chain resolution — [] means the chain resolved nothing, not that the market is open; /settlements/bulk pages every settlement oldest resolution first (filter by resolution time and slug prefix, up to 5,000 a page, next_cursor + has_more). Candles per token: /ohlcv.
Fields
| Field | Type | Description |
|---|---|---|
condition_id | string | The market, 0x-prefixed |
slug | string | URL slug |
active | integer | 1 when not closed, else 0 |
closed | integer | 1 when resolved on chain or closed by the venue |
end_date | integer | Scheduled end, epoch milliseconds |
neg_risk | integer|null | 1 for a neg-risk market; null on a catalog row |
tick_size | number|null | Price increment; null on a catalog row |
token_ids | array | One outcome token id per outcome |
How to get it
- REST —
GET /v1/polymarket/markets - REST —
GET /v1/polymarket/markets/{condition_id} - REST —
GET /v1/polymarket/settlements/{condition_id} - REST —
GET /v1/polymarket/settlements/bulk - MCP — tool
polymarket_marketsonhttps://vike.io/mcp.
Sample call
The call the dataset explorer builds:
curl -s "https://data.vike.io/v1/polymarket/markets?active=true&limit=25" \
-H "X-API-KEY: $VIKE_API_KEY"Analytics built on it
- Smart money — Markets where the smart-money cohort is net buying, and where it bought below the current mid.
- Wallet profile — One trader's lifetime volume, realized PnL, hit rate, open positions and PnL curve.
- Wallet leaderboard — Polymarket wallets ranked by realized P&L, hit rate, volume or trade count, for all time or a window, optionally within one market category; the board is rebuilt hourly.