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

# Market Metadata

> Market Metadata

 Returns current price (from latest candle), 24h statistics (high, low,
 volume, change), and market initialization timestamp. 24h fields will
 be null if less than 24 hours of data available.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/market/pairs/{tradingPairId}/metadata
openapi: 3.0.3
info:
  title: Monaco Protocol API
  description: REST API for the Monaco Protocol hybrid CLOB exchange.
  version: 1.0.0
servers:
  - url: https://staging.apimonaco.xyz
    description: Staging server (Testnet)
security: []
tags:
  - name: AccountsService
  - name: ApplicationsService
  - name: AuthService
  - name: BuildercodeRewardsService
  - name: CopyTradingService
  - name: DelegatedAgentsService
  - name: FaucetService
  - name: FeesService
  - name: HealthService
  - name: ManagedMarketsService
    description: |-
      Wallet-authenticated maker assignments. The signed session must match both
       configured maker user and application. Owner IDs are process fences, never auth.
       Only wallet sessions are supported; delegated-agent sessions receive 403.
  - name: MarginAccountsService
    description: |-
      Current public isolated-margin semantics:
       - a user has one parent margin account per application scope
       - opening orders create or reuse isolated position buckets under that parent
       - parent account creation is handled internally by margin workflows
  - name: MarketService
  - name: OrderbookService
  - name: OrdersService
  - name: PositionsService
    description: |-
      Current public isolated-margin semantics:
       - positions link to a parent margin account and, when applicable, a bucket id
       - opening orders create or reuse isolated position buckets under the parent
       - users can open another isolated position by reusing the parent account with a different market bucket
  - name: PulseService
  - name: SweeperService
  - name: TraderCodeService
  - name: TradesService
  - name: WhitelistService
  - name: WithdrawalsService
paths:
  /api/v1/market/pairs/{tradingPairId}/metadata:
    get:
      tags:
        - MarketService
        - Market
      summary: Market Metadata
      description: |-
        Market Metadata

         Returns current price (from latest candle), 24h statistics (high, low,
         volume, change), and market initialization timestamp. 24h fields will
         be null if less than 24 hours of data available.
      operationId: get_market_metadata
      parameters:
        - name: tradingPairId
          in: path
          required: true
          schema:
            type: string
            default: 893d2add-2f36-4ee7-b660-893d2add2f36
          example: 893d2add-2f36-4ee7-b660-893d2add2f36
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMarketMetadataResponse'
        '404':
          description: Trading pair not found
        '500':
          description: Internal server error
components:
  schemas:
    GetMarketMetadataResponse:
      type: object
      properties:
        baseIconUrl:
          example: https://assets.0xmonaco.com/icons/btc.svg
          type: string
          description: URL for the base token icon
          nullable: true
        high24h:
          example: '96500.00'
          type: string
          description: Highest price in the last 24 hours
          nullable: true
        lastPrice:
          example: '95432.50'
          type: string
          description: Most recent trade price
          nullable: true
        lastPriceTimestamp:
          example: '1736742000000'
          type: string
          description: Timestamp of the last trade (ms since epoch)
          nullable: true
        low24h:
          example: '94200.00'
          type: string
          description: Lowest price in the last 24 hours
          nullable: true
        marketInitializationTimestamp:
          example: '1735000000000'
          type: string
          description: When this market was first initialized (ms since epoch)
          nullable: true
        priceChange24h:
          example: '1232.50'
          type: string
          description: Absolute price change in the last 24 hours
          nullable: true
        priceChangePercent24h:
          example: '1.31'
          type: string
          description: Percentage price change in the last 24 hours
          nullable: true
        quoteIconUrl:
          example: https://assets.0xmonaco.com/icons/usdc.svg
          type: string
          description: URL for the quote token icon
          nullable: true
        symbol:
          example: BTC/USDC
          type: string
          description: Trading pair symbol
          nullable: true
        volume24h:
          example: '1234.5678'
          type: string
          description: Base token volume in the last 24 hours
          nullable: true
        minLeverage:
          example: '1'
          type: string
          description: Minimum supported leverage for margin markets
          nullable: true
        maxLeverage:
          example: '20'
          type: string
          description: Maximum supported leverage for margin markets
          nullable: true
        markPrice:
          example: '95410.25'
          type: string
          description: Current manipulation-resistant mark price
          nullable: true
        indexPrice:
          example: '95400.00'
          type: string
          description: Current index/oracle reference price
          nullable: true
        totalBaseVolumeLtd:
          example: '123456.78900000'
          type: string
          description: >-
            Life-to-date cumulative base-token volume (since market inception);
            "0" for a pair with no trades yet
          nullable: true
        totalQuoteVolumeLtd:
          example: '9123456789.50'
          type: string
          description: >-
            Life-to-date cumulative quote-token volume (since market inception);
            "0" for a pair with no trades yet
          nullable: true
        totalTradeCountLtd:
          example: 482931
          type: integer
          description: >-
            Life-to-date cumulative number of trades (since market inception); 0
            for a pair with no trades yet
          format: int64
          nullable: true
        quoteVolume24h:
          example: '117845632.18'
          type: string
          description: >-
            Quote-token (notional) volume summed over the available candles in
            the rolling 24h window; null when quote volume is unavailable for
            the window
          nullable: true
      description: Market metadata with current price and 24h statistics.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.