Close or detach a copy relationship (JSON body)

curl --request POST \
  --url https://public-api.etoro.com/api/v2/trading/copy/demo/close \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "mirrorID": 424242,
  "unregisterType": "Close",
  "clientRequestID": "7f1da128-f516-4710-8474-915566c4b22e"
}
'

import requests

url = "https://public-api.etoro.com/api/v2/trading/copy/demo/close"

payload = {
    "mirrorID": 424242,
    "unregisterType": "Close",
    "clientRequestID": "7f1da128-f516-4710-8474-915566c4b22e"
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    mirrorID: 424242,
    unregisterType: 'Close',
    clientRequestID: '7f1da128-f516-4710-8474-915566c4b22e'
  })
};

fetch('https://public-api.etoro.com/api/v2/trading/copy/demo/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/trading/copy/demo/close",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'mirrorID' => 424242,
    'unregisterType' => 'Close',
    'clientRequestID' => '7f1da128-f516-4710-8474-915566c4b22e'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/trading/copy/demo/close"

	payload := strings.NewReader("{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v2/trading/copy/demo/close")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/trading/copy/demo/close")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}"

response = http.request(request)
puts response.read_body

{
  "token": "7f1da128-f516-4710-8474-915566c4b22e"
}

{
  "error": "MirrorId must be greater than 0"
}

{
  "errorCode": "Unauthorized",
  "errorMessage": "Unauthorized"
}

{
  "errorCode": "InsufficientPermissions",
  "errorMessage": "InsufficientPermissions"
}

{
  "errorCode": "Unauthorized",
  "errorMessage": "Unauthorized"
}

Copy Trading - Demo

Close or detach a copy relationship (JSON body)

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

This action closes the sub-portfolio of the copy relationship. There are 2 ways to close the sub-portfolio: (a) Close — close all positions and withdraw the funds back to the main portfolio balance; (b) Detach — detach the positions from the sub-portfolio and move them into the main portfolio, and withdraw the sub-portfolio cash balance back into the main portfolio balance. These correspond to the unregisterType values Close and Detach. Identical semantics to DELETE /api/v2/trading/copy/demo, with the fields carried in a JSON body instead of query parameters — provided because some HTTP clients and proxies handle DELETE requests with bodies unreliably. The response token is an acknowledgment only: close completion is not pollable through this API.

POST

api

trading

copy

demo

Close or detach a copy relationship (JSON body)

curl --request POST \
  --url https://public-api.etoro.com/api/v2/trading/copy/demo/close \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>' \
  --data '
{
  "mirrorID": 424242,
  "unregisterType": "Close",
  "clientRequestID": "7f1da128-f516-4710-8474-915566c4b22e"
}
'

import requests

url = "https://public-api.etoro.com/api/v2/trading/copy/demo/close"

payload = {
    "mirrorID": 424242,
    "unregisterType": "Close",
    "clientRequestID": "7f1da128-f516-4710-8474-915566c4b22e"
}
headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    mirrorID: 424242,
    unregisterType: 'Close',
    clientRequestID: '7f1da128-f516-4710-8474-915566c4b22e'
  })
};

fetch('https://public-api.etoro.com/api/v2/trading/copy/demo/close', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v2/trading/copy/demo/close",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'mirrorID' => 424242,
    'unregisterType' => 'Close',
    'clientRequestID' => '7f1da128-f516-4710-8474-915566c4b22e'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v2/trading/copy/demo/close"

	payload := strings.NewReader("{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<api-key>")
	req.Header.Add("x-user-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://public-api.etoro.com/api/v2/trading/copy/demo/close")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v2/trading/copy/demo/close")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"mirrorID\": 424242,\n  \"unregisterType\": \"Close\",\n  \"clientRequestID\": \"7f1da128-f516-4710-8474-915566c4b22e\"\n}"

response = http.request(request)
puts response.read_body

{
  "token": "7f1da128-f516-4710-8474-915566c4b22e"
}

{
  "error": "MirrorId must be greater than 0"
}

{
  "errorCode": "Unauthorized",
  "errorMessage": "Unauthorized"
}

{
  "errorCode": "InsufficientPermissions",
  "errorMessage": "InsufficientPermissions"
}

{
  "errorCode": "Unauthorized",
  "errorMessage": "Unauthorized"
}

Authorizations

x-api-key

string

header

default:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

required

API key of the application. Only valid together with the x-user-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it. The pair is granted the same permissions the operation's OAuth scopes describe.

Demo credential for trying the API from these docs: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

x-user-key

string

header

default:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

required

User-specific authentication key. Only valid together with the x-api-key header — the pair is an alternative to OAuth bearer authentication, never sent alongside it.

Demo credential for trying the API from these docs: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

Headers

x-request-id

string<uuid>

required

A unique request identifier.

Example:

"3a328a77-32c1-433f-8781-f0043950ecb7"

Body

application/json

mirrorID

integer<int32>

required

The copy relationship to close, as returned in the status response after a successful registration.

Required range: x >= 1

unregisterType

enum<string>

default:Close

Close liquidates the copy's positions; Detach releases them as self-managed positions.

Available options:

Close,

Detach

clientRequestID

string<uuid> | null

Optional idempotency key: repeated requests with the same value produce the same operation, and the response token echoes it.

Response

Request accepted — acknowledgment only

token

string<uuid>

required

Correlation token for the accepted asynchronous operation.

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Close or detach a copy relationship (JSON body)

Authorizations

Headers

Body

Response