List trades | Lumetrade Staging API documentation

List trades Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.staging.lumetrade.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "Lumetrade Staging API MCP server": {
    "url": "https://docs.staging.lumetrade.com/mcp"
  }
}

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

Authenticated API key is not allowed to perform this action
Hide response attributes Show response attributes object
- code integer(int32)
- message string
- httpStatus integer(int32)
- requestId string
- timestamp string(date-time)
- errors array[object]
  
  Hide errors attributes Show errors attributes object
  
  field string
  
  message string
429 application/json

Cloudflare API rate limit exceeded
Hide response attributes Show response attributes object
- error string
- message string
401 application/json

API key authentication failed
Hide response attributes Show response attributes object
- code integer(int32)
- message string
- httpStatus integer(int32)
- requestId string
- timestamp string(date-time)
- errors array[object]
  
  Hide errors attributes Show errors attributes object
  
  field string
  
  message string
400 application/json

Request validation failed
Hide response attributes Show response attributes object
- code integer(int32)
- message string
- httpStatus integer(int32)
- requestId string
- timestamp string(date-time)
- errors array[object]
  
  Hide errors attributes Show errors attributes object
  
  field string
  
  message string
500 application/json

Unexpected server error
Hide response attributes Show response attributes object
- code integer(int32)
- message string
- httpStatus integer(int32)
- requestId string
- timestamp string(date-time)
- errors array[object]
  
  Hide errors attributes Show errors attributes object
  
  field string
  
  message string

GET /api/v1/trades

curl \
 --request GET 'https://api.staging.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"
      }
    ]
  }
]

Response examples (403)

{
  "httpStatus": 403,
  "errors": [],
  "timestamp": "2026-01-01T00:00:00Z",
  "code": 403,
  "message": "Authenticated API key is not allowed to perform this action",
  "requestId": "req_01HY0000000000000000000000"
}

Response examples (429)

{
  "error": "rate_limit_exceeded",
  "message": "API rate limit exceeded"
}

Response examples (401)

{
  "httpStatus": 401,
  "errors": [],
  "timestamp": "2026-01-01T00:00:00Z",
  "code": 401,
  "message": "API key authentication failed",
  "requestId": "req_01HY0000000000000000000000"
}

Response examples (400)

{
  "httpStatus": 400,
  "errors": [],
  "timestamp": "2026-01-01T00:00:00Z",
  "code": 400,
  "message": "Request validation failed",
  "requestId": "req_01HY0000000000000000000000"
}

Response examples (500)

{
  "httpStatus": 500,
  "errors": [],
  "timestamp": "2026-01-01T00:00:00Z",
  "code": 500,
  "message": "Unexpected server error",
  "requestId": "req_01HY0000000000000000000000"
}