---
title: "List order trades"
method: GET
path: "/trading/orders/{orderId}/trades"
tags: ["Orders"]
---

# List order trades

`GET /trading/orders/{orderId}/trades`

## Request

- Base URL: `https://api.enterprise.sandbox.uphold.com`
- URL: `https://api.enterprise.sandbox.uphold.com/trading/orders/{orderId}/trades`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/core/oauth2/token` scopes: `trading.orders:read`
- TypeScript: <https://skmtc.dev/uphold/apis/trading-api/docs/trading/orders/:orderId/trades/get.ts> (a function with typed inputs; its response is checked against the schema)

List the trades that executed an order, oldest first.

## Path parameters

- `orderId` string, uuid, required

## Query parameters

- `perPage` integer

## Headers

- `X-On-Behalf-Of` string
- `X-Uphold-User-Ip` union
  - string, ipv4
  - string, ipv6
- `X-Uphold-User-Agent` string
- `X-Uphold-User-Origin` string
- `X-Uphold-User-Country` string
- `X-Uphold-User-Subdivision` string
- `X-Uphold-User-City` string

## Response `200`

Trades retrieved.

- object
  - `trades` TradingTrade[], required
    - `transactionId` string, uuid, required: The id of the transaction that booked the trade.
    - `quantity` string, required: The base quantity executed.
    - `price` string, required: The price, in the quote asset per one unit of the base asset.
    - `notional` string, required: The gross amount, in the quote asset.
    - `createdAt` string, date-time, required: The time at which the trade executed.
  - `pagination` Pagination, required: The pagination information.
    - `first` string, uri: The URL to the first set of results.
    - `prev` string, uri: The URL to the previous set of results.
    - `next` string, uri: The URL to the next set of results.

## Other responses

- `400`: Bad Request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Resource not found.
- `429`: Too Many Requests.

---

[API](https://skmtc.dev/uphold/apis/trading-api.md) - [All operations](https://skmtc.dev/uphold/apis/trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/uphold/apis/trading-api/revisions/d567e5492a13?raw)