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

# Get Market Page by Path

> Resolves a URL path to a market page with its configuration, filters, and breadcrumb

<Info>
  Supports home page resolution via `path=/` or empty `path=`. If no Home page is configured, returns a synthetic page (id `__home__`) with an empty base filter.

  May return a `301` redirect if the path has been moved.
</Info>


## OpenAPI

````yaml GET /market-pages/by-path
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/by-path:
    get:
      tags:
        - Market Navigation
      summary: Get market page by path
      description: >-
        Resolves a URL path to a market page with its configuration, filters,
        and breadcrumb
      operationId: MarketNavigationController_byPath
      parameters:
        - name: path
          required: true
          in: query
          description: URL path to resolve (e.g., "/sports/football")
          schema:
            example: /sports/football
            type: string
      responses:
        '200':
          description: Market page resolved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketPageByPathResponseDto'
        '301':
          description: Path has been redirected to a new location
        '400':
          description: Invalid or missing path
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
        '404':
          description: Market page not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseDto'
components:
  schemas:
    MarketPageByPathResponseDto:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the market page
        name:
          type: string
          description: Display name of the market page
        slug:
          type: string
          description: URL slug of the market page
        description:
          type: string
          description: Description of the market page
          nullable: true
        fullPath:
          type: string
          description: Full URL path to this market page
        baseFilter:
          type: object
          description: Base filter configuration for the page
        filterGroups:
          description: Available filter groups for the page
          type: array
          items:
            $ref: '#/components/schemas/FilterGroupDto'
        metadata:
          type: object
          description: Additional metadata for the page
        breadcrumb:
          description: Breadcrumb trail to this page
          type: array
          items:
            $ref: '#/components/schemas/BreadcrumbItemDto'
        totalCount:
          type: number
          description: Total number of active markets on this page
      required:
        - id
        - name
        - slug
        - fullPath
        - baseFilter
        - filterGroups
        - metadata
        - breadcrumb
    ErrorResponseDto:
      type: object
      properties:
        message:
          type: string
          description: Error message
          example: Invalid order data
      required:
        - message
    FilterGroupDto:
      type: object
      properties:
        name:
          type: string
          description: Display name of the filter group
        slug:
          type: string
          description: URL slug for the filter group
        allowMultiple:
          type: boolean
          description: Whether multiple options can be selected
        presentation:
          type: string
          description: Presentation style for the filter group
        options:
          description: Available filter options
          type: array
          items:
            $ref: '#/components/schemas/FilterGroupOptionDto'
        expanded:
          type: boolean
          description: Whether the filter group is expanded by default
        tabs:
          type: object
          description: Tab configuration for sub-filtering within this filter group
    BreadcrumbItemDto:
      type: object
      properties:
        name:
          type: string
          description: Display name of the breadcrumb item
        slug:
          type: string
          description: URL slug of the breadcrumb item
        path:
          type: string
          description: Full path to this breadcrumb item
      required:
        - name
        - slug
        - path
    FilterGroupOptionDto:
      type: object
      properties:
        label:
          type: string
          description: Display label for the option
        value:
          type: string
          description: Value identifier for the option
        metadata:
          type: object
          description: Optional metadata for the option (color, icon)
        count:
          type: number
          description: Number of active markets matching this option
      required:
        - label
        - value

````