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

# List order trades

> List the trades that executed an order, oldest first.

> [!NOTE]
>
> This endpoint is currently available in **Sandbox** only. It is not yet available in **Production**.

> [!NOTE]
>
> In Sandbox the orders you create are not stored, so only the sample orders returned by [List orders](./list-orders) have trades to read. Any other id replies with `404`.

A fill-or-kill order has at most one trade, and it appears once the order is booked. Each trade has the `transactionId` that booked it. Read more about [execution and trades](../introduction#execution-and-trades).


## OpenAPI

````yaml _media/specs/trading-openapi.mintlify.json get /trading/orders/{orderId}/trades
openapi: 3.1.0
info:
  version: 0.1.0
  title: Trading API
  description: >-
    The Trading API provides resources to estimate prices and place fill-or-kill
    orders.
  contact:
    name: Uphold API Team
    email: developer@uphold.com
    url: https://developer.uphold.com
servers:
  - url: https://api.enterprise.sandbox.uphold.com
    description: Sandbox
  - url: https://api.enterprise.uphold.com
    description: Production
security:
  - OAuth2: []
tags:
  - name: Prices
    description: Prices.
  - name: Orders
    description: Orders.
paths:
  /trading/orders/{orderId}/trades:
    get:
      tags:
        - Orders
      summary: List order trades
      description: List the trades that executed an order, oldest first.
      operationId: trading.list-order-trades
      parameters:
        - $ref: '#/components/parameters/trading-order-id'
        - $ref: '#/components/parameters/pagination-per-page'
      responses:
        '200':
          $ref: '#/components/responses/list-trading-order-trades-response'
        '404':
          $ref: '#/components/responses/list-trading-order-trades-not-found-response'
      security:
        - OAuth2:
            - trading.orders:read
components:
  parameters:
    trading-order-id:
      name: orderId
      description: The order id.
      in: path
      required: true
      schema:
        type: string
        format: uuid
      examples:
        Order Id:
          value: 0192f3a1-7c2e-7d4b-9a1f-3e5c8b2d4f60
    pagination-per-page:
      name: perPage
      description: The number of items per page.
      in: query
      schema:
        type: integer
        format: int32
        minimum: 1
        maximum: 100
        default: 10
      examples:
        10 Items Per Page:
          value: 10
  responses:
    list-trading-order-trades-response:
      description: Trades retrieved.
      content:
        application/json:
          schema:
            type: object
            properties:
              trades:
                type: array
                items:
                  $ref: '#/components/schemas/trading-trade'
              pagination:
                $ref: '#/components/schemas/pagination'
            required:
              - trades
              - pagination
          examples:
            Trades Retrieved:
              value:
                trades:
                  - transactionId: 3f6c2a9e-8b1d-4e7f-a2c5-9d0e1b4a7c36
                    quantity: '0.5'
                    price: '61919.14'
                    notional: '30959.57'
                    createdAt: '2026-10-12T10:31:05.104Z'
                pagination:
                  first: >-
                    https://api.enterprise.uphold.com/trading/orders/0192f3a1-7c2e-7d4b-9a1f-3e5c8b2d4f60/trades?page=1&perPage=10
            No Trades:
              value:
                trades: []
                pagination: {}
      headers:
        x-uphold-request-id:
          description: >-
            A unique identifier for the request that can be shared with Uphold
            for troubleshooting purposes.
          required: true
          schema:
            type: string
            format: uuid
          examples:
            Request ID:
              value: 9092ee4d-f0fb-42e9-8787-b668dbcec531
    list-trading-order-trades-not-found-response:
      description: Resource not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/error'
          examples:
            Order Not Found:
              value:
                code: entity_not_found
                message: The order cannot be found
                details:
                  entity: order
      headers:
        x-uphold-request-id:
          description: >-
            A unique identifier for the request that can be shared with Uphold
            for troubleshooting purposes.
          required: true
          schema:
            type: string
            format: uuid
          examples:
            Request ID:
              value: 9092ee4d-f0fb-42e9-8787-b668dbcec531
  schemas:
    trading-trade:
      description: An execution of an order.
      type: object
      properties:
        transactionId:
          description: The id of the transaction that booked the trade.
          type: string
          format: uuid
        quantity:
          description: The base quantity executed.
          type: string
        price:
          description: The price, in the quote asset per one unit of the base asset.
          type: string
        notional:
          description: The gross amount, in the quote asset.
          type: string
        createdAt:
          description: The time at which the trade executed.
          type: string
          format: date-time
      required:
        - transactionId
        - quantity
        - price
        - notional
        - createdAt
    pagination:
      description: The pagination information.
      type: object
      properties:
        first:
          description: The URL to the first set of results.
          type: string
          format: uri
        prev:
          description: The URL to the previous set of results.
          type: string
          format: uri
        next:
          description: The URL to the next set of results.
          type: string
          format: uri
    error:
      description: The error information.
      allOf:
        - $ref: '#/components/schemas/feedback'
    feedback:
      description: A feedback message with a code and human-readable description.
      type: object
      properties:
        code:
          description: A short string with a brief explanation about the code reported.
          type: string
        message:
          description: A human-readable message providing more details.
          type: string
        details:
          description: Additional information about the feedback reported.
          type: object
          additionalProperties: true
      required:
        - code
        - message
  securitySchemes:
    OAuth2:
      type: oauth2
      description: OAuth 2.0
      flows:
        clientCredentials:
          tokenUrl: /core/oauth2/token
          scopes:
            trading.prices:create: Grants access to estimate prices.
            trading.orders:create: Grants access to create orders.
            trading.orders:read: Grants access to read orders and their trades.

````