Copy Groups

Copy trading groups link multiple accounts so a single decision can flow to all of them. Members carry a quantity multiplier; the master account drives the group when copy_mode=master.

GET /copy-groups

Scope: read:copy_groups

List your copy trading groups with member counts and copy mode (master, any_to_all, manual).

GET /copy-groups/{id}

Scope: read:copy_groups

Single group with members[]. Each member row carries the membership row id, the underlying account_id + account_name + is_archived, the quantity_multiplier applied to copied trades, and sort_order.

---

POST /copy-groups

Scope: write:copy_groups · Plan gate: Pro

Field	Type	Required	Notes
name	string (1–100)	yes
copy_mode	enum	no	master (default), any_to_all, manual.
scale_fees	bool	no	Defaults to true.

You set the master_account_id via PATCH after adding members — the master must already be in the group.

curl -X POST https://app.tradavity.com/api/v1/copy-groups \
  -H "Authorization: Bearer tvty_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"name": "TopStep XFA Multi", "copy_mode": "master"}'

PATCH /copy-groups/{id}

Scope: write:copy_groups

Update name, copy_mode, master_account_id, scale_fees, is_active. Pass master_account_id: null to clear the master. The master_account_id must point at an account currently in the group; otherwise 400.

DELETE /copy-groups/{id}

Scope: write:copy_groups

Hard delete. Cascades:

• Member rows in set_copy_group_accounts (FK CASCADE).
• Goals scoped to this group + their snapshots.
• Strategies bound to this group have copy_group_id nulled (the strategy survives, becomes global).

PUT /copy-groups/{id}/members

Scope: write:copy_groups

Replace the entire member set. Up to 50 members per group.

Member field	Type	Notes
account_id	int	Required. Must be an account you own.
quantity_multiplier	decimal	Defaults to 1.0. Range 0 < multiplier ≤ 999.99.
sort_order	int	Defaults to the array index.

If an account is already a member of a different copy group, the request returns 409 conflict with error.details.conflicting_account_ids. Each account can only belong to one group at a time.

If the existing master_account_id is removed by this PUT (no longer a member), the master is auto-cleared. Set a new master via PATCH afterward.

curl -X PUT "https://app.tradavity.com/api/v1/copy-groups/7/members" \
  -H "Authorization: Bearer tvty_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "members": [
      {"account_id": 192, "quantity_multiplier": 1.0, "sort_order": 0},
      {"account_id": 229, "quantity_multiplier": 0.5, "sort_order": 1}
    ]
  }'