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

# Read a bot's totals

> Totals over every cycle this bot has recorded. Figures accrue to the close of each cycle, or to now while its pair is still held, and partial cycles are counted in `incompleteCycles` rather than dropped.



## OpenAPI

````yaml https://vooi-api-app.fly.dev/swagger/json get /bots/{id}/stats
openapi: 3.1.0
info:
  title: VOOI API
  description: Unified perps API
  version: '1.0'
  contact: {}
servers:
  - url: https://perps-api.vooi.io
security: []
tags: []
paths:
  /bots/{id}/stats:
    get:
      tags:
        - Bots
      summary: Read a bot's totals
      description: >-
        Totals over every cycle this bot has recorded. Figures accrue to the
        close of each cycle, or to now while its pair is still held, and partial
        cycles are counted in `incompleteCycles` rather than dropped.
      operationId: BotController_getBotStats
      parameters:
        - name: id
          required: true
          in: path
          description: Bot identifier
          schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            description: Bot identifier
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BotStatsDto'
        '404':
          description: Bot not found
      security:
        - bearer: []
components:
  schemas:
    BotStatsDto:
      type: object
      properties:
        feesUsd:
          type: string
          description: Trading fees you paid on the cycle, stablecoin fees only.
        fundingUsd:
          type: string
          description: >-
            Funding you received less funding you paid on both legs, from the
            entry until the cycle closed or, while it is open, until now; it can
            lag the venue by up to an hour.
        netPnlUsd:
          type: string
          description: >-
            Realized PnL less fees, plus funding, plus unrealized PnL while the
            cycle is open.
        notionalHoursUsd:
          type: string
          description: >-
            Entry notional multiplied by the hours the pair was held, counted to
            the close or, while the cycle is open, to now; it is zero until the
            entry fills.
        notionalOpenedUsd:
          type: string
          description: What the entry filled, both legs together.
        realizedPnlUsd:
          type: string
          description: Realized PnL the venues reported on the cycle trades.
        unrealizedPnlUsd:
          type: string
          description: >-
            Unrealized PnL on the legs of an open cycle, and zero once the cycle
            closes.
        volumeUsd:
          type: string
          description: Everything the cycle traded, entry and exit, both legs.
        abortedCycles:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: >-
            Cycles whose entry finished without filling, so no pair was ever
            held.
        cycles:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: Cycles the bot has recorded.
        incompleteCycles:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: >-
            Cycles whose figures are partial; every total here is a partial sum
            over the cycles, never null.
        openCycles:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: Cycles whose pair the bot is still working on.
        partialCycles:
          type: integer
          minimum: 0
          maximum: 9007199254740991
          description: >-
            Cycles whose figures stay partial: closed outside the bot, never
            confirmed, missing an order, paid in a non-stablecoin, or closed
            with a gap after the venues were synced. Cycles still syncing are
            counted in `incompleteCycles` only.
      required:
        - feesUsd
        - fundingUsd
        - netPnlUsd
        - notionalHoursUsd
        - notionalOpenedUsd
        - realizedPnlUsd
        - unrealizedPnlUsd
        - volumeUsd
        - abortedCycles
        - cycles
        - incompleteCycles
        - openCycles
        - partialCycles
      title: BotStats
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.