curl --request POST \
--url https://public-api.etoro.com/api/v2/agent-portfolios \
--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 '
{
"investmentAmountInUsd": 2000,
"agentPortfolioName": "MyPort1",
"userTokenName": "my-trading-token",
"scopeNames": [
"etoro-public:trade.real:read",
"etoro-public:trade.real:write"
],
"agentPortfolioDescription": "My trading portfolio",
"ipsWhitelist": [
"192.168.1.1"
],
"expiresAt": "2026-12-31T23:59:59Z"
}
'import requests
url = "https://public-api.etoro.com/api/v2/agent-portfolios"
payload = {
"investmentAmountInUsd": 2000,
"agentPortfolioName": "MyPort1",
"userTokenName": "my-trading-token",
"scopeNames": ["etoro-public:trade.real:read", "etoro-public:trade.real:write"],
"agentPortfolioDescription": "My trading portfolio",
"ipsWhitelist": ["192.168.1.1"],
"expiresAt": "2026-12-31T23:59:59Z"
}
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({
investmentAmountInUsd: 2000,
agentPortfolioName: 'MyPort1',
userTokenName: 'my-trading-token',
scopeNames: ['etoro-public:trade.real:read', 'etoro-public:trade.real:write'],
agentPortfolioDescription: 'My trading portfolio',
ipsWhitelist: ['192.168.1.1'],
expiresAt: '2026-12-31T23:59:59Z'
})
};
fetch('https://public-api.etoro.com/api/v2/agent-portfolios', 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/agent-portfolios",
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([
'investmentAmountInUsd' => 2000,
'agentPortfolioName' => 'MyPort1',
'userTokenName' => 'my-trading-token',
'scopeNames' => [
'etoro-public:trade.real:read',
'etoro-public:trade.real:write'
],
'agentPortfolioDescription' => 'My trading portfolio',
'ipsWhitelist' => [
'192.168.1.1'
],
'expiresAt' => '2026-12-31T23:59:59Z'
]),
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/agent-portfolios"
payload := strings.NewReader("{\n \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\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/agent-portfolios")
.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 \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v2/agent-portfolios")
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 \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\n}"
response = http.request(request)
puts response.read_body{
"agentPortfolioId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"agentPortfolioName": "MyPort1",
"agentPortfolioGcid": 12345678,
"agentPortfolioVirtualBalance": 10000,
"mirrorId": 12345,
"userTokens": [
{
"userTokenId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
"userToken": "sk_live_a1b2c3d4e5f6...",
"userTokenName": "my-trading-token",
"clientId": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
"ipsWhitelist": [
"192.168.1.1"
],
"scopes": [
{
"name": "etoro-public:trade.real:read"
}
],
"expiresAt": "2026-12-31T23:59:59Z"
}
]
}Create Agent Portfolio (v2)
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.
Creates a new agent-portfolio using scope names. Scopes are specified by name (scopeNames); scope ids are not supported in v2. IMPORTANT: investmentAmountInUsd is the amount deducted from YOUR (the caller’s) account balance to copy-trade this agent-portfolio — it is NOT the agent-portfolio’s own balance. Positions are mirrored proportionally: e.g. if you invest 2,000andagentPortfolioVirtualBalanceis10,000, each position is copied at 20% of its size into your account.
curl --request POST \
--url https://public-api.etoro.com/api/v2/agent-portfolios \
--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 '
{
"investmentAmountInUsd": 2000,
"agentPortfolioName": "MyPort1",
"userTokenName": "my-trading-token",
"scopeNames": [
"etoro-public:trade.real:read",
"etoro-public:trade.real:write"
],
"agentPortfolioDescription": "My trading portfolio",
"ipsWhitelist": [
"192.168.1.1"
],
"expiresAt": "2026-12-31T23:59:59Z"
}
'import requests
url = "https://public-api.etoro.com/api/v2/agent-portfolios"
payload = {
"investmentAmountInUsd": 2000,
"agentPortfolioName": "MyPort1",
"userTokenName": "my-trading-token",
"scopeNames": ["etoro-public:trade.real:read", "etoro-public:trade.real:write"],
"agentPortfolioDescription": "My trading portfolio",
"ipsWhitelist": ["192.168.1.1"],
"expiresAt": "2026-12-31T23:59:59Z"
}
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({
investmentAmountInUsd: 2000,
agentPortfolioName: 'MyPort1',
userTokenName: 'my-trading-token',
scopeNames: ['etoro-public:trade.real:read', 'etoro-public:trade.real:write'],
agentPortfolioDescription: 'My trading portfolio',
ipsWhitelist: ['192.168.1.1'],
expiresAt: '2026-12-31T23:59:59Z'
})
};
fetch('https://public-api.etoro.com/api/v2/agent-portfolios', 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/agent-portfolios",
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([
'investmentAmountInUsd' => 2000,
'agentPortfolioName' => 'MyPort1',
'userTokenName' => 'my-trading-token',
'scopeNames' => [
'etoro-public:trade.real:read',
'etoro-public:trade.real:write'
],
'agentPortfolioDescription' => 'My trading portfolio',
'ipsWhitelist' => [
'192.168.1.1'
],
'expiresAt' => '2026-12-31T23:59:59Z'
]),
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/agent-portfolios"
payload := strings.NewReader("{\n \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\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/agent-portfolios")
.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 \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.etoro.com/api/v2/agent-portfolios")
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 \"investmentAmountInUsd\": 2000,\n \"agentPortfolioName\": \"MyPort1\",\n \"userTokenName\": \"my-trading-token\",\n \"scopeNames\": [\n \"etoro-public:trade.real:read\",\n \"etoro-public:trade.real:write\"\n ],\n \"agentPortfolioDescription\": \"My trading portfolio\",\n \"ipsWhitelist\": [\n \"192.168.1.1\"\n ],\n \"expiresAt\": \"2026-12-31T23:59:59Z\"\n}"
response = http.request(request)
puts response.read_body{
"agentPortfolioId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"agentPortfolioName": "MyPort1",
"agentPortfolioGcid": 12345678,
"agentPortfolioVirtualBalance": 10000,
"mirrorId": 12345,
"userTokens": [
{
"userTokenId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
"userToken": "sk_live_a1b2c3d4e5f6...",
"userTokenName": "my-trading-token",
"clientId": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
"ipsWhitelist": [
"192.168.1.1"
],
"scopes": [
{
"name": "etoro-public:trade.real:read"
}
],
"expiresAt": "2026-12-31T23:59:59Z"
}
]
}Authorizations
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
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_
Scopes
Grants access to the 'etoro-public:agent-portfolio:write' scope.
Headers
A unique request identifier.
"6445ba50-e9ac-49c8-97eb-346d2db4d237"
Body
The amount in USD deducted from the CALLER's account balance to copy-trade this agent-portfolio. This is NOT the agent-portfolio's own balance — the agent-portfolio receives a separate fixed virtual balance (returned as agentPortfolioVirtualBalance). Positions are mirrored proportionally: e.g. $2,000 with a $10,000 virtual balance = 20% position sizing.
2000
A unique display name for the agent-portfolio (6-10 characters).
"MyPort1"
A human-readable name for the user token provisioned with the agent-portfolio.
"my-trading-token"
The set of permission scope names to grant to the provisioned user token. Available scopes: etoro-public:trade.real:read, etoro-public:trade.real:write, etoro-public:trade.demo:read, etoro-public:trade.demo:write.
[
"etoro-public:trade.real:read",
"etoro-public:trade.real:write"
]
An optional description of the agent-portfolio's purpose or strategy.
"My trading portfolio"
An optional set of IPv4 addresses allowed to use the provisioned user token.
["192.168.1.1"]
An optional expiration date and time (UTC) for the provisioned user token.
"2026-12-31T23:59:59Z"
Response
Agent-portfolio and user token created successfully
The unique identifier of the newly created agent-portfolio.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
The display name assigned to the agent-portfolio.
"MyPort1"
The GCID associated with the agent-portfolio.
12345678
The fixed virtual balance (in USD) that the agent-portfolio was funded with. The investmentAmountInUsd used to copy is proportional to this balance.
10000
The Trading API mirror ID for this agent-portfolio's copy trade.
12345
The user tokens generated during agent-portfolio creation.
Show child attributes
Show child attributes