Polymarket
Prediction-market discovery and market data.
Get Polymarket 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.
- Тип: integerlimitмин.:0
Maximum number of markets to return.
- Тип: integeroffsetмин.:0
Number of markets to skip for offset-based pagination.
- Тип: stringorder
Comma-separated list of fields to order by.
- Тип: booleanascending
Sort ascending when true.
- Тип: array integer[]id
Filter by one or more Polymarket market IDs.
- Тип: array string[]slug
Filter by one or more market slugs.
- Тип: array string[]clob
_token _ids Filter by one or more CLOB token IDs.
- Тип: array string[]condition
_ids Filter by one or more market condition IDs.
- Тип: numbervolume
_num _min Minimum total volume.
- Тип: numbervolume
_num _max Maximum total volume.
- Тип: string Формат: date-timestart
_date _min Filter markets starting after this ISO timestamp.
- Тип: string Формат: date-timestart
_date _max Filter markets starting before this ISO timestamp.
- Тип: string Формат: date-timeend
_date _min Filter markets ending after this ISO timestamp.
- Тип: string Формат: date-timeend
_date _max Filter markets ending before this ISO timestamp.
- Тип: integertag
_id Filter by tag ID.
- Тип: booleanclosed
Filter by whether the market is closed.
- Тип: booleaninclude
_tag Include tag metadata when true.
- Тип: array object[]200
Top-level array of Polymarket market objects
- activeТип: boolean
- bestТип: number
Ask - bestТип: number
Bid - clob
Token Ids Polymarket CLOB token IDs. The upstream Gamma API may encode this as a JSON string.
- Тип: string
Polymarket CLOB token IDs. The upstream Gamma API may encode this as a JSON string.
- closedТип: boolean
- conditionТип: string
Id - descriptionТип: string
- endТип: string Формат: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- iconТип: string
- idТип: string
- imageТип: string
- liquidityТип: string
- outcome
Prices Outcome prices. The upstream Gamma API may encode this as a JSON string.
- Тип: string
Outcome prices. The upstream Gamma API may encode this as a JSON string.
- outcomes
Market outcomes. The upstream Gamma API may encode this as a JSON string.
- Тип: string
Market outcomes. The upstream Gamma API may encode this as a JSON string.
- questionТип: string
- slugТип: string
- startТип: string Формат: date-time
Date the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z
- volumeТип: string
- volumeТип: number
Num - propertyТип: anything
Name
application/json - Тип: object400
Bad Request - Invalid parameters or validation errors
- Тип: stringerror
- Тип: stringmessage
application/json - 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- Тип: object500
Internal Server Error
- Тип: stringerror
- Тип: stringmessage
application/json - 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/polymarket/markets \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
[
{
"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": 1,
"bestBid": 1,
"bestAsk": 1,
"startDate": "2026-09-30T03:09:45.799Z",
"endDate": "2026-09-30T03:09:45.799Z",
"image": "string",
"icon": "string",
"description": "string",
"additionalProperty": "anything"
}
]