Poll a copy operation's outcome

curl --request GET \
  --url https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId} \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

import requests

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

headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId}', 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/{referenceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId}")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

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

{
  "referenceID": "partner-op-2026-07-15-0001",
  "isSuccess": true,
  "mirrorID": 424242,
  "parentCID": 5551234,
  "parentUsername": "investor-username"
}

Copy Trading - Demo

Poll a copy operation's outcome

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.

Returns the terminal outcome of a copy request for register, add or remove funds, looked up by the referenceID supplied on the copy request. The lookup is case-sensitive and scoped to the authenticated account. On success the response carries the mirrorID used to close the copy later; parentCID and parentUsername are either both present or both absent. This endpoint returns only the status of the copy request, not the status of the mirror sub-portfolio. For sub-portfolio status use a portfolio endpoint.

GET

api

trading

copy

demo

{referenceId}

Poll a copy operation's outcome

curl --request GET \
  --url https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId} \
  --header 'x-api-key: <api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <api-key>'

import requests

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

headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<api-key>",
    "x-user-key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<api-key>',
    'x-user-key': '<api-key>'
  }
};

fetch('https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId}', 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/{referenceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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"
	"net/http"
	"io"
)

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	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>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v2/trading/copy/demo/{referenceId}")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<api-key>")
  .header("x-user-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<api-key>'
request["x-user-key"] = '<api-key>'

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

{
  "referenceID": "partner-op-2026-07-15-0001",
  "isSuccess": true,
  "mirrorID": 424242,
  "parentCID": 5551234,
  "parentUsername": "investor-username"
}

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:

"43a51960-03be-424e-9f51-65446ae76d57"

Path Parameters

referenceId

string

required

The referenceID supplied on the copy request (max 35 characters, case-sensitive).

Response

Terminal operation outcome

Terminal outcome of a copy operation. Fields with no value are omitted from the response rather than sent as null.

referenceID

string

required

The caller-supplied operation reference this status answers.

isSuccess

boolean

required

Whether the copy operation completed successfully.

mirrorID

integer<int32> | null

The copy relationship the operation created or edited — the id used to close it. Present only when isSuccess is true.

parentCID

integer<int32> | null

The copied investor's account id. Either both parentCID and parentUsername are present, or both are absent.

parentUsername

string | null

The copied investor's username. Either both parentCID and parentUsername are present, or both are absent.

errorMessageCode

integer<int32> | null

Machine-readable error code when the operation failed. Values are not currently enumerated — treat as opaque diagnostic data.

failReason

string | null

Human-readable failure reason when the operation failed.

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Poll a copy operation's outcome

Authorizations

Headers

Path Parameters

Response