Copier List

The /user/copier/list endpoint returns a list of copy bots created by the user, along with performance metrics and status. It supports filtering by status to allow users to view running or stopped bots.

We return all copier bots, do any pagination on front-end if required.

Method

GET /user/copier/list

Query Parameters

Name	Type	Description
status	int	Filter bots by status: 1 for running, 2 for stopped. Defaults to 1 (running)

Response

{
  "status": 200,
  "data": {
    "total_earning": "325.75",
    "total_balance": "1245.90",
    "fetching_count": 0,
    "copiers": [
      {
        "id": "8723612873",
        "name": "MomentumBotX",
        "avatar": "avatar_url_1",
        "roi": "13.42",
        "pnl": "110.67",
        "initial_balance": "823.15",
        "final_balance": "933.82",
        "status": 1,
        "created_at": 1716805210000,
        "updated_at": 1719023456000,
        "leader_id": "15313220168320001",
        "leader_status": 1,
        "is_fetching": false,
        "meta": {
          "stop_reason": "user_self",
          "stop_loss": "10",
          "take_profit": "10",
          "commission": "15",
          "is_inverse": false
        }
      },
      {
        "id": "8723612874",
        "name": "MeanRevertPro",
        "avatar": "avatar_url_2",
        "roi": "-2.35",
        "pnl": "-25.10",
        "initial_balance": "1000.00",
        "final_balance": "974.90",
        "status": 2,
        "created_at": 1715023000000,
        "updated_at": 1717823400000,
        "leader_id": "15313220168320002",
        "end_at": "1750838881564",
        "leader_status": 1,
        "is_fetching": false,
        "meta": {
          "stop_reason": "stop_loss",
          "stop_loss": "10",
          "take_profit": "10",
          "commission": "15",
          "is_inverse": true
        }
      }
    ]
  }
}

Fields Explained

Copier Entry (copiers)

• id: Unique identifier of the copier bot.
• name: Display name of the leader.
• avatar: URL to the leader's avatar image.
• roi: Return on investment since bot started (%).
• pnl: Profit or loss since bot started (USD).
• initial_balance: Balance at start of the copier bot (USD).
• final_balance: Latest balance (USD).
• status: Bot status — 1 for running, 2 for stopped.
• created_at: Timestamp when the copier bot was created (milliseconds since epoch).
• updated_at: Timestamp of the last update (milliseconds since epoch).
• leader_id: ID of the leader this bot belongs to.
• leader_status: Status of the leader this bot belongs to — 1 for active, 2 for inactive.
• meta: Copier settings.
• end_at: Timestamp when the copier bot was stopped (milliseconds since epoch).
• is_fetching: Indicates if the copier bot initial balance is still fetching.

Meta Fields

• stop_reason: Reason for stopping the copier bot. Possible values are:
  • stop_loss: Stopped due to reaching the stop loss threshold.
  • take_profit: Stopped due to reaching the take profit threshold.
  • user_self: Stopped by the user.
  • user_key: Stopped due to an error with the API key.
  • user_balance: Stopped due to insufficient balance.
  • liquidation: Stopped due to liquidation.
  • leader_left: Stopped due to the leader leaving.

Summary Fields

• total_earning: Combined profit/loss across all copier bots (USD).
• total_balance: Combined current balance across all copier bots (USD).
• fetching_count: Number of copier bots still fetching their initial balance.