Polymarket
Complete public data for Polymarket prediction markets: discover events and markets, live odds and full order books, historical price candles, recent trades, top holders, comments, resolution state, and any wallet's positions, activity and PnL. One consistent schema — no juggling Gamma, CLOB and Data API hosts, token IDs or pagination quirks. Public market data only; this API does not place or cancel orders. Identify markets by human `slug` (from the Polymarket URL). Price endpoints use the outcome `token_id` returned by `Get Market Details`. Wallet endpoints take a Polygon address. Unknown slugs, markets, and wallets return HTTP 404. Invalid parameters return HTTP 400.
Version: 1.0.0•Category: Finance
GET /api/events/list
Returns a page of events with title, slug, volume, liquidity, start/end dates and nested markets. Filter by active/closed state, tag or volume. Use Get Event Details for a single event by slug.
Parameters
active
BOOLEAN
If true, only currently active events. Default true.
closed
BOOLEAN
If true, only resolved/closed events. Default false.
tag
STRING
Filter by tag slug, e.g. politics, crypto, sports, pop-culture.
order
ENUM
Sort field. One of volume, liquidity, start_date, end_date, competitive. Default volume.
ascending
BOOLEAN
Sort direction. Default false (highest first).
limit
NUMBER
Results per page, 1-100. Default 20.
offset
NUMBER
Number of results to skip. Default 0.
Code Examples
Language:
Client:
fetch('https://api.apivex.com/polymarket/api/events/list?active=True&order=volume&limit=20', {
method: 'GET',
headers: {
'x-apivex-key': 'YOUR_API_KEY'
}
})
.then(response => response.json())
.then(data => console.log(data));Responses
200
Successful response