Skip to main content
GET
/
api
/
v1
/
agent-portfolios
Get Agent Portfolios
curl --request GET \
  --url https://public-api.etoro.com/api/v1/agent-portfolios \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "agentPortfolios": [
    {
      "agentPortfolioId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "agentPortfolioName": "MyPort1",
      "agentPortfolioGcid": 12345678,
      "agentPortfolioVirtualBalance": 10000,
      "mirrorId": 12345,
      "createdAt": "2026-03-01T10:30:00+00:00",
      "userTokens": [
        {
          "userTokenId": "f9e8d7c6-b5a4-3210-fedc-ba9876543210",
          "userTokenName": "my-trading-token",
          "clientId": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
          "externalApplicationName": "Trading Bot v2",
          "ipsWhitelist": [
            "192.168.1.1"
          ],
          "expiresAt": "2026-12-31T23:59:59Z",
          "scopeIds": [
            200,
            202
          ],
          "createdAt": "2026-03-01T10:30:00Z"
        }
      ]
    }
  ]
}

Headers

x-request-id
string<uuid>
required

A unique request identifier.

Example:

"f3cdeba5-b2ea-4fe0-b360-af978972d97e"

x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Response

Agent-portfolios retrieved successfully

agentPortfolios
object[]

The collection of agent-portfolios owned by the user.