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

# getBotPerformance

> Get bot performance data.



## OpenAPI

````yaml /openapi.yaml get /getBotPerformance
openapi: 3.1.0
info:
  title: AlphaInsider
  version: '1.0'
  description: >-
    The official API and websocket documentation for
    [AlphaInsider.com](https://alphainsider.com/)
servers:
  - url: https://alphainsider.com/api
security: []
tags:
  - name: Introduction
  - name: Authentication
  - name: Users
  - name: Strategies
  - name: Subscriptions
  - name: Payments
  - name: Withdrawals
  - name: Timelines
  - name: Stocks
  - name: Trades
  - name: Webhooks
  - name: Bots
  - name: Websockets
paths:
  /getBotPerformance:
    get:
      tags:
        - Bots
      summary: getBotPerformance
      description: Get bot performance data.
      operationId: getBotPerformance
      parameters:
        - $ref: '#/components/parameters/api_token'
        - name: bot_id
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/bot_id'
        - name: frequency
          in: query
          schema:
            $ref: '#/components/schemas/frequency'
        - name: interval
          in: query
          schema:
            $ref: '#/components/schemas/interval'
        - name: start_date
          in: query
          required: true
          schema:
            $ref: '#/components/schemas/start_date'
        - name: end_date
          in: query
          schema:
            $ref: '#/components/schemas/end_date'
      responses:
        '200':
          description: Request was successful.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    $ref: '#/components/schemas/success'
                  response:
                    type: array
                    description: >-
                      Endpoint-specific response payload, or an error message
                      when `success` is false.
                    items:
                      type: object
                      properties:
                        bot_id:
                          $ref: '#/components/schemas/bot_id'
                        portfolio_value:
                          type: string
                          description: Portfolio value.
                        activity:
                          type: string
                          description: Trade activity label for a performance interval.
                        created_at:
                          $ref: '#/components/schemas/created_at'
              examples:
                '200':
                  value:
                    success: true
                    response:
                      - bot_id: h_zZfeqsX9o8hgB8DVc0P
                        portfolio_value: '100000.000000000000000'
                        activity: ''
                        created_at: '2025-12-09T20:00:00.000Z'
                      - bot_id: h_zZfeqsX9o8hgB8DVc0P
                        portfolio_value: '100000.000000000000000'
                        activity: start
                        created_at: '2025-12-09T21:00:00.000Z'
                      - bot_id: h_zZfeqsX9o8hgB8DVc0P
                        portfolio_value: '100000.000000000000000'
                        activity: info
                        created_at: '2025-12-10T19:00:00.000Z'
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
components:
  parameters:
    api_token:
      in: header
      name: Authorization
      description: User API token.
      required: true
      schema:
        type: string
        format: JWT
  schemas:
    bot_id:
      type: string
      description: AlphaInsider bot identifier.
    frequency:
      type: number
      description: The number of intervals per tick.
      default: 1
    interval:
      type: string
      description: The timeframe per tick.
      enum:
        - hour
        - day
        - week
      default: hour
    start_date:
      type: string
      format: date-time
      description: Start date.
    end_date:
      type: string
      format: date-time
      description: End timestamp for the current period or range.
    success:
      type: boolean
      description: True when the request succeeded.
    created_at:
      type: string
      format: date-time
      description: Creation timestamp.
  responses:
    '400':
      description: Request failed.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                description: False when the request failed.
              response:
                type: string
                description: Error message.
          examples:
            '400':
              value:
                success: false
                response: Request failed.
    '401':
      description: Authentication failed.
      content:
        application/json:
          schema:
            type: object
            properties:
              success:
                type: boolean
                description: False when the request failed.
              response:
                type: string
                description: Error message.
          examples:
            '401':
              value:
                success: false
                response: Authentication failed.

````