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

# Get Trade by ID

> Get Trade by ID

 Retrieve a single trade by its unique identifier.



## OpenAPI

````yaml /proto-openapi/api/openapi.yaml get /api/v1/trades/by-id/{tradeId}
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/trades/by-id/{tradeId}:
    get:
      tags:
        - TradesService
        - Trades
      summary: Get Trade by ID
      description: |-
        Get Trade by ID

         Retrieve a single trade by its unique identifier.
      operationId: get_trade_by_id
      parameters:
        - name: tradeId
          in: path
          required: true
          schema:
            type: string
            default: 2b1a5f9c-0000-4000-8000-000000000006
          example: 2b1a5f9c-0000-4000-8000-000000000006
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetTradeByIdResponse'
        '400':
          description: Invalid trade ID
        '404':
          description: Trade not found
        '500':
          description: Internal server error
components:
  schemas:
    GetTradeByIdResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/TradeData'
        eventType:
          example: trade
          type: string
          description: Event type identifier
          nullable: true
        tradingPairId:
          example: 456e7890-e12b-12d3-a456-426614174000
          type: string
          description: Trading pair UUID
          format: uuid
          nullable: true
        tradingMode:
          example: SPOT
          type: string
          description: 'Trading mode: SPOT or MARGIN'
          nullable: true
      description: A single trade.
    TradeData:
      type: object
      properties:
        executedAt:
          example: '2023-11-13T10:30:00Z'
          type: string
          description: >-
            Trade execution timestamp (ISO 8601). Omitted when the trade has no
            execution time.
          nullable: true
        makerSide:
          example: BUY
          type: string
          description: 'Maker order side: BUY or SELL'
          nullable: true
        price:
          example: '35000.00'
          type: string
          description: Execution price
          nullable: true
        quantity:
          example: '0.5'
          type: string
          description: Traded quantity in base token (normalized)
          nullable: true
        quantityRaw:
          example: '50000000'
          type: string
          description: Traded quantity in raw base-token units
          nullable: true
        tradeId:
          example: 123e4567-e89b-12d3-a456-426614174000
          type: string
          description: Trade UUID
          format: uuid
          nullable: true
      description: >-
        Core fields of a single executed trade, nested under `data` in the
        public trade event envelope.

````

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