# List trades

**GET /api/v1/trades**

Returns the authenticated user's trade history, including any fills linked to each trade. Pagination, sorting, date filtering, and status filtering parameters are reserved for this list endpoint; current responses remain unpaginated until server-side pagination is enabled.


## Servers
- https://api.lumetrade.com: https://api.lumetrade.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumetrade API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.



### Query parameters

- **page** (integer(int32))
  Page number

- **size** (integer(int32))
  Page size

- **sort** (string)
  Sort expression: field,direction.

- **dateFrom** (string(date-time))
  Lower timestamp bound.

- **dateTo** (string(date-time))
  Upper timestamp bound.

- **status** (string)
  Trade status filter.



## Responses
### 200
Trades returned successfully

#### Body: application/json (array[object])
- **fromCurrency** (string)
  Currency sold/sent.

- **toCurrency** (string)
  Currency bought/received.

- **fromAmount** (number)
  Amount sold/sent.

- **toAmount** (number)
  Amount bought/received.

- **rate** (number)
  Executed trade rate.

- **isRateInverted** (boolean)
  Whether the displayed rate is inverted.

- **isRfq** (boolean)
  Whether this trade was created from RFQ.

- **status** (string)
  Trade status.

- **transactionId** (string)
  Transaction id for trade lookups.

- **createdAt** (string(date-time))
  Trade creation timestamp.

- **completedAt** (string(date-time))
  Completion timestamp.

- **fills** (array[object])
  Trade fills. Omitted from RFQ quote confirmation responses.



[Powered by Bump.sh](https://bump.sh)