> ## 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>


## 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
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

````