---
title: "List trade history"
method: GET
path: "/trades"
tags: ["Trading"]
---

# List trade history

`GET /trades`

Returns the authenticated user's trade history.

## Query parameters

- `market` string
- `limit` integer
- `page` integer
- `start_time` integer
- `end_time` integer

## Response `200`

Trade history returned successfully.

- UserTrade[]
  - `trade_id` string
  - `order_id` string
  - `client_order_id` string — Present only when the original order was submitted with a client order ID.
  - `market` string
  - `side` 'buy' | 'sell'
  - `price` string
  - `quantity` string
  - `total_value` string
  - `fee` string
  - `timestamp` integer

## Other responses

- `400` — Invalid request parameters.
- `401` — Missing or invalid authentication headers.
- `429` — Rate limit exceeded.
- `503` — Service temporarily unavailable.

---

[API](https://skmtc.dev/altcointrader/apis/altcointrader-api.md) · [All operations](https://skmtc.dev/altcointrader/apis/altcointrader-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/altcointrader/altcointrader-api/revisions/fcbbd5bcd699/schema)