Skip to main content
GET
/
api
/
v1
/
polymarket
/
market
/
list
List Polymarket Markets
curl --request GET \
  --url https://api.entityml.com/api/v1/polymarket/market/list \
  --header 'Authorization: <authorization>'
{
  "total_markets": 123,
  "returned_count": 123,
  "filter_prefix": "<string>",
  "market_condition_ids": [
    {}
  ],
  "pagination": {}
}

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer YOUR_API_KEY

​
Query Parameters

​
prefix
string
Optional condition ID prefix filter. Values are accepted with or without the 0x prefix. Example: 0x8213.
​
offset
integer
Number of markets to skip. Default: 0.
​
limit
integer
Maximum number of markets to return. Default: 100. Max: 1000.

​
Response

​
total_markets
integer
Total number of stored Polymarket markets after applying the optional prefix filter.
​
returned_count
integer
Number of market IDs returned in this page.
​
filter_prefix
string
The normalized prefix filter that was applied, if any.
​
market_condition_ids
array
Array of stored Polymarket market condition IDs.
​
pagination
object
Standard pagination metadata with offset, limit, total_count, and has_more.
Each successful call to this endpoint counts as 1 API request.

​
Example

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.entityml.com/api/v1/polymarket/market/list?prefix=0x8213&offset=0&limit=5"

​
Example response

{
  "total_markets": 1,
  "returned_count": 1,
  "filter_prefix": "0x8213",
  "market_condition_ids": [
    "0x8213d395e079614d6c4d7f4cbb9be9337ab51648a21cc2a334ae8f1966d164b4"
  ],
  "pagination": {
    "offset": 0,
    "limit": 5,
    "total_count": 1,
    "has_more": false
  }
}