Appearance
Are you an LLM? You can read better optimized documentation at /api/reference/list-trades.md for this page in Markdown format
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}.
List trades
GET
/trades
Authorizations
bearerAuth
TypeHTTP (bearer)
Parameters
Query Parameters
status
Typestring
Enum
pendingactiveclosed_profitclosed_lossfailedneeds_recoveryclosed_timeout_cleanupclosed_unfilledsymbol
Typestring
channel_id
Typestring
format
uuidaccount_id
Typestring
format
uuidafter_date
Typestring
format
date-timebefore_date
Typestring
format
date-timelimit
Typeinteger
minimum
1maximum
100default
50after
opaque pagination cursor (next_cursor)
Typestring
include
comma list of signal,positions,orders
Typestring
Responses
OK
application/json
JSON
{
"data": [
],
"has_more": true,
"next_cursor": "string"
}

