Leader Trades

The /leader/trades/:leaderID endpoint returns a list of executed trades for a specific leader. This is typically used to display recent trading activity, including fills, commissions, and realized PnL.

Method

GET /leader/trades/:leaderID

• :leaderID — the unique identifier of the leader whose trade history is being requested.

Query Parameters

• before (optional) — ISO 8601 timestamp. Returns trades executed before the specified time. Defaults to end of day today (UTC).
• limit (optional) — Maximum number of trades to return. Integer between 1 and 50. Defaults to 30.

Response

{
  "status": 200,
  "data": [
    {
      "id": "58758078874519417",
      "parent_id": "15313220168320001",
      "exec_id": "00000000-006d-1000-0000-001851502b5b",
      "order_id": "727dfc6d-e92c-4201-83ba-2650a89a456c",
      "symbol": "XBTUSDT",
      "side": "sell",
      "qty": "-0.001",
      "fee_type": "Taker",
      "base_currency": "XBT",
      "quote_currency": "USDT",
      "exec_price": "102239.9",
      "realized_pnl": "0",
      "commission": "0.051119",
      "created_at": "2025-05-19T06:57:02.686Z"
    }
  ]
}

Fields Explained

Each item in the response array represents an executed trade.

• id: Unique identifier of the trade entry.
• parent_id: The leader ID this trade belongs to.
• exec_id: Execution ID from the exchange.
• order_id: Order ID associated with this execution.
• symbol: Trading pair symbol (e.g., XBTUSDT).
• side: Trade direction, either buy or sell.
• qty: Quantity executed in base currency (e.g., XBT, ETH, SOL).
• fee_type: Execution fee type, either Maker or Taker.
• base_currency: The base currency of the trade.
• quote_currency: The quote currency of the trade.
• exec_price: Execution price at which the order was filled.
• realized_pnl: Realized profit or loss for this execution (in USD).
• commission: Fee paid for the execution (in USD).
• created_at: ISO 8601 timestamp when the trade was executed.