Markets in this pageresult.markets | array | The collection returned in this response. Read each market independently; this page is not a complete inventory of every Polymarket market. |
|---|
Market questionresult.markets[].title | string | The question or title attached to this market. Keep it beside the outcome labels when comparing records. |
|---|
Market descriptionresult.markets[].description | string | Source description, which may include resolution conditions. An empty description supplies no additional explanation. |
|---|
Source market statusresult.markets[].status | string | Status supplied for this market. Keep it visible when reading prices and activity; a closed record is not evidence of a currently available trading opportunity. |
|---|
Market IDresult.markets[].market_id | string | Source identifier for this market, stored as a string. It is distinct from each outcome token ID and the associated event ID. |
|---|
Market slugresult.markets[].market_slug | string | Text identifier attached to this market. Keep the supplied value unchanged when referring to the record. |
|---|
Market condition IDresult.markets[].condition_id | string | Condition identifier supplied with the market. Preserve the full string rather than converting it into a number. |
|---|
Question IDresult.markets[].question_id | string | Optional source question identifier. A missing value does not invalidate the separately returned market title or identity. |
|---|
Related event IDresult.markets[].event_id | string | Optional identifier of the event associated with this market. Event and market identifiers are separate. |
|---|
Related event titleresult.markets[].event_title | string | Optional event title providing context for the market question. |
|---|
Related event slugresult.markets[].event_slug | string | Optional text identifier for the associated event. |
|---|
Named outcome optionsresult.markets[].outcomes | array | Source outcome entries with their labels and any available prices and token identifiers. Do not assume every market has exactly two Yes/No entries. |
|---|
Total market volume in USDresult.markets[].total_volume_usd | number | Source total traded volume for this market in USD. It is separate from rolling-window volume and is not venue-wide volume. |
|---|
Market liquidity in USDresult.markets[].liquidity_usd | number | Source liquidity figure for this market in USD. Preserve its value; this field is not labelled as open interest. |
|---|
Market tagsresult.markets[].tags | array | Tags supplied with the market. An empty list means no tags were returned in this response. |
|---|
Source start timeresult.markets[].start_time | string | Optional ISO 8601 market start time. This is separate from request completion and metrics computation. |
|---|
Source end timeresult.markets[].end_time | string | Optional ISO 8601 market end time. Preserve the source timezone rather than assuming it is the time the request ran. |
|---|
Source close timeresult.markets[].close_time | string | Optional ISO 8601 close time supplied for the market; it is distinct from the separate end-time field. |
|---|
Source creation timeresult.markets[].created_time | string | Optional ISO 8601 creation time attached to the market record. |
|---|
Market image linkresult.markets[].image_url | string | Image URL supplied with the market. An empty string means no image link was provided. |
|---|
Rolling activity metricsresult.markets[].rolling_metrics | object | Optional source summary over the last 24 hours, 7 days and 30 days. The supplier documents hourly refresh; use its computation timestamp to judge the returned summary. |
|---|
Outcome nameresult.markets[].outcomes[].label | string | Name attached to this outcome. Keep its price and token ID paired with this label. |
|---|
Source outcome priceresult.markets[].outcomes[].price | number | Optional price attached to the named outcome. The source model does not specify its currency or a probability conversion, or guarantee an executable quote. |
|---|
Outcome token IDresult.markets[].outcomes[].token_id | string | Optional token identifier for this outcome. Keep it as a complete string; it is distinct from the parent market ID. |
|---|
Predexon outcome IDresult.markets[].outcomes[].predexon_id | string | Optional Predexon identifier attached to this outcome. |
|---|
Traded volume over 24 hoursresult.markets[].rolling_metrics.volume_1d | number | USD volume traded over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Traded volume over 7 daysresult.markets[].rolling_metrics.volume_7d | number | USD volume traded over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Traded volume over 30 daysresult.markets[].rolling_metrics.volume_30d | number | USD volume traded over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy volume over 24 hoursresult.markets[].rolling_metrics.buy_volume_1d | number | USD buy volume over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy volume over 7 daysresult.markets[].rolling_metrics.buy_volume_7d | number | USD buy volume over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy volume over 30 daysresult.markets[].rolling_metrics.buy_volume_30d | number | USD buy volume over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell volume over 24 hoursresult.markets[].rolling_metrics.sell_volume_1d | number | USD sell volume over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell volume over 7 daysresult.markets[].rolling_metrics.sell_volume_7d | number | USD sell volume over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell volume over 30 daysresult.markets[].rolling_metrics.sell_volume_30d | number | USD sell volume over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Trade count over 24 hoursresult.markets[].rolling_metrics.trades_1d | number | Number of trades over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Trade count over 7 daysresult.markets[].rolling_metrics.trades_7d | number | Number of trades over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Trade count over 30 daysresult.markets[].rolling_metrics.trades_30d | number | Number of trades over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy count over 24 hoursresult.markets[].rolling_metrics.buys_1d | number | Number of buy trades over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy count over 7 daysresult.markets[].rolling_metrics.buys_7d | number | Number of buy trades over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Buy count over 30 daysresult.markets[].rolling_metrics.buys_30d | number | Number of buy trades over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell count over 24 hoursresult.markets[].rolling_metrics.sells_1d | number | Number of sell trades over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell count over 7 daysresult.markets[].rolling_metrics.sells_7d | number | Number of sell trades over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Sell count over 30 daysresult.markets[].rolling_metrics.sells_30d | number | Number of sell trades over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Open interest change over 24 hoursresult.markets[].rolling_metrics.oi_change_1d | number | USD change in open interest over the last 24 hours in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Open interest change over 7 daysresult.markets[].rolling_metrics.oi_change_7d | number | USD change in open interest over the last 7 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Open interest change over 30 daysresult.markets[].rolling_metrics.oi_change_30d | number | USD change in open interest over the last 30 days in the source summary. Read it with computed_at; overlapping windows are not additive. |
|---|
Metrics computation timeresult.markets[].rolling_metrics.computed_at | string | Optional ISO 8601 time when these rolling metrics were computed. Request completion does not mean the metrics were computed at that same time. |
|---|
Page informationresult.pagination | object | Source metadata describing this returned page and whether more data is indicated. It is not a total market count. |
|---|
Records in this responseresult.pagination.count | number | Number of market entries returned in this response, not the number of all matching markets. |
|---|
Source page limitresult.pagination.limit | number | Page limit reported by the source. Read it together with this response’s count; it is not the size of the complete market collection. |
|---|
More data indicatedresult.pagination.has_more | boolean | Whether the source indicates another page is available. It does not mean that an additional page was already retrieved. |
|---|
Next-page cursorresult.pagination.pagination_key | string | Optional opaque cursor supplied for another page. Preserve it unchanged; continuation is outside this default-list task. |
|---|