Polymarket Markets

Get Polymarket Markets

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

Get 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>"
  }
]

Markets fetches market data from Polymarket Gamma. The AIsa route returns the upstream Gamma response directly as a top-level JSON array of market objects.

Best for: Discovering prediction markets, filtering by slug, condition ID, CLOB token ID, dates, volume, or closed/open state.

Endpoint: GET /polymarket/markets

Example

curl -X GET "https://api.aisa.one/apis/v1/polymarket/markets?limit=5&closed=false" \
  -H "Authorization: Bearer ***"

Response

The response is a JSON array. Each item is a Polymarket Gamma market object with fields such as id, question, slug, conditionId, clobTokenIds, outcomes, outcomePrices, active, closed, volume, liquidity, bestBid, and bestAsk.

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