List Orders

List trade orders with filtering options.

Endpoint

GET /api/v3/tradeOrder/list

Description

Retrieves a paginated list of trade orders. Supports filtering by trading account, instrument, status, and time range.

Authentication

Requires Bearer token authentication.

Authorization: Bearer {access_token}

Request Parameters

Parameter	Type	Required	Description
tradeOrderId	string	No	Filter by specific order ID
tradingAccountId	string	No	Filter by trading account
instrumentId	string	No	Filter by instrument
status	string	No	Filter by order status
startTime	integer	No	Start time (milliseconds)
endTime	integer	No	End time (milliseconds)
limit	integer	No	Maximum results (default: 10, max: 100)
offset	integer	No	Number of results to skip
cursor	string	No	Cursor for pagination
ascending	boolean	No	Sort order (default: false, newest first)

Order Status Values

Status	Description
PENDING	Order submitted, awaiting exchange confirmation
OPEN	Order active on exchange
PARTIALLY_FILLED	Order partially executed
FILLED	Order fully executed
CANCELLED	Order cancelled
REJECTED	Order rejected by exchange
EXPIRED	Order expired

Response

Returns an array of trade order objects with pagination.

Field	Type	Description
tradeOrderId	string	Unique order identifier
tradingAccountId	string	Trading account ID
venue	string	Exchange venue
instrumentId	string	Instrument identifier
orderSide	string	Order side (BUY, SELL)
orderType	string	Order type
status	string	Order status
quantity	string	Order quantity
limitPrice	string	Limit price (if applicable)
executedQuantity	string	Quantity filled
executedCost	string	Total execution cost
averagePrice	string	Average execution price
createdAt	integer	Creation timestamp (milliseconds)
updatedAt	integer	Last update timestamp (milliseconds)

Usage

import requests

headers = {"Authorization": f"Bearer {access_token}"}

# List all orders for a trading account
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/tradeOrder/list",
    headers=headers,
    params={
        "tradingAccountId": "550e8400-e29b-41d4-a716-446655440000",
        "limit": 20
    }
)

orders = response.json()["data"]
for order in orders:
    print(f"{order['tradeOrderId']}: {order['status']}")

# List open orders only
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/tradeOrder/list",
    headers=headers,
    params={
        "tradingAccountId": "550e8400-e29b-41d4-a716-446655440000",
        "status": "OPEN"
    }
)

# List orders for specific instrument
response = requests.get(
    "https://cadenza-api-uat.algo724.com/api/v3/tradeOrder/list",
    headers=headers,
    params={
        "instrumentId": "BINANCE:BTC/USDT",
        "startTime": 1703000000000,
        "endTime": 1703100000000
    }
)

curl "https://cadenza-api-uat.algo724.com/api/v3/tradeOrder/list?tradingAccountId=550e8400-e29b-41d4-a716-446655440000&status=OPEN" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Example Response

{
  "data": [
    {
      "tradeOrderId": "770e8400-e29b-41d4-a716-446655440002",
      "tradingAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "venue": "BINANCE",
      "instrumentId": "BINANCE:BTC/USDT",
      "baseAsset": "BTC",
      "quoteAsset": "USDT",
      "orderSide": "BUY",
      "orderType": "LIMIT",
      "timeInForce": "GTC",
      "status": "OPEN",
      "limitPrice": "50000.00",
      "quantity": "0.001",
      "executedQuantity": "0",
      "executedCost": "0",
      "averagePrice": "0",
      "createdAt": 1703052635110,
      "updatedAt": 1703052635110
    },
    {
      "tradeOrderId": "770e8400-e29b-41d4-a716-446655440001",
      "tradingAccountId": "550e8400-e29b-41d4-a716-446655440000",
      "venue": "BINANCE",
      "instrumentId": "BINANCE:ETH/USDT",
      "baseAsset": "ETH",
      "quoteAsset": "USDT",
      "orderSide": "SELL",
      "orderType": "MARKET",
      "status": "FILLED",
      "quantity": "0.5",
      "executedQuantity": "0.5",
      "executedCost": "1250.00",
      "averagePrice": "2500.00",
      "createdAt": 1703052600000,
      "updatedAt": 1703052600500
    }
  ],
  "success": true,
  "errno": 0,
  "error": null,
  "pagination": {
    "offset": 0,
    "limit": 10,
    "total": 25
  }
}

Error Responses

HTTP Code	Error	Description
400	Invalid request	Invalid parameter values
401	Unauthorized	Invalid or expired access token

Notes

• Orders are returned in descending order by creation time (newest first) by default
• Use ascending=true to get oldest orders first
• Use time range filters for historical order queries
• For real-time order updates, use the WebSocket API
• The averagePrice is calculated as executedCost / executedQuantity for filled orders