---
title: "List Polymarket markets"
method: GET
path: "/polymarket/markets"
tags: ["Polymarket"]
---

# List Polymarket markets

`GET /polymarket/markets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/polymarket/markets`
- Auth: API key in header `x-api-key`

Lists Polymarket markets, up to `limit` rows (default 25, max 100), starting at `offset` (default 0, max 10000). Sort with `order`, such as `volume24hr` or `liquidity`, flip direction with `ascending`, and filter with `closed`. Each market has its question, slug, prices, volume, liquidity, token ids and outcomes.

## Query parameters

- `limit` integer
- `offset` integer
- `order` 'volume24hr' | 'volume' | 'liquidity' | 'endDate' | 'updatedAt' | 'createdAt' | 'id' | 'slug' | 'title' | 'question' | 'label'
- `ascending` boolean
- `closed` 'true' | 'false'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- PolymarketMarketsResponseDoc
  - `code` integer
  - `data` PolymarketMarketsResponse
    - `ascending` boolean: `true` when markets are sorted in ascending order.
    - `closed` string: Closed filter applied, `true` or `false`.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Maximum number of markets requested.
    - `markets` PolymarketMarketSummary[]: Markets on this page, one item per market.
      - `active` boolean: `true` when the market is active.
      - `best_ask` number: Lowest ask price currently offered on the market.
      - `best_bid` number: Highest bid price currently offered on the market.
      - `closed` boolean: `true` when the market is closed.
      - `condition_id` string: Condition id that identifies the market on Polymarket.
      - `end_date` string: Date and time the market is scheduled to end (ISO 8601).
      - `id` string: Polymarket market id.
      - `last_trade_price` number: Price of the most recent trade on the market.
      - `liquidity` number: Liquidity Polymarket reports for the market.
      - `outcomes` PolymarketOutcomePricePoint[]: Outcomes of the market with their current prices, one item per outcome.
        - `best_ask` number: Lowest ask price currently offered for the outcome.
        - `best_bid` number: Highest bid price currently offered for the outcome.
        - `last_trade_price` number: Price of the most recent trade on the outcome.
        - `liquidity` number: Liquidity Polymarket reports for the outcome.
        - `market_id` string: Polymarket id of the market the outcome belongs to.
        - `market_slug` string: URL slug of the market the outcome belongs to.
        - `outcome` string: Name of the outcome, for example `Yes`.
        - `price` number: Current price of the outcome.
        - `question` string: Question of the market the outcome belongs to.
        - `volume` number: Trading volume Polymarket reports for the outcome.
      - `question` string: Question the market asks, for example `Will Spain win the 2026 FIFA World Cup?`.
      - `slug` string: URL slug of the market.
      - `token_ids` string[]: Token ids of the market outcomes, in the same order as `outcomes`.
      - `url` string: Link to the market on polymarket.com.
      - `volume` number: Total trading volume of the market.
      - `volume_24h` number: Trading volume of the market over the last 24 hours.
    - `offset` integer: Number of markets skipped before this page.
    - `order` string: Field the markets are sorted by, for example `volume24hr`.
    - `source_url` string: URL the data was read from.
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)