Create Agent Portfolio (v2)

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"
    }
  ]
}

Agent Portfolios

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,000 and agentPortfolioVirtualBalance is$ 10,000, each position is copied at 20% of its size into your account.

POST

api

agent-portfolios

Create Agent Portfolio (v2)

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

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:

"f98931cb-9572-4955-992c-c5eb900d6059"

Body

application/json

investmentAmountInUsd

number

required

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.

Example:

2000

agentPortfolioName

string

required

A unique display name for the agent-portfolio (6-10 characters).

Example:

"MyPort1"

userTokenName

string

required

A human-readable name for the user token provisioned with the agent-portfolio.

Example:

"my-trading-token"

scopeNames

string[]

required

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.

Example:

[
  "etoro-public:trade.real:read",
  "etoro-public:trade.real:write"
]

agentPortfolioDescription

string

An optional description of the agent-portfolio's purpose or strategy.

Example:

"My trading portfolio"

ipsWhitelist

string[]

An optional set of IPv4 addresses allowed to use the provisioned user token.

Example:

["192.168.1.1"]

expiresAt

string<date-time>

An optional expiration date and time (UTC) for the provisioned user token.

Example:

"2026-12-31T23:59:59Z"

Response

Agent-portfolio and user token created successfully

agentPortfolioId

string<uuid>

The unique identifier of the newly created agent-portfolio.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

agentPortfolioName

string

The display name assigned to the agent-portfolio.

Example:

"MyPort1"

agentPortfolioGcid

integer

The GCID associated with the agent-portfolio.

Example:

12345678

agentPortfolioVirtualBalance

number

The fixed virtual balance (in USD) that the agent-portfolio was funded with. The investmentAmountInUsd used to copy is proportional to this balance.

Example:

10000

mirrorId

integer

The Trading API mirror ID for this agent-portfolio's copy trade.

Example:

12345

userTokens

object[]

The user tokens generated during agent-portfolio creation.

Show child attributes

⌘I

Getting started

Guides

Core API

Deprecated

WebSocket API

Vibe Code

AI Agents

Changelog

Create Agent Portfolio (v2)

Authorizations

Headers

Body

Response