Skip to main content
GET
List events
List Polymarket events — the topic-level grouping that bundles related markets, such as an election or a season-long series. Use this to browse by subject rather than by individual question, or to find every market attached to one storyline; filter with tag_slug, active, featured, archived, closed, and the liquidity / volume ranges. Returns a top-level array of event objects with title, ticker, slug, volume, volume24hr, liquidity, startDate / endDate, and a nested markets array holding the tradable questions. When you already know which question you want and need its price, use get_polymarket_markets instead.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: search, list_categories and get_details are free, use and batch_use are billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: GET /apis/v1/polymarket/events
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/polymarket/events
  • active: query; optional
  • archived: query; optional
  • ascending: query; optional
  • closed: query; optional
  • cyom: query; optional
  • end_date_max: query; optional
  • end_date_min: query; optional
  • exclude_tag_id: query; optional
  • featured: query; optional
  • id: query; optional
  • include_chat: query; optional
  • include_template: query; optional
  • limit: query; optional
  • liquidity_max: query; optional
  • liquidity_min: query; optional
  • offset: query; optional
  • order: query; optional
  • recurrence: query; optional
  • related_tags: query; optional
  • slug: query; optional
  • start_date_max: query; optional
  • start_date_min: query; optional
  • tag_id: query; optional
  • tag_slug: query; optional
  • volume_max: query; optional
  • volume_min: query; optional
  • Runtime facts: ea4652f81dbb5117d54b401f31ded482c22f2b01ffbbe2fd118a5364d8f766d4
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.00044 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.00044
  • Cost contract: fixed_success
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

active
boolean
archived
boolean
ascending
boolean
closed
boolean
cyom
boolean
end_date_max
string<date-time>
end_date_min
string<date-time>
exclude_tag_id
integer[]
id
integer[]
include_chat
boolean
include_template
boolean
limit
integer
Required range: x >= 0
liquidity_max
number
liquidity_min
number
offset
integer
Required range: x >= 0
order
string

Comma-separated list of fields to order by

recurrence
string
slug
string[]
start_date_max
string<date-time>
start_date_min
string<date-time>
tag_id
integer
tag_slug
string
volume_max
number
volume_min
number

Response

List of events

id
string
ticker
string | null
slug
string | null
title
string | null
subtitle
string | null
description
string | null
resolutionSource
string | null
startDate
string<date-time> | null
creationDate
string<date-time> | null
endDate
string<date-time> | null
image
string | null
icon
string | null
active
boolean | null
closed
boolean | null
archived
boolean | null
new
boolean | null
restricted
boolean | null
liquidity
number | null
volume
number | null
openInterest
number | null
sortBy
string | null
category
string | null
subcategory
string | null
isTemplate
boolean | null
templateVariables
string | null
published_at
string | null
createdBy
string | null
updatedBy
string | null
createdAt
string<date-time> | null
updatedAt
string<date-time> | null
commentsEnabled
boolean | null
competitive
number | null
volume24hr
number | null
volume1wk
number | null
volume1mo
number | null
volume1yr
number | null
disqusThread
string | null
parentEvent
string | null
enableOrderBook
boolean | null
liquidityClob
number | null
negRisk
boolean | null
negRiskMarketID
string | null
negRiskFeeBips
integer | null
commentCount
integer | null
imageOptimized
object
iconOptimized
object
subEvents
string[] | null
markets
object[]
series
object[]
categories
object[]
collections
object[]
tags
object[]
cyom
boolean | null
closedTime
string<date-time> | null
showAllOutcomes
boolean | null
showMarketImages
boolean | null
automaticallyResolved
boolean | null
enableNegRisk
boolean | null
automaticallyActive
boolean | null
eventDate
string | null
startTime
string<date-time> | null
eventWeek
integer | null
seriesSlug
string | null
score
string | null
elapsed
string | null
period
string | null
live
boolean | null
ended
boolean | null
finishedTimestamp
string<date-time> | null
gmpChartMode
string | null
eventCreators
object[]
tweetCount
integer | null
chats
object[]
estimateValue
boolean | null
cantEstimate
boolean | null
estimatedValue
string | null
templates
object[]
spreadsMainLine
number | null
totalsMainLine
number | null
pendingDeployment
boolean | null
deploying
boolean | null
deployingTimestamp
string<date-time> | null
scheduledDeploymentTimestamp
string<date-time> | null
gameStatus
string | null