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

> Retrieves market or group data using either an Ethereum address or a slug identifier

<Tip>
  This endpoint returns **venue data** (`venue.exchange` and `venue.adapter`) needed for [EIP-712 order signing](/developers/eip712-signing). Fetch once per market and cache — venue data is static.
</Tip>

<Info>
  **Outcome index convention.** On a resolved market the response carries `winningOutcomeIndex`, an index into the fixed `outcomeTokens: ['Yes', 'No']` array:

  * `winningOutcomeIndex: 0` — **YES** resolved
  * `winningOutcomeIndex: 1` — **NO** resolved
  * `null` — not yet resolved

  The same mapping applies anywhere this field appears (portfolio positions, feed events). For negrisk groups, the winning index lives on the individual sub-market that resolved YES, not on the group object.
</Info>

<Note>
  **Mapping `tokens.yes` / `tokens.no` to human outcome labels.** Every individual market's token pair is always `YES` / `NO` in the API — there is no per-token label field for custom outcomes like "Up" / "Down" or "Norway" / "England". The mapping to a human label depends on the market type:

  * **Binary single market** (e.g. "Will ETH close above \$3,000?"): `tokens.yes` = the question resolves true, `tokens.no` = the question resolves false. The market's `title` / `proxyTitle` carries the semantic meaning.
  * **Directional AMM market** (e.g. "BTC Up or Down - 5 Min"): each direction is a separate individual market. `tokens.yes` on the "Up" market = betting on Up; `tokens.no` on the same market = the opposite side of that bet. To find the "Down" side, fetch the sibling market from the group.
  * **Negrisk group market** (e.g. "Norway vs England: team to advance?"): the group response returns `outcomeTokens: string[]` (for example `["Norway", "England"]`) and `markets[]`, one submarket per outcome. To trade a specific outcome, call `getMarket()` on that submarket's slug and use its `tokens.yes` — that YES token represents "this outcome resolves true". See the [Negrisk overview](/user-guide/negrisk-overview) and the TypeScript [Negrisk group markets](/developers/sdk/typescript/markets#negrisk-group-markets) walkthrough.

  There is no separate `tokens.up` / `tokens.down` field — always resolve labels from the group's `outcomeTokens` array or from the submarket `title` / `proxyTitle`.
</Note>

<Note>
  **Market volume.** The response includes lifetime trading volume in the `volume` field (raw, base units) and `volumeFormatted` (human-readable USDC). The API does not expose a rolling 24-hour volume field; for time-windowed activity, derive it client-side from [Get Feed Events](/api-reference/markets/feed-events) (filter trade events by timestamp).
</Note>

<Note>
  **Market `status` values.** The response's `status` field is one of:

  * `FUNDED` — the market is live and accepting trades. The default for active markets.
  * `LOCKED` — trading is paused on the market: orders cannot be placed or filled, but existing positions remain. A market typically enters `LOCKED` shortly before resolution (after the deadline, while the winning outcome is being determined) or when an operator manually halts it. The market resumes as `FUNDED` if unlocked, or transitions to `RESOLVED` once the outcome is set.
  * `RESOLVED` — the winning outcome is known. `winningOutcomeIndex` is populated and winners can redeem their CTF positions. See [Lifecycle after a trade](/developers/programmatic-api#lifecycle-after-a-trade).
  * `FUNDED_FLAGGED` — the market is live but flagged for review (for example, pending resolution clarification). Treat it as `FUNDED` for trading purposes unless your integration wants to surface the flag to users.
  * `DRAFT` — the market exists but has not been funded yet and is not tradeable.

  Treat any unrecognized future value defensively rather than assuming the market is tradeable.
</Note>

<Note>
  **Taker delay.** A CLOB market's `settings` object carries `takerDelayMs` — the market's taker delay in milliseconds (`0` = none, the default). When it is greater than `0`, marketable (taker) orders on this market are briefly held before the matching engine fills them and order submission becomes asynchronous (the create-order response returns `settlementStatus: "DELAYED"` with an `eligibleAt`; track the fill over [`subscribe_order_events`](/developers/websocket-events#subscribing-to-order-events)). Read `settings.takerDelayMs` to detect delay-enabled markets before placing taker orders. `postOnly` (maker) orders are never delayed.
</Note>


## OpenAPI

````yaml GET /markets/{addressOrSlug}
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:
  /markets/{addressOrSlug}:
    get:
      tags:
        - Markets
      summary: Get Market Details
      description: >-
        Retrieves market or group data using either an Ethereum address or a
        slug identifier
      operationId: MarketController_find
      parameters:
        - name: addressOrSlug
          required: true
          in: path
          description: Market/group address (0x...) or slug identifier (my-market-name)
          schema:
            example: crypto-predictions-2025
      responses:
        '200':
          description: Market or group details with pricing and volume data
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/ClobMarketResponseDto'
                    description: CLOB market with position IDs and trading data
                  - $ref: '#/components/schemas/NegRiskGroupResponseDto'
                    description: NegRisk group with nested markets array
                  - $ref: '#/components/schemas/AmmMarketResponseDto'
                    description: AMM market with liquidity and volume data
        '404':
          description: Market or group not found
        '500':
          description: Server error when retrieving market/group data
components:
  schemas:
    ClobMarketResponseDto:
      type: object
      properties:
        id:
          type: number
          description: Market ID
          example: 7494
        conditionId:
          type: string
          description: Condition ID
          example: '0x947b8e6812bf8ac27687fa25b642d6a25bf5c7292068e5aef129d9d26e9780b8'
        negRiskRequestId:
          type: string
          description: NegRisk request ID
          example: null
          nullable: true
        description:
          type: string
          description: Market description
        collateralToken:
          $ref: '#/components/schemas/CollateralTokenDto'
        title:
          type: string
          description: Market title
        proxyTitle:
          type: string
          description: Proxy title
          nullable: true
        expirationDate:
          type: string
          description: Expiration date
        expirationTimestamp:
          type: number
          description: Expiration timestamp
        createdAt:
          type: string
          description: Created timestamp
        updatedAt:
          type: string
          description: Updated timestamp
        categories:
          description: Categories
          type: array
          items:
            type: string
        status:
          type: string
          description: Market status
        expired:
          type: boolean
          description: Is expired
        creator:
          $ref: '#/components/schemas/CreatorDto'
        tags:
          description: Tags
          type: array
          items:
            type: string
        frequency:
          type: string
          description: Schedule frequency for timeline
          example: minutely
        subFrequency:
          type: string
          description: Schedule sub-frequency for timeline
          nullable: true
          example: minutes_5
        volume:
          type: string
          description: Volume
        volumeFormatted:
          type: string
          description: Formatted volume
        tokens:
          $ref: '#/components/schemas/TokenPairDto'
        prices:
          description: Prices
          type: array
          items:
            type: number
        tradePrices:
          $ref: '#/components/schemas/TradePricesDto'
        isRewardable:
          type: boolean
          description: Is rewardable
        slug:
          type: string
          description: Market slug
        tradeType:
          type: string
          description: Trade type
          example: clob
        marketType:
          type: string
          description: Market type
          example: single
        priorityIndex:
          type: number
          description: Priority index
        winningOutcomeIndex:
          type: number
          description: Winning outcome index
          nullable: true
        metadata:
          $ref: '#/components/schemas/MetadataDto'
        settings:
          $ref: '#/components/schemas/MarketSettingsDto'
        logo:
          type: string
          description: Market logo
          nullable: true
        source:
          type: string
          description: Market source (e.g. ugm:crypto, ugm:sports)
          nullable: true
        feedEvents:
          description: Feed events
          type: array
          items:
            $ref: '#/components/schemas/FeedEventDto'
      required:
        - id
        - conditionId
        - negRiskRequestId
        - description
        - collateralToken
        - title
        - proxyTitle
        - expirationDate
        - expirationTimestamp
        - createdAt
        - updatedAt
        - categories
        - status
        - expired
        - creator
        - tags
        - volume
        - volumeFormatted
        - tokens
        - prices
        - tradePrices
        - isRewardable
        - slug
        - tradeType
        - marketType
        - priorityIndex
        - winningOutcomeIndex
        - metadata
        - settings
        - logo
        - source
    NegRiskGroupResponseDto:
      type: object
      properties:
        id:
          type: number
          description: Group ID
          example: 10000078
        slug:
          type: string
          description: Group slug
        outcomeTokens:
          description: Outcome tokens
          type: array
          items:
            type: string
        title:
          type: string
          description: Group title
        ogImageURI:
          type: string
          description: OG image URI
        imageUrl:
          type: string
          description: Group image URL
          nullable: true
        expirationDate:
          type: string
          description: Expiration date
        expirationTimestamp:
          type: number
          description: Expiration timestamp
        expired:
          type: boolean
          description: Is expired
        creator:
          $ref: '#/components/schemas/CreatorDto'
        collateralToken:
          $ref: '#/components/schemas/CollateralTokenDto'
        tags:
          description: Tags
          type: array
          items:
            type: string
        frequency:
          type: string
          description: Schedule frequency for timeline
          example: minutely
        subFrequency:
          type: string
          description: Schedule sub-frequency for timeline
          nullable: true
          example: minutes_5
        tradeType:
          type: string
          description: Trade type
          example: clob
        marketType:
          type: string
          description: Market type
          example: group
        createdAt:
          type: string
          description: Created timestamp
        updatedAt:
          type: string
          description: Updated timestamp
        categories:
          description: Categories
          type: array
          items:
            type: string
        status:
          type: string
          description: Status
        priorityIndex:
          type: number
          description: Priority index
        negRiskMarketId:
          type: string
          description: NegRisk market ID
        markets:
          description: Markets in the group
          type: array
          items:
            $ref: '#/components/schemas/GroupMarketDto'
        metadata:
          $ref: '#/components/schemas/MetadataDto'
        volume:
          type: string
          description: Volume
        volumeFormatted:
          type: string
          description: Formatted volume
        dailyReward:
          type: string
          description: Daily reward
        source:
          type: string
          description: Market source (e.g. ugm:crypto, ugm:sports)
          nullable: true
        feedEvents:
          description: Feed events
          type: array
          items:
            $ref: '#/components/schemas/FeedEventDto'
      required:
        - id
        - slug
        - outcomeTokens
        - title
        - ogImageURI
        - imageUrl
        - expirationDate
        - expirationTimestamp
        - expired
        - creator
        - collateralToken
        - tags
        - tradeType
        - marketType
        - createdAt
        - updatedAt
        - categories
        - status
        - priorityIndex
        - negRiskMarketId
        - markets
        - metadata
        - volume
        - volumeFormatted
        - dailyReward
        - source
        - feedEvents
    AmmMarketResponseDto:
      type: object
      properties:
        id:
          type: number
          description: Market ID
          example: 7497
        address:
          type: string
          description: Market address
        conditionId:
          type: string
          description: Condition ID
        description:
          type: string
          description: Market description
        collateralToken:
          $ref: '#/components/schemas/CollateralTokenDto'
        title:
          type: string
          description: Market title
        proxyTitle:
          type: string
          description: Proxy title
          nullable: true
        positionIds:
          description: Position IDs
          type: array
          items:
            type: string
        ogImageURI:
          type: string
          description: OG image URI
          nullable: true
        expirationDate:
          type: string
          description: Expiration date
        expirationTimestamp:
          type: number
          description: Expiration timestamp
        createdAt:
          type: string
          description: Created timestamp
        updatedAt:
          type: string
          description: Updated timestamp
        categories:
          description: Categories
          type: array
          items:
            type: string
        winningOutcomeIndex:
          type: number
          description: Winning outcome index
          nullable: true
        status:
          type: string
          description: Market status
        expired:
          type: boolean
          description: Is expired
        creator:
          $ref: '#/components/schemas/CreatorDto'
        tags:
          description: Tags
          type: array
          items:
            type: string
        openInterest:
          type: string
          description: Open interest
        openInterestFormatted:
          type: string
          description: Formatted open interest
        volume:
          type: string
          description: Volume
        volumeFormatted:
          type: string
          description: Formatted volume
        liquidity:
          type: string
          description: Liquidity
        liquidityFormatted:
          type: string
          description: Formatted liquidity
        slug:
          type: string
          description: Market slug
        tradeType:
          type: string
          description: Trade type
          example: amm
        marketType:
          type: string
          description: Market type
          example: single
        priorityIndex:
          type: number
          description: Priority index
        metadata:
          $ref: '#/components/schemas/MetadataDto'
        logo:
          type: string
          description: Market logo
          nullable: true
        source:
          type: string
          description: Market source (e.g. ugm:crypto, ugm:sports)
          nullable: true
        feedEvents:
          description: Feed events
          type: array
          items:
            $ref: '#/components/schemas/FeedEventDto'
      required:
        - id
        - address
        - conditionId
        - description
        - collateralToken
        - title
        - proxyTitle
        - positionIds
        - ogImageURI
        - expirationDate
        - expirationTimestamp
        - createdAt
        - updatedAt
        - categories
        - winningOutcomeIndex
        - status
        - expired
        - creator
        - tags
        - openInterest
        - openInterestFormatted
        - volume
        - volumeFormatted
        - liquidity
        - liquidityFormatted
        - slug
        - tradeType
        - marketType
        - priorityIndex
        - metadata
        - logo
        - source
        - feedEvents
    CollateralTokenDto:
      type: object
      properties:
        address:
          type: string
          description: Token contract address
          example: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        decimals:
          type: number
          description: Token decimal places
          example: 6
        symbol:
          type: string
          description: Token symbol
          example: USDC
      required:
        - address
        - decimals
        - symbol
    CreatorDto:
      type: object
      properties:
        name:
          type: string
          description: Creator display name
          example: Limitless
        imageURI:
          type: string
          description: Creator profile image URI
          example: https://limitless.exchange/assets/images/logo.svg
          nullable: true
        link:
          type: string
          description: Creator social media link
          example: https://x.com/trylimitless
          nullable: true
        address:
          type: string
          description: Creator wallet address
          example: '0x55257A9a03601B0587Ab4752FD42A87c4Bad2e1e'
      required:
        - name
        - imageURI
        - link
        - address
    TokenPairDto:
      type: object
      properties:
        'yes':
          type: string
          description: YES token ID
          example: >-
            78695809706775235377718830617502491971378663350108823320552375535762230401980
        'no':
          type: string
          description: NO token ID
          example: >-
            8642544735724967665477930445154251213223700833624811358896571351781151616445
      required:
        - 'yes'
        - 'no'
    TradePricesDto:
      type: object
      properties:
        buy:
          type: object
          description: Buy prices for market and limit orders
          properties:
            market:
              type: array
              items:
                type: number
              example:
                - 0.997
                - 0.997
            limit:
              type: array
              items:
                type: number
              example:
                - 0.003
                - 0.003
        sell:
          type: object
          description: Sell prices for market and limit orders
          properties:
            market:
              type: array
              items:
                type: number
              example:
                - 0.003
                - 0.003
            limit:
              type: array
              items:
                type: number
              example:
                - 0.997
                - 0.997
      required:
        - buy
        - sell
    MetadataDto:
      type: object
      properties:
        fee:
          type: boolean
          description: Whether market has fees enabled
          example: true
        isBannered:
          type: boolean
          description: Whether market is featured in banner
          example: false
        isPolyArbitrage:
          type: boolean
          description: Whether market supports Polygon arbitrage
          example: false
        shouldMarketMake:
          type: boolean
          description: Whether market should be market made
          example: false
      required:
        - fee
        - isBannered
        - isPolyArbitrage
    MarketSettingsDto:
      type: object
      properties:
        minSize:
          type: string
          description: Minimum trade size in wei
          example: '50000000'
        maxSpread:
          type: number
          description: Maximum spread allowed
          example: 0.035
        dailyReward:
          type: string
          description: Daily reward amount
          example: '20'
        rewardsEpoch:
          type: string
          description: Rewards epoch in decimal format
          example: '0.013888888888888888'
        c:
          type: string
          description: C parameter
          example: '3'
      required:
        - minSize
        - maxSpread
        - dailyReward
        - rewardsEpoch
        - c
    FeedEventDto:
      type: object
      properties:
        eventType:
          type: string
          description: Type of feed event
          example: NEW_TRADE
          enum:
            - NEW_TRADE
            - MARKET_CREATED
            - MARKET_RESOLVED
        timestamp:
          type: string
          description: Event timestamp in ISO format
          example: '2025-09-01T11:30:31.000Z'
        user:
          description: User who triggered the event
          allOf:
            - $ref: '#/components/schemas/FeedEventUserDto'
        data:
          description: Event-specific data
          allOf:
            - $ref: '#/components/schemas/FeedEventDataDto'
        bodyHash:
          type: string
          description: Unique hash for the event
          example: '01100995'
      required:
        - eventType
        - timestamp
        - user
        - data
        - bodyHash
    GroupMarketDto:
      type: object
      properties:
        id:
          type: number
          description: Market ID
          example: 7494
        conditionId:
          type: string
          description: Condition ID
          example: '0x947b8e6812bf8ac27687fa25b642d6a25bf5c7292068e5aef129d9d26e9780b8'
        negRiskRequestId:
          type: string
          description: NegRisk request ID
          example: null
          nullable: true
        description:
          type: string
          description: Market description
        collateralToken:
          $ref: '#/components/schemas/CollateralTokenDto'
        title:
          type: string
          description: Market title
        proxyTitle:
          type: string
          description: Proxy title
          nullable: true
        expirationDate:
          type: string
          description: Expiration date
        expirationTimestamp:
          type: number
          description: Expiration timestamp
        createdAt:
          type: string
          description: Created timestamp
        updatedAt:
          type: string
          description: Updated timestamp
        categories:
          description: Categories
          type: array
          items:
            type: string
        status:
          type: string
          description: Market status
        expired:
          type: boolean
          description: Is expired
        creator:
          $ref: '#/components/schemas/CreatorDto'
        tags:
          description: Tags
          type: array
          items:
            type: string
        frequency:
          type: string
          description: Schedule frequency for timeline
          example: minutely
        subFrequency:
          type: string
          description: Schedule sub-frequency for timeline
          nullable: true
          example: minutes_5
        volume:
          type: string
          description: Volume
        volumeFormatted:
          type: string
          description: Formatted volume
        tokens:
          $ref: '#/components/schemas/TokenPairDto'
        prices:
          description: Prices
          type: array
          items:
            type: number
        tradePrices:
          $ref: '#/components/schemas/TradePricesDto'
        isRewardable:
          type: boolean
          description: Is rewardable
        slug:
          type: string
          description: Market slug
        tradeType:
          type: string
          description: Trade type
          example: clob
        marketType:
          type: string
          description: Market type
          example: single
        priorityIndex:
          type: number
          description: Priority index
        winningOutcomeIndex:
          type: number
          description: Winning outcome index
          nullable: true
        metadata:
          $ref: '#/components/schemas/MetadataDto'
        settings:
          $ref: '#/components/schemas/MarketSettingsDto'
        logo:
          type: string
          description: Market logo
          nullable: true
        source:
          type: string
          description: Market source (e.g. ugm:crypto, ugm:sports)
          nullable: true
        feedEvents:
          description: Feed events
          type: array
          items:
            $ref: '#/components/schemas/FeedEventDto'
        orderInGroup:
          type: number
          description: Order in group
      required:
        - id
        - conditionId
        - negRiskRequestId
        - description
        - collateralToken
        - title
        - proxyTitle
        - expirationDate
        - expirationTimestamp
        - createdAt
        - updatedAt
        - categories
        - status
        - expired
        - creator
        - tags
        - volume
        - volumeFormatted
        - tokens
        - prices
        - tradePrices
        - isRewardable
        - slug
        - tradeType
        - marketType
        - priorityIndex
        - winningOutcomeIndex
        - metadata
        - settings
        - logo
        - source
    FeedEventUserDto:
      type: object
      properties:
        id:
          type: number
          description: User ID
          example: 7080
        account:
          type: string
          description: User wallet address
          example: '0xea27f6788F083e6070961d3E52A2e596367E04CC'
        username:
          type: string
          description: Username
          example: null
          nullable: true
        displayName:
          type: string
          description: Display name
          example: GG
          nullable: true
        rankName:
          type: string
          description: User ranking name
          example: Bronze
        points:
          type: string
          description: User points balance
          example: '0.00000000'
        name:
          type: string
          description: User display name for feed events
          example: GG
        imageURI:
          type: string
          description: User profile image URI
          example: null
          nullable: true
      required:
        - account
        - username
        - displayName
        - imageURI
    FeedEventDataDto:
      type: object
      properties:
        title:
          type: string
          description: Market title
          example: DOGE Up or Down - Hourly
        address:
          type: string
          description: Market contract address
          example: '0x76d3e2098Be66Aa7E15138F467390f0Eb7349B9b'
        slug:
          type: string
          description: Market slug
          example: doge-up-or-down-1-hour-1756136880125
        strategy:
          type: string
          description: Trading strategy
          example: Buy
          enum:
            - Buy
            - Sell
        outcome:
          type: string
          description: Market outcome
          example: Down
          enum:
            - 'YES'
            - 'NO'
            - Up
            - Down
        contracts:
          type: string
          description: Number of contracts traded
          example: '9.071313'
        txHash:
          type: string
          description: Transaction hash
          example: '0xe8a4464daf3561f6be5fef4d1bc64184c4f6fe9d6306ab7297fe7ed63a24df1c'
        symbol:
          type: string
          description: Collateral token symbol
          example: USDC
        tradeAmount:
          type: string
          description: Trade amount in collateral token
          example: '5'
        tradeAmountUSD:
          type: string
          description: Trade amount in USD
          example: '4.999525'
        marketId:
          type: number
          description: Market ID
          example: 7495
      required:
        - title
        - address
        - strategy
        - outcome
        - contracts
        - txHash
        - symbol
        - tradeAmount
        - tradeAmountUSD
        - marketId

````