> ## Documentation Index
> Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Agent Portfolios

> Retrieves all agent-portfolios belonging to the authenticated user.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/agent-portfolios
openapi: 3.0.1
info:
  title: eToro Api
  version: v1.206.0
  description: >-
    eToro’s public API provides access to real-time financial data, trading
    insights, and account management features, allowing developers to integrate
    eToro’s services into their applications. With access to market prices,
    historical data, and social trading information, the API empowers users to
    enhance their trading strategies. Designed for security and scalability, the
    eToro API ensures smooth and reliable integration for a variety of financial
    applications.


    For more details on integrating with eToro's public WebSocket service,
    please refer to the dedicated [WebSocket
    documentation](./websocket/websocket-doc.html).
servers:
  - url: https://public-api.etoro.com
    description: eToro Public API
security: []
tags:
  - name: Agent Portfolios
  - name: Watchlists
  - name: Feeds
  - name: Asset Explorer
  - name: Market Data
  - name: Identity
  - name: Notifications
  - name: PI Data
  - name: Comments
  - name: Trading Demo
  - name: Trading Real
  - name: Users Info
  - name: Deprecated
paths:
  /api/v1/agent-portfolios:
    get:
      tags:
        - Agent Portfolios
      summary: Get Agent Portfolios
      description: Retrieves all agent-portfolios belonging to the authenticated user.
      operationId: getAgentPortfolios
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: 19b961aa-15a9-45f1-a59f-43da7f471e5b
          description: A unique request identifier.
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
          description: API key for authentication.
        - name: x-user-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: >-
              eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
          description: User-specific authentication key.
      responses:
        '200':
          description: Agent-portfolios retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAgentPortfoliosResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorCode: Unauthorized
                errorMessage: Unauthorized
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorCode: TooManyRequests
                errorMessage: Too many requests
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                errorCode: UnhandledException
                errorMessage: Global Error
components:
  schemas:
    GetAgentPortfoliosResponse:
      type: object
      properties:
        agentPortfolios:
          type: array
          items:
            $ref: '#/components/schemas/AgentPortfolioItem'
          description: The collection of agent-portfolios owned by the user.
    ErrorResponse:
      type: object
      properties:
        errorCode:
          type: string
          description: >-
            Machine-readable error code (e.g. `ScopeIdInvalid`,
            `ScopeIdsDuplicateItems`).
        errorMessage:
          type: string
          description: Human-readable error description.
    AgentPortfolioItem:
      type: object
      properties:
        agentPortfolioId:
          type: string
          format: uuid
          description: The unique identifier of the agent-portfolio.
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        agentPortfolioName:
          type: string
          description: The display name of the agent-portfolio.
          example: MyPort1
        agentPortfolioGcid:
          type: integer
          description: The GCID associated with the agent-portfolio.
          example: 12345678
        agentPortfolioVirtualBalance:
          type: number
          description: >-
            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:
          type: integer
          description: The Trading API mirror ID for this agent-portfolio's copy trade.
          example: 12345
        createdAt:
          type: string
          format: date-time
          description: When this agent-portfolio was created.
          example: '2026-03-01T10:30:00+00:00'
        userTokens:
          type: array
          items:
            $ref: '#/components/schemas/AgentPortfolioUserTokenItem'
          description: The user tokens associated with this agent-portfolio.
    AgentPortfolioUserTokenItem:
      type: object
      properties:
        userTokenId:
          type: string
          format: uuid
          description: The unique identifier of the user token.
          example: f9e8d7c6-b5a4-3210-fedc-ba9876543210
        userTokenName:
          type: string
          description: The user-defined name for the user token.
          example: my-trading-token
        clientId:
          type: string
          format: uuid
          description: The OAuth client identifier associated with the user token.
          example: c1d2e3f4-a5b6-7890-cdef-123456789abc
        externalApplicationName:
          type: string
          description: The name of the external application registered for this token.
          example: Trading Bot v2
        ipsWhitelist:
          type: array
          items:
            type: string
          description: The set of whitelisted IP addresses authorized to use this token.
          example:
            - 192.168.1.1
        expiresAt:
          type: string
          format: date-time
          description: The expiration date and time of the user token in UTC.
          example: '2026-12-31T23:59:59Z'
        scopeIds:
          type: array
          items:
            type: integer
          description: >-
            The set of permission scope identifiers granted to this token.
            Available scopes: 200 = etoro-public:real:read, 201 =
            etoro-public:demo:read, 202 = etoro-public:real:write, 203 =
            etoro-public:demo:write.
          example:
            - 200
            - 202
        createdAt:
          type: string
          format: date-time
          description: When this user token was created.
          example: '2026-03-01T10:30:00Z'

````