Skip to main content
GET
List markets
List individual Polymarket prediction markets — one binary question each — with live pricing. Use this when you need the market-implied probability of a specific outcome, or to screen markets by size and timing; filter with slug, condition_ids, clob_token_ids, tag_id, closed, and the volume_num_* / start_date_* / end_date_* ranges. Returns a top-level array of market objects. The probability signal is outcomes paired with outcomePrices, quoted against bestBid / bestAsk; conditionId and clobTokenIds are the on-chain identifiers you need to join to other Polymarket data. For the topic that groups several related questions together, use get_polymarket_events. For the same kind of question on the US-regulated Kalshi exchange, use get_kalshi_markets.
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 a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is 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/markets
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/polymarket/markets
  • ascending: query; optional
  • clob_token_ids: query; optional
  • closed: query; optional
  • condition_ids: query; optional
  • cyom: query; optional
  • end_date_max: query; optional
  • end_date_min: query; optional
  • game_id: query; optional
  • id: query; optional
  • include_tag: query; optional
  • limit: query; optional
  • liquidity_num_max: query; optional
  • liquidity_num_min: query; optional
  • offset: query; optional
  • order: query; optional
  • question_ids: query; optional
  • related_tags: query; optional
  • rewards_min_size: query; optional
  • slug: query; optional
  • sports_market_types: query; optional
  • start_date_max: query; optional
  • start_date_min: query; optional
  • tag_id: query; optional
  • uma_resolution_status: query; optional
  • volume_num_max: query; optional
  • volume_num_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

ascending
boolean
clob_token_ids
string[]
closed
boolean
default:false
condition_ids
string[]
cyom
boolean
end_date_max
string<date-time>
end_date_min
string<date-time>
game_id
string
id
integer[]
include_tag
boolean
limit
integer
Required range: x >= 0
liquidity_num_max
number
liquidity_num_min
number
offset
integer
Required range: x >= 0
order
string

Comma-separated list of fields to order by

question_ids
string[]
rewards_min_size
number
slug
string[]
sports_market_types
string[]
start_date_max
string<date-time>
start_date_min
string<date-time>
tag_id
integer
uma_resolution_status
string
volume_num_max
number
volume_num_min
number

Response

List of markets

acceptingOrders
boolean | null
acceptingOrdersTimestamp
string<date-time> | null
active
boolean | null
archived
boolean | null
automaticallyActive
boolean | null
automaticallyResolved
boolean | null
bestAsk
number | null
bestBid
number | null
categories
object[]
category
string | null
chartColor
string | null
clearBookOnStart
boolean | null
clobTokenIds
string | null
closed
boolean | null
closedTime
string | null
commentsEnabled
boolean | null
competitive
number | null
conditionId
string
createdAt
string<date-time> | null
createdBy
integer | null
creator
string | null
curationOrder
integer | null
customLiveness
integer | null
denominationToken
string | null
deploying
boolean | null
deployingTimestamp
string<date-time> | null
description
string | null
disqusThread
string | null
enableOrderBook
boolean | null
endDate
string<date-time> | null
endDateIso
string | null
eventStartTime
string<date-time> | null
events
object[]
fee
string | null
feeSchedule
object
feesEnabled
boolean | null
formatType
string | null
funded
boolean | null
fundedTimestamp
string<date-time> | null
gameId
string | null
gameStartTime
string | null
groupItemRange
string | null
groupItemThreshold
string | null
groupItemTitle
string | null
hasReviewedDates
boolean | null
icon
string | null
iconOptimized
object
id
string
image
string | null
imageOptimized
object
lastTradePrice
number | null
line
number | null
liquidity
string | null
liquidityClob
number | null
liquidityNum
number | null
lowerBound
string | null
lowerBoundDate
string | null
mailchimpTag
string | null
makerBaseFee
integer | null
manualActivation
boolean | null
marketGroup
integer | null
marketType
string | null
negRiskOther
boolean | null
new
boolean | null
notificationsEnabled
boolean | null
oneDayPriceChange
number | null
oneHourPriceChange
number | null
oneMonthPriceChange
number | null
oneWeekPriceChange
number | null
oneYearPriceChange
number | null
orderMinSize
number | null
orderPriceMinTickSize
number | null
outcomePrices
string | null
outcomes
string | null
pastSlugs
string | null
pendingDeployment
boolean | null
positionIds
string[] | null
question
string | null
questionID
string | null
ready
boolean | null
readyForCron
boolean | null
readyTimestamp
string<date-time> | null
resolutionSource
string | null
resolvedBy
string | null
restricted
boolean | null
rewardsMaxSpread
number | null
rewardsMinSize
number | null
rfqEnabled
boolean | null
scheduledDeploymentTimestamp
string<date-time> | null
score
integer | null
secondsDelay
integer | null
seriesColor
string | null
shortOutcomes
string | null
showGmpOutcome
boolean | null
showGmpSeries
boolean | null
slug
string | null
sponsorImage
string | null
sponsorName
string | null
sportsMarketType
string | null
spread
number | null
startDate
string<date-time> | null
startDateIso
string | null
tags
object[]
takerBaseFee
integer | null
teamAID
string | null
teamBID
string | null
twitterCardImage
string | null
umaBond
string | null
umaEndDate
string | null
umaEndDateIso
string | null
umaResolutionStatus
string | null
umaResolutionStatuses
string | null
umaReward
string | null
updatedAt
string<date-time> | null
updatedBy
integer | null
upperBound
string | null
upperBoundDate
string | null
version
string | null
volume
string | null
volume1mo
number | null
volume1moClob
number | null
volume1wk
number | null
volume1wkClob
number | null
volume1yr
number | null
volume1yrClob
number | null
volume24hr
number | null
volume24hrClob
number | null
volumeClob
number | null
volumeNum
number | null
wideFormat
boolean | null
xAxisValue
string | null
yAxisValue
string | null