Skip to content

UpdateCopyTradeFollower

Endpoint

PUT /copytrade/follower/{id}

Authorization

Requires SESSION_CUSTOMER.

Description

Updates follower settings owned by the authenticated customer. If login is changed, the new login must also belong to the customer.

Request

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

Response

Returns the updated 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": 1780838401
}

Changing the follower login is rejected with HTTP 409 RET_USR_HAS_TRADES while an order copied through the existing follower profile is unsettled; the update is not applied.

A create/update/resume that exceeds the follower's distinct active-master limit returns HTTP 409 RET_TRADE_LIMIT_REACHED. The public field accepts integers >= 1 and defaults to 1.

Errors

HTTP Error Description
409 RET_ERR_DUPLICATE A follower already exists for the new login
409 RET_USR_HAS_TRADES Changing login is blocked while copied orders are unsettled

| 409 | RET_TRADE_LIMIT_REACHED | Active distinct-master limit would be exceeded | | 400 | INVALID_DATA | Request validation failed | | 403 | PERMISSION_DENIED | Follower is not owned by the customer | | 403 | INVALID_ACCOUNT | New login does not belong to the customer | | 404 | RET_ERR_NOTFOUND | Follower was not found |