> ## Documentation Index
> Fetch the complete documentation index at: https://docs.limitless.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# List Markets for a Page

> Returns paginated list of markets for a specific market page with filtering and sorting

<Info>
  The `id` parameter can be `__home__` to list all markets when Home is not explicitly configured.

  Supports both **offset pagination** (`page` + `limit`) and **cursor pagination** (`cursor`). When `cursor` is present, offset pagination is ignored.

  Sorting: prefix field with `-` for descending (e.g., `-updatedAt`). Allowed fields: `createdAt`, `updatedAt`, `deadline`, `id`.
</Info>

<Note>
  **`includeNextMarket` (optional).** Pass `includeNextMarket=true` to attach the next round of upfront-scheduled markets to each affected result:

  ```json theme={null}
  "navigation": {
    "nextMarket": { "slug": "...", "startAt": "...", "deadline": "...", "tradable": false }
  }
  ```

  Use this to prefetch or subscribe to the successor before the current round expires. During the short activation gap between rounds, the expired predecessor stays in the list so the series is represented by exactly one row at all times.

  Cursor tokens embed this option — do not toggle `includeNextMarket` mid-pagination. The `tradable` flag is conservative in listings; fetch the successor directly with [Get Market](/api-reference/markets/get-market) before trading.
</Note>


## OpenAPI

````yaml GET /market-pages/{id}/markets
openapi: 3.0.0
info:
  title: Limitless Exchange API
  description: >-
    Production-ready REST API for prediction market trading, portfolio
    management, and market data on Limitless Exchange (Base L2).
  version: '1.0'
  contact:
    name: API Support
    url: https://limitless.exchange
    email: help@limitless.network
servers:
  - url: https://api.limitless.exchange
    description: Production API
security: []
tags:
  - name: Authentication
    description: User authentication and session management
  - name: Markets
    description: Browse, search, and analyze prediction markets
  - name: Market Navigation
    description: Navigation tree, market pages, and property filters
  - name: Trading
    description: Create, manage, and cancel orders
  - name: Portfolio
    description: Position tracking, trade history, and performance
  - name: API Tokens
    description: Scoped API token management for partner integrations
  - name: Partner Accounts
    description: Sub-account creation and allowance recovery for partner integrations
  - name: System
    description: Public API state and availability information
  - name: Referral
    description: Referral program earnings, referred users, and leaderboards
  - name: Leaderboard
    description: >-
      Live Unrealized PnL leaderboards for open markets and biggest open
      positions
paths:
  /market-pages/{id}/markets:
    get:
      tags:
        - Market Navigation
      summary: List markets for a page
      description: >-
        Returns paginated list of markets for a specific market page with
        filtering and sorting
      operationId: MarketNavigationController_listMarkets
      parameters:
        - name: id
          required: true
          in: path
          description: Market page ID
          schema:
            example: 123e4567-e89b-12d3-a456-426614174000
            type: string
        - name: cursor
          required: false
          in: query
          description: Cursor token for cursor-based pagination (cannot be used with page)
          schema: {}
        - name: sort
          required: false
          in: query
          description: >-
            Sort field with optional - prefix for descending (e.g., -updatedAt,
            createdAt, deadline)
          schema:
            example: '-updatedAt'
        - name: limit
          required: false
          in: query
          description: Number of items per page (max 100)
          schema:
            example: 20
        - name: page
          required: false
          in: query
          description: Page number for offset pagination (cannot be used with cursor)
          schema:
            example: 1
      responses:
        '200':
          description: Markets retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMarketsResponseDto'
        '400':
          description: Invalid parameters or pagination mode conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
components:
  schemas:
    ListMarketsResponseDto:
      type: object
      properties:
        data:
          description: Array of market/group data
          type: array
          items:
            type: string
        cursor:
          description: Cursor pagination info (when using cursor parameter)
          allOf:
            - $ref: '#/components/schemas/CursorPaginationDto'
        pagination:
          description: Offset pagination info (when using page parameter)
          allOf:
            - $ref: '#/components/schemas/OffsetPaginationDto'
        counts:
          type: object
          description: Counts per tab option for the active filter context
          example:
            matches: 45
            props: 3
      required:
        - data
    ErrorResponseDto:
      type: object
      properties:
        message:
          type: string
          description: Error message
          example: Invalid order data
      required:
        - message
    CursorPaginationDto:
      type: object
      properties:
        nextCursor:
          type: string
          description: Cursor for the next page of results
          nullable: true
    OffsetPaginationDto:
      type: object
      properties:
        page:
          type: number
          description: Current page number
        limit:
          type: number
          description: Number of items per page
        total:
          type: number
          description: Total number of items
        totalPages:
          type: number
          description: Total number of pages
      required:
        - page
        - limit
        - total
        - totalPages

````