--- title: "Get Markets" method: GET path: "/v1/markets" tags: ["Markets"] --- # Get Markets `GET /v1/markets` Retrieve all markets ## Query parameters - `limit` integer - `offset` integer - `orderBy` string[] - `orderDirection` string - `id` integer[] - `slug` string[] - `archived` boolean - `active` boolean - `closed` boolean - `volumeNumMin` number, double - `volumeNumMax` number, double - `startDateMin` string - `startDateMax` string - `endDateMin` string - `endDateMax` string - `relatedTags` boolean - `gameId` string - `sportsMarketTypes` string[] - `includeTag` boolean - `categories` string[] - `marketTypes` string[] - `includeHidden` boolean - `tagIds` integer[] ## Response `200` List of markets - GatewayMarketV1GetMarketsResponse — Response containing list of markets - `markets` GatewayMarketV1Market[] — List of markets - `id` string — Unique market identifier - `question` string, nullable — Market question - `slug` string, nullable — Market slug for URL - `endDate` string, nullable — Market end date - `category` string, nullable — Market category - `startDate` string, nullable — Market start date - `image` string, nullable — Market image URL - `description` string, nullable — Market description - `active` boolean, nullable — Whether market is active - `marketType` string, nullable — Type of market (deprecated). Options: moneyline, spreads, totals - `closed` boolean, nullable — Whether market is closed - `createdAt` string, nullable — Creation timestamp - `updatedAt` string, nullable — Last update timestamp - `archived` boolean, nullable — Whether market is archived - `orderPriceMinTickSize` number, nullable — Minimum tick size for order price - `gameStartTime` string, nullable — Game start time - `manualActivation` boolean, nullable — Whether manual activation is required - `sportsMarketType` string, nullable — Sports market type - `line` number, nullable — Line value - `marketSides` GatewayMarketV1MarketSide[] — Market sides - `id` string — Market side ID - `marketSideType` 'MARKET_SIDE_TYPE_ERC1155' | 'MARKET_SIDE_TYPE_INSTRUMENT' - `identifier` string, nullable — Market side identifier - `createdAt` string, nullable — Creation timestamp - `updatedAt` string, nullable — Last update timestamp - `description` string, nullable — Market side description - `price` string, nullable — Market side price - `marketId` integer — Market ID - `long` boolean, nullable — Whether market side is the long or short side of the market - `teamId` integer, nullable — Team ID - `team` GatewayMarketV1Team - `id` integer - `name` string - `abbreviation` string - `league` string - `record` string - `logo` string - `alias` string - `safeName` string - `homeIcon` string, nullable - `awayIcon` string, nullable - `colorPrimary` string, nullable - `providerId` integer, nullable - `ordering` string, nullable - `longIcon` string, nullable - `shortIcon` string, nullable - `displayAbbreviation` string, nullable - `ranking` string, int64, nullable - `conference` string, nullable - `providerIds` GatewayMarketV1SportsTeamProvider[] - `provider` 'PROVIDER_SPORTSDATAIO' | 'PROVIDER_SPORTRADAR' | 'PROVIDER_OPTICODDS' | 'PROVIDER_PANDASCORE' | 'PROVIDER_INFRONT' | 'PROVIDER_ENETPULSE' | 'PROVIDER_UFC' - `providerId` string — The provider id - `longIconDark` string, nullable - `shortIconDark` string, nullable - `color` GatewayMarketV1ResolvedColor - `light` string — Hex color for light mode - `dark` string — Hex color for dark mode - `quote` GatewayTypesV1Amount — Represents a monetary amount with its currency. - `value` string, decimal, required — The amount as a decimal string. - `currency` string, required — The currency code - `tradable` boolean, nullable — Whether this side can be traded - `outcomes` string, nullable — Outcomes JSON - `outcomePrices` string, nullable — Outcome prices JSON - `ep3Status` string, nullable — EP3 status - `sportsMarketTypeV2` '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' - `hidden` boolean, nullable — Whether market is hidden - `tags` GatewayTagsV1Tag[] — Associated tags - `id` string — Unique tag identifier - `label` string, nullable — Tag label - `slug` string, nullable — Tag slug for URL - `createdAt` string, nullable — Creation timestamp - `updatedAt` string, nullable — Last update timestamp - `image` string, nullable — Tag image URL - `tradable` boolean, nullable — Whether the tag is tradable - `league` GatewayTagsV1TagLeague - `id` integer - `name` string - `sportId` integer - `tagId` integer, nullable - `image` string, nullable - `resolution` string, nullable - `ordering` string, nullable - `activeSeriesId` integer, nullable - `isOperational` boolean, nullable - `automaticResolution` boolean, nullable - `createdAt` string, nullable - `slug` string - `abbreviation` string, nullable - `sport` GatewayTagsV1TagSport - `id` integer - `name` string - `tagId` integer, nullable - `createdAt` string, nullable - `slug` string - `image` string, nullable - `parentId` integer, nullable — Parent tag ID - `subtags` object[] — Child subtags - `title` string, nullable — Market title - `subtitle` string, nullable — Market subtitle - `color` string, nullable — Market color - `darkColor` string, nullable — Market dark mode color - `subjectId` integer, nullable — Subject ID - `subject` GatewayMarketV1Subject — Subject information - `id` integer — Subject ID - `name` string — Subject name - `displayName` string, nullable — Subject display name - `description` string, nullable — Subject description - `subjectType` string — Subject type (nominee, player, team, candidate, golf_player) - `image` string, nullable — Subject image URL - `color` string, nullable — Subject color - `darkColor` string, nullable — Subject dark mode color - `createdAt` string, nullable — Creation timestamp - `updatedAt` string, nullable — Last update timestamp - `slug` string, nullable — Subject slug for URL - `feeCoefficient` number, nullable — Fee coefficient - `spreadTotalSuffix` string, nullable — Spread/total suffix for UI display (e.g. points, goals, runs) - `sortOrder` integer, nullable — Sort order for market within event - `bestBidQuote` GatewayTypesV1Amount — Represents a monetary amount with its currency. - `value` string, decimal, required — The amount as a decimal string. - `currency` string, required — The currency code - `bestAskQuote` GatewayTypesV1Amount — Represents a monetary amount with its currency. - `value` string, decimal, required — The amount as a decimal string. - `currency` string, required — The currency code - `metadata` object, nullable — Opaque metadata object — internal-use only, shape is not part of the public contract - `titleShort` string, nullable — Compact display title computed at serialization time (e.g. 'DET -5.5 F5', 'Over 5.5 F5'). Falls back to title. - `ep3SyncedAt` string, nullable — Timestamp when this market was last synced from EP3 - `minimumTradeQty` number, nullable — Minimum order quantity in contracts (e.g. 0.01 = 1% of a contract, 1.0 = one whole contract). - `volume` number, nullable — Market volume (lifetime, in shares) - `volume24hr` number, nullable — 24-hour market volume (in shares) - `volume1wk` number, nullable — One week market volume (in shares) - `volume1mo` number, nullable — One month market volume (in shares) - `volume1yr` number, nullable — One year market volume (in shares) - `rulesDisclaimer` string, nullable — Short 'understanding the rules' disclaimer for this market type, computed at serialization time. Omitted when the market's sports_market_type has no disclaimer. ## Other responses - `500` — Internal server error --- [API](https://skmtc.net/polymarket/apis/portfolio-api.md) · [All operations](https://skmtc.net/polymarket/apis/portfolio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/portfolio-api/revisions/150874842db1/schema)