Skip to main content

Leader Update

The /user/leader/update endpoint allows an authenticated user to update their copy trading leader profile. Only the owner of the leader profile can perform this action.

Method​

POST /user/leader/update

Request Body​

Important!! if you don't wish to update a value do not add it on the json body, not even nulls or undefined. Only add the fields you wish to update.

{
  "id": "0123198321",
  "name": "Alpha Trader",
  "avatar": "https://cdn.bitmex.com/avatar.png",
  "max_copiers": 100,
  "min_copier_value": "50.0",
  "about": "Seasoned crypto trader with 5 years of experience.",
  "socials": [
    {
      "platform": "x",
      "link": "https://x.com/alphatrader"
    },
    {
      "platform": "telegram",
      "link": "https://t.me/alphatrader"
    }
  ],
  "commission": "10",
  "is_private": true,
  "show_main_data": false,
  "invite_code": "BARAKA"
}

Fields​

  • id (string, required): UUID of the leader to update.
  • name (string, optional): Display name for the leader.
  • avatar (string, optional): URL to the leader's avatar image.
  • max_copiers (int, optional): Max number of allowed copiers.
  • min_copier_value (string, optional): Minimum balance (in USDT) a copier must have to copy this leader.
  • about (string, optional): Short description or bio.
  • socials (array, optional): List of social profiles.
    • platform: One of "x", "discord", "telegram".
    • link: URL to the social profile.
  • commission (string, optional): Commission rate in percentage e.g. 10 for 10%
  • is_private (boolean, optional): Whether the leader profile is private. If true, only users with the invite code can view the profile.
  • invite_code (string, optional): Invite code for the leader. Leave empty if you don't want to update.
  • show_main_data (boolean, optional): Whether to show main account historical data on the profile.

Response​

{
  "status": 200,
  "data": {
    "success": true
  }
}

Errors​

  • 400 Bad Request: Invalid or missing parameters.
  • 401 Unauthorized: User is not the owner of the leader profile.
  • 500 Internal Server Error: Unexpected server error.