Get Polymarket Markets

List individual Polymarket prediction markets — one binary question each — with live pricing.

GET https://api.aisa.one/apis/v1/polymarket/markets

Get Polymarket Markets

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/polymarket/markets \
  --header 'Authorization: Bearer <token>'

200

Example

[
  {
    "id": "540817",
    "question": "New Rihanna Album before GTA VI?",
    "slug": "new-rhianna-album-before-gta-vi-926",
    "conditionId": "0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be",
    "clobTokenIds": "<string>",
    "outcomes": "<string>",
    "outcomePrices": "<string>",
    "active": true,
    "closed": true,
    "liquidity": "<string>",
    "volume": "<string>",
    "volumeNum": 123,
    "bestBid": 123,
    "bestAsk": 123,
    "startDate": "2023-11-07T05:31:56Z",
    "endDate": "2023-11-07T05:31:56Z",
    "image": "<string>",
    "icon": "<string>",
    "description": "<string>"
  }
]

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.

Authorizations

Authorization · string · header · required

Your AIsa API key as a Bearer token.

Query Parameters

limit · integer

Maximum number of markets to return.

Required range: x >= 0

Example:

20

offset · integer

Number of markets to skip for offset-based pagination.

Required range: x >= 0

Example:

0

order · string

Comma-separated list of fields to order by.

Example:

"volume"

ascending · boolean

Sort ascending when true.

Example:

false

id · integer[]

Filter by one or more Polymarket market IDs.

Example:

[540817]

slug · string[]

Filter by one or more market slugs.

Example:

["new-rhianna-album-before-gta-vi-926"]

clob_token_ids · string[]

Filter by one or more CLOB token IDs.

condition_ids · string[]

Filter by one or more market condition IDs.

Example:

[
  "0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be"
]

volume_num_min · number

Minimum total volume.

Example:

1000

volume_num_max · number

Maximum total volume.

Example:

1000000

start_date_min · string<date-time>

Filter markets starting after this ISO timestamp.

Example:

"2025-01-01T00:00:00Z"

start_date_max · string<date-time>

Filter markets starting before this ISO timestamp.

Example:

"2026-01-01T00:00:00Z"

end_date_min · string<date-time>

Filter markets ending after this ISO timestamp.

Example:

"2025-01-01T00:00:00Z"

end_date_max · string<date-time>

Filter markets ending before this ISO timestamp.

Example:

"2026-01-01T00:00:00Z"

tag_id · integer

Filter by tag ID.

Example:

1

closed · boolean · default: false

Filter by whether the market is closed.

Example:

false

include_tag · boolean

Include tag metadata when true.

Example:

true

Response

200

application/json

Top-level array of Polymarket market objects

id · string

Example:

"540817"

question · string

Example:

"New Rihanna Album before GTA VI?"

slug · string

Example:

"new-rhianna-album-before-gta-vi-926"

conditionId · string

Example:

"0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be"

clobTokenIds · string string[]

Polymarket CLOB token IDs. The upstream Gamma API may encode this as a JSON string.

outcomes · string string[]

Market outcomes. The upstream Gamma API may encode this as a JSON string.

outcomePrices · string string[]

Outcome prices. The upstream Gamma API may encode this as a JSON string.

active · boolean

closed · boolean

liquidity · string

volume · string

volumeNum · number

bestBid · number

bestAsk · number

startDate · string<date-time>

endDate · string<date-time>

image · string

icon · string

description · string