---
url: /api/reference/list-trades.md
description: >-
  List trades with filters and cursor pagination. Use ?include= to embed signal,
  positions, or orders inline.
---

# GET /trades

Returns your trades, newest first, with cursor pagination.

Filter by `status`, `symbol`, `channel_id`, `account_id`, or date window.

**Trade statuses:** `pending`, `active`, `closed_profit`, `closed_loss`, `failed`, `needs_recovery`, `closed_timeout_cleanup`, `closed_unfilled`.

**`?include=`** — comma-separated list to embed related objects inline: `signal`, `positions`, `orders`. Any member of `include` causes the signal to be embedded. For a single trade with everything embedded, prefer [GET /trades/{id}](/api/reference/get-trade).

***
