Skip to main content

Leader Create

The /user/leader/create endpoint allows a user to create a new leader profile. This includes profile details, commission, and social links. After successful creation, it returns the newly created leader object.

All decimal values are strings.

Method​

POST /user/leader/create

Request Body​

{
  "name": "AwesomeTrader",
  "avatar": "https://example.com/avatar.png",
  "about": "Experienced trader with focus on BTC and ETH.",
  "commission": "10",
  "socials": [
    { "platform": "x", "link": "https://x.com/leader" },
    { "platform": "telegram", "link": "https://t.me/leader" }
  ],
  "min_copier_balance": "50",
  "is_private": true,
  "show_main_data": false,
  "invite_code": "BARAKA",
  "margins": [
    { "symbol": "USDT", "amount": "2432.422" },
    { "symbol": "XBT", "amount": "0.0005" }
  ]
}

Response​

{
  "status": 200,
  "data": {
    "id": "3423423",
    "user_id": "423423",
    "account_id": "423234",
    "status": 0,
    "name": "My Trading Profile",
    "avatar": "https://example.com/avatar.png",
    "server_id": "",
    "copiers": 0,
    "max_copiers": 0,
    "min_copier_value": "50",
    "aum": "1000",
    "created_at": "2025-06-12T14:00:00Z",
    "is_private": true,
    "updated_at": "2025-06-12T14:00:00Z",
    "about": "Experienced trader with focus on BTC and ETH.",
    "socials": [
      { "platform": "x", "link": "https://x.com/leader" },
      { "platform": "telegram", "link": "https://t.me/leader" }
    ],
    "commission": "0.15",
    "bookmarks": 0,
    "bitmex_id": 123132,
    "meta": {
      "is_private": true,
      "invite_code": "BARAKA",
      "show_main_data": false
    }
  }
}

Fields​

  • name (string, required): Display name of the leader.
  • avatar (string): URL to the leader's avatar image.
  • about (string): Description of the leader.
  • commission (string, required): Commission rate as a decimal string, in percentage e.g. 10 for 10%.
  • socials (array): List of social media links.
    • platform (string): One of x, telegram, discord.
    • link (string): URL to the social profile.
  • start_amount (string, required): Initial AUM for the leader, we'll transfer this amount from leader's main account.
  • min_copier_balance (string, required): Minimum copier balance required to follow.
  • aum (string): Total amount of assets the leader has.
  • created_at (string): Date and time the leader was created.
  • updated_at (string): Date and time the leader was last updated.
  • bitmex_id _(number): Bitmex ID, use this to open the leader subaccount
  • meta (object): Metadata about the leader.
    • is_private (boolean): Whether the leader's profile is private.
    • invite_code (string): Invite code for the leader.
    • show_main_data (boolean): Whether to show main account historical data on the profile.

status​

  • 0: Pending - The leader has been registered but not yet ranked.
  • 1: Active - The leader is currently ranked and can receive copiers.
  • 2: Inactive - The leader was removed