Skip to content

CreateCopyTradeFollower

Endpoint

POST /copytrade/follower

Authorization

Requires SESSION_CUSTOMER.

Description

Creates follower settings for a customer-owned trading account. This endpoint is available for explicit profile setup and integrations that manage profiles directly. The terminal subscription flow does not require calling it first: POST /copytrade/subscription creates a default profile automatically when none exists for the selected account.

Request

{
  "login": 100002,
  "enabled": 1,
  "manual_trading_mode": 1,
  "max_master_count": 1
}

Fields

Name Type Required Description
login int Yes Customer-owned account login
enabled int No 1 enabled, 0 disabled
manual_trading_mode int No 0 disabled, 1 allow non-copied, 2 allow all
max_master_count int No Maximum distinct active masters; integer >= 1, default 1

Response

Returns the created follower object. The complete response includes saved timestamps:

{
  "id": 12,
  "login": 100002,
  "enabled": 1,
  "manual_trading_mode": 1,
  "max_master_count": 1,
  "created_time": 1780838400,
  "updated_time": 1780838400
}

Errors

HTTP Error Description
409 RET_ERR_DUPLICATE A follower already exists for this login
HTTP Error Description
400 INVALID_DATA Request validation failed
403 INVALID_ACCOUNT Login does not belong to the customer