v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Agent Portfolios

Get Agent Portfolios

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.


Retrieves all agent-portfolios belonging to the authenticated user.

get/api/v1/agent-portfolios

Headers

x-request-idstring uuid required
Example:32acc979-0a95-4066-92e5-752683408402

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Response

Agent-portfolios retrieved successfully

Example response

{
  "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": [
            211,
            212
          ],
          "scopeNames": [
            "etoro-public:trade.real:read",
            "etoro-public:trade.real:write"
          ],
          "createdAt": "2026-03-01T10:30:00Z"
        }
      ]
    }
  ]
}
All 171 operations