Skip to content

UpdateCopyTradeSubscription

Endpoint

PUT /copytrade/subscription/{id}

Authorization

Requires SESSION_CUSTOMER.

Description

Updates a subscription owned by the authenticated customer through its follower account.

If master_login or follower_login is changed, the server revalidates ownership, master visibility and follower mode policy.

If the resulting subscription has copy_existing_positions = 1, the backend queues copy execution for currently open master market positions. Already linked master orders are skipped.

Runtime notes:

  • volume_mode = 0 uses fixed_volume;
  • volume_mode = 1 uses master_volume * risk_multiplier;
  • volume_mode = 2 uses follower/master equity ratio;
  • volume_mode = 3 uses follower/master balance ratio;
  • reverse_direction = 1 opens the opposite market direction and swaps copied SL/TP meaning;
  • copy_pending_orders is accepted by the model but pending order copy is not executed yet.

Request

{
  "enabled": 1,
  "status": 0,
  "risk_multiplier": 0.5,
  "copy_sl": 1,
  "copy_tp": 1
}

Response

Returns the updated subscription object.

Errors

HTTP Error Description
400 INVALID_DATA Request validation failed
403 PERMISSION_DENIED Subscription is not owned through follower account
403 INVALID_FOLLOWER_ACCOUNT Follower login does not belong to customer
403 MASTER_NOT_FOUND Master profile was not found
403 MASTER_NOT_AVAILABLE Master is not available
403 FOLLOWER_NOT_FOUND Follower profile was not found
403 FOLLOWER_MODE_NOT_ALLOWED Master does not allow follower account mode
404 RET_ERR_NOTFOUND Subscription was not found