Skip to main content

Copier Trades

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

Method

GET /user/copier/trades/:copierID

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": "79045471057741106",
"parent_id": "78276517955634603",
"exec_id": "00000000-006d-1000-0000-0019e62a69ee",
"order_id": "988b85da-da5d-45ef-b85f-ebe2a389208d",
"client_order_id": "LOTCOPY90yDNTPQyNb11",
"symbol": "XBTUSDT",
"side": "buy",
"qty": "0.0007",
"leaves_qty": "0",
"fee_type": "Taker",
"base_currency": "XBT",
"quote_currency": "USDT",
"exec_price": "106603.4",
"realized_pnl": "0",
"commission": "0.037311",
"created_at": "2025-06-16T06:44:28.234Z"
}
]
}

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.