Lumetrade Staging API
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.

Headers

  • X-API-KEY string Required

    Public API key issued from the Lumetrade API key management flow.

  • X-API-SECRET string Required

    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 application/json

    Trades returned successfully

    Hide response attributes Show response attributes 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.

      Values are PENDING, COMPLETED, CANCELLED, or REVERSED.

    • 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.

      Hide fills attributes Show fills attributes object

      Trade fill returned by the API.

      • fromCurrency string

        Currency sent for this fill.

      • fromCurrencyAmount number

        Amount sent for this fill.

      • toCurrency string

        Currency received for this fill.

      • toCurrencyAmount number

        Amount received for this fill.

      • status string

        Fill status.

        Values are COMPLETED or REVERSED.

      • transactionId string

        Transaction id for this fill.

      • modifiedAt string(date-time)

        Last modified timestamp.

      • createdAt string(date-time)

        Fill creation timestamp.
GET /api/v1/trades 
curl \
 --request GET 'https://api.lumetrade.com/api/v1/trades' \
 --header "X-API-KEY: string" \
 --header "X-API-SECRET: string"
Response examples (200) 
[
  {
    "fromCurrency": "USDT",
    "toCurrency": "ZAR",
    "fromAmount": 100,
    "toAmount": 1840,
    "rate": 18.4,
    "isRateInverted": false,
    "isRfq": true,
    "status": "COMPLETED",
    "transactionId": "trd_4J7K2N",
    "createdAt": "2026-05-11T10:15:30Z",
    "completedAt": "2026-05-11T10:15:35",
    "fills": [
      {
        "fromCurrency": "USDT",
        "fromCurrencyAmount": 100,
        "toCurrency": "ZAR",
        "toCurrencyAmount": 1840,
        "status": "COMPLETED",
        "transactionId": "fil_2N8K4Q",
        "modifiedAt": "2026-05-11T10:15:35Z",
        "createdAt": "2026-05-11T10:15:30Z"
      }
    ]
  }
]