> ## 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.

# Retrieve detailed historical performance metrics and analytics for a specified user

> Returns comprehensive historical monthly and yearly performance data including gain percentages, risk-adjusted returns, and detailed trading statistics. This endpoint provides both aggregated and time-series performance metrics.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/user-info/people/{username}/gain
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/user-info/people/{username}/gain:
    get:
      tags:
        - Users Info
      summary: >-
        Retrieve detailed historical performance metrics and analytics for a
        specified user
      description: >-
        Returns comprehensive historical monthly and yearly performance data
        including gain percentages, risk-adjusted returns, and detailed trading
        statistics. This endpoint provides both aggregated and time-series
        performance metrics.
      operationId: retrieveDetailedHistoricalPerformanceMetricsAnalytics
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: a5e0841a-7a35-4ac3-a809-f89ab032493f
          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.
        - name: username
          description: >-
            Unique identifier of the user whose performance metrics are being
            requested
          in: path
          schema:
            type: string
          required: true
          example: trader123
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/getUserGainResponse'
components:
  schemas:
    getUserGainResponse:
      type: object
      properties:
        monthly:
          type: array
          items:
            $ref: '#/components/schemas/gainEntry'
        yearly:
          type: array
          items:
            $ref: '#/components/schemas/gainEntry'
    gainEntry:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
        gain:
          type: number

````