Get Markets
curl --request GET \
--url https://gateway.polymarket.us/v1/markets{
"markets": [
{
"id": "<string>",
"question": "<string>",
"slug": "<string>",
"endDate": "<string>",
"category": "<string>",
"startDate": "<string>",
"image": "<string>",
"description": "<string>",
"active": true,
"marketType": "<string>",
"closed": true,
"createdAt": "<string>",
"updatedAt": "<string>",
"archived": true,
"orderPriceMinTickSize": 123,
"gameStartTime": "<string>",
"bestBid": 123,
"bestAsk": 123,
"manualActivation": true,
"sportsMarketType": "<string>",
"line": 123,
"marketSides": [
{
"id": "<string>",
"identifier": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"description": "<string>",
"price": "<string>",
"marketId": 123,
"long": true,
"teamId": 123,
"team": {
"id": 123,
"name": "<string>",
"abbreviation": "<string>",
"league": "<string>",
"record": "<string>",
"logo": "<string>",
"alias": "<string>",
"safeName": "<string>",
"homeIcon": "<string>",
"awayIcon": "<string>",
"colorPrimary": "<string>",
"providerId": 123,
"ordering": "<string>",
"longIcon": "<string>",
"shortIcon": "<string>",
"displayAbbreviation": "<string>",
"ranking": "<string>",
"conference": "<string>",
"providerIds": [
{
"providerId": "<string>"
}
],
"longIconDark": "<string>",
"shortIconDark": "<string>"
},
"participantId": "<string>"
}
],
"outcomes": "<string>",
"outcomePrices": "<string>",
"ep3Status": "<string>",
"hidden": true,
"tags": [
{
"id": "<string>",
"label": "<string>",
"slug": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"image": "<string>",
"tradable": true,
"league": {
"id": 123,
"name": "<string>",
"sportId": 123,
"tagId": 123,
"image": "<string>",
"resolution": "<string>",
"ordering": "<string>",
"activeSeriesId": 123,
"isOperational": true,
"automaticResolution": true,
"createdAt": "<string>",
"slug": "<string>",
"abbreviation": "<string>"
},
"sport": {
"id": 123,
"name": "<string>",
"tagId": 123,
"createdAt": "<string>",
"slug": "<string>",
"image": "<string>"
},
"parentId": 123,
"subtags": [
{}
]
}
],
"title": "<string>",
"subtitle": "<string>",
"color": "<string>",
"darkColor": "<string>",
"subjectId": 123,
"subject": {
"id": 123,
"name": "<string>",
"displayName": "<string>",
"description": "<string>",
"subjectType": "<string>",
"image": "<string>",
"color": "<string>",
"darkColor": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"slug": "<string>"
},
"feeCoefficient": 123,
"spreadTotalSuffix": "<string>",
"minimumTradeQty": 123
}
]
}Get Markets
Retrieve all markets
GET
/
v1
/
markets
Get Markets
curl --request GET \
--url https://gateway.polymarket.us/v1/markets{
"markets": [
{
"id": "<string>",
"question": "<string>",
"slug": "<string>",
"endDate": "<string>",
"category": "<string>",
"startDate": "<string>",
"image": "<string>",
"description": "<string>",
"active": true,
"marketType": "<string>",
"closed": true,
"createdAt": "<string>",
"updatedAt": "<string>",
"archived": true,
"orderPriceMinTickSize": 123,
"gameStartTime": "<string>",
"bestBid": 123,
"bestAsk": 123,
"manualActivation": true,
"sportsMarketType": "<string>",
"line": 123,
"marketSides": [
{
"id": "<string>",
"identifier": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"description": "<string>",
"price": "<string>",
"marketId": 123,
"long": true,
"teamId": 123,
"team": {
"id": 123,
"name": "<string>",
"abbreviation": "<string>",
"league": "<string>",
"record": "<string>",
"logo": "<string>",
"alias": "<string>",
"safeName": "<string>",
"homeIcon": "<string>",
"awayIcon": "<string>",
"colorPrimary": "<string>",
"providerId": 123,
"ordering": "<string>",
"longIcon": "<string>",
"shortIcon": "<string>",
"displayAbbreviation": "<string>",
"ranking": "<string>",
"conference": "<string>",
"providerIds": [
{
"providerId": "<string>"
}
],
"longIconDark": "<string>",
"shortIconDark": "<string>"
},
"participantId": "<string>"
}
],
"outcomes": "<string>",
"outcomePrices": "<string>",
"ep3Status": "<string>",
"hidden": true,
"tags": [
{
"id": "<string>",
"label": "<string>",
"slug": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"image": "<string>",
"tradable": true,
"league": {
"id": 123,
"name": "<string>",
"sportId": 123,
"tagId": 123,
"image": "<string>",
"resolution": "<string>",
"ordering": "<string>",
"activeSeriesId": 123,
"isOperational": true,
"automaticResolution": true,
"createdAt": "<string>",
"slug": "<string>",
"abbreviation": "<string>"
},
"sport": {
"id": 123,
"name": "<string>",
"tagId": 123,
"createdAt": "<string>",
"slug": "<string>",
"image": "<string>"
},
"parentId": 123,
"subtags": [
{}
]
}
],
"title": "<string>",
"subtitle": "<string>",
"color": "<string>",
"darkColor": "<string>",
"subjectId": 123,
"subject": {
"id": 123,
"name": "<string>",
"displayName": "<string>",
"description": "<string>",
"subjectType": "<string>",
"image": "<string>",
"color": "<string>",
"darkColor": "<string>",
"createdAt": "<string>",
"updatedAt": "<string>",
"slug": "<string>"
},
"feeCoefficient": 123,
"spreadTotalSuffix": "<string>",
"minimumTradeQty": 123
}
]
}Query Parameters
Page size
Page offset
Order by fields
Order direction
Market IDs
Market slugs
Whether market is archived
Whether market is active
Whether market is closed
Minimum volume number
Maximum volume number
Minimum start date
Maximum start date
Minimum end date
Maximum end date
Whether related tags are enabled
Game ID
Sports market types
Available options:
SPORTS_MARKET_TYPE_MONEYLINE, SPORTS_MARKET_TYPE_SPREAD, SPORTS_MARKET_TYPE_TOTAL, SPORTS_MARKET_TYPE_PROP, SPORTS_MARKET_TYPE_FUTURE, SPORTS_MARKET_TYPE_DRAWABLE_OUTCOME Whether to include tag
Categories
Market types
Include hidden markets (default: false)
Tag IDs
Response
List of markets
Response containing list of markets
List of markets
Show child attributes
Show child attributes
⌘I