Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polymarket-data.com/llms.txt

Use this file to discover all available pages before exploring further.

client.gamma.markets.listMarkets is the powerhouse endpoint behind Polymarket’s catalogue. Filter markets by IDs, liquidity, volume, dates, tags, sports metadata, and more.

​
Request

const markets = await client.gamma.markets.listMarkets(params);

​
Parameters

NameTypeRequiredNotes
limitnumber (≥ 0)Page size.
offsetnumber (≥ 0)Page offset.
orderstringSort expression (comma-separated).
ascendingbooleanSort direction.
idnumber[]Filter by market IDs.
slugstring[]Filter by market slugs.
clob_token_idsstring[]Filter by CLOB token IDs.
condition_idsstring[]Filter by condition IDs (0x + 64 hex).
market_maker_addressstring[]Filter by AMM contract addresses.
liquidity_num_min/maxnumberLiquidity range.
volume_num_min/maxnumberVolume range.
start_date_min/maxstring (ISO)Start-date range filters.
end_date_min/maxstring (ISO)End-date range filters.
tag_idnumberFilter by tag ID.
related_tagsbooleanInclude related tags.
cyombooleanFilter Create-Your-Own markets.
uma_resolution_statusstringFilter by UMA status.
game_idstringFilter by sports game ID.
sports_market_typesstring[]Filter by sports perspectives (moneyline, spread, etc.).
rewards_min_sizenumberMinimum rewards size.
question_idsstring[]Filter by question IDs.
include_tagbooleanInclude tag metadata.
closedbooleanFilter by closed status.
ℹ️ Date formats — Provide ISO8601 strings (e.g., 2025-11-16T00:00:00Z). Strings are parsed via Date.parse and invalid values trigger validation errors.

​
Response

Market[] with hundreds of fields (title, question, outcomes, liquidity/volume metrics, tags, series references, etc.). All numeric metrics are parsed as numbers.

​
Usage example

const markets = await client.gamma.markets.listMarkets({
  closed: false,
  liquidity_num_min: 1000,
  limit: 10,
});

console.log(markets.map((market) => market.title ?? market.slug));

​
Failure modes

  • Invalid dates or malformed IDs → validation errors with detailed paths.