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

# Get trader behavior by plan

> How your traders trade each plan: trade counts and frequency, hold times, win rate and payoff, position size, products, trading style, and how long accounts take to pass or fail. Every figure is given for all plans together, per plan, and per account type within each.

## How trades are counted
A trade is one round trip in one contract, from the fill that opens a position to the fill that leaves it flat. Adding to or partly closing the position stays in the same trade; reversing it closes the trade and opens the next. Hold time runs from the opening to the closing fill, P&L is realized profit or loss before fees, and size is the largest position held. Trades count in the range of their closing fill. `basis` in the response states the full method.

## Trader types
Each account with fills in the range gets one style: **scalper** (median hold under 5 minutes, or 25+ trades per trading day with a median hold under 30 minutes), **swing** (median hold of 4 hours or more), **intraday** (anything else), or **unclassified** (fewer than 5 trades). `traderTypes` counts accounts, never names them: this endpoint returns aggregates only.

## Key fields
| Field | Description |
|-------|-------------|
| `trades` / `tradesPerAccountDay` | Round trips closed in the range, and per account per trading day |
| `avgHoldSeconds` / `medianHoldSeconds` / `holdTimeBuckets` | Hold time, and trades under 1 minute, 1–5 minutes, 5–30 minutes, 30 minutes–2 hours and over 2 hours |
| `winRatePct` / `avgWin` / `avgLoss` / `profitFactor` | Payoff of the trades |
| `outcomes` | Accounts that passed or failed within the range, pass rate, and calendar and trading days from start to the outcome |
| `failureReasons` | Rule categories of the failed accounts |
| `payouts` | Funded-account payouts in the range and days to the first payout |
| `entryHours` | Trades by opening hour, America/Chicago |

Trading days follow the CME session (a day starts at 17:00 America/Chicago). Test accounts are excluded. Results are recomputed at most every 15 minutes, so they can be up to 30 minutes old.

## Filters
| Parameter | Type | Example | Description |
|-----------|------|---------|-------------|
| `startDate` | ISO 8601 | `2026-10-01T00:00:00Z` | Start of the range (inclusive). Defaults to 30 days before endDate |
| `endDate` | ISO 8601 | `2026-11-01T00:00:00Z` | End of the range (exclusive). Defaults to now; at most 62 days after startDate |
| `accountType` | string | `funded` | `evaluation`, `funded` or `competition` |
| `planId` | UUID | `7f8d9e0a-…` | One plan |

## Error codes
| HTTP | Code | When |
|------|------|------|
| 400 | `INVALID_RANGE` | endDate is not after startDate, or they are more than 62 days apart |
| 503 | `REPORT_TIMEOUT` | The report took too long; choose a shorter range or one plan |
| 503 | `FEATURE_NOT_READY` | The report is not available yet |

## Example

```bash
curl "https://api.hyperprop.com/platform/v1/organization/risk/behavior?accountType=evaluation&startDate=2026-10-01T00:00:00Z&endDate=2026-11-01T00:00:00Z" \
  -H "X-API-Key: hp_live_your_key_here"
```

**Permissions:** requires **view** access to "Analytics".

**Access:** read-only and full-access API keys. Dashboard members need view access to Analytics & audit log.



## OpenAPI

````yaml https://api.hyperprop.com/platform/openapi.json get /v1/organization/risk/behavior
openapi: 3.0.0
info:
  title: Hyperprop Platform API
  version: 1.0.0
  description: >-
    REST API for the Hyperprop Trading Platform — provision evaluation and
    funded trading accounts, manage traders and plans, react to account
    lifecycle events via signed webhooks, and reconcile billing. Built for prop
    firms integrating from their own backend.


    Authentication, quick start, error handling, idempotency, pagination, custom
    metadata, webhooks, and the MCP connector are documented at
    https://docs.hyperprop.com.
  x-logo:
    url: https://app.hyperprop.com/logo-icon.svg
    altText: Hyperprop
    href: https://hyperprop.com
servers:
  - url: https://api.hyperprop.com/platform
    description: Production
security: []
tags:
  - name: Trading accounts
    description: Create, update, and inspect trading accounts.
  - name: Traders
    description: Look up and update the traders in your organization.
  - name: Trading plans
    description: Define the plans you sell.
  - name: Trading rules
    description: Define how accounts are evaluated.
  - name: Instruments
    description: >-
      The contracts your organization's accounts can trade, with their
      specifications.
  - name: Lockouts
    description: Pause and resume trading on an account.
  - name: Payouts
    description: Check payout eligibility and record payouts.
  - name: Purchases
    description: Purchases recorded for your organization.
  - name: Time Machine
    description: Restore accounts to an earlier trading day or instant.
  - name: Mass credit
    description: >-
      Credit back losses across many accounts after an incident, as background
      jobs you can follow, pause, export and reverse.
  - name: Webhooks
    description: Register webhook endpoints and inspect deliveries.
  - name: Events
    description: Your organization's event history, to replay or audit what happened.
  - name: Real-time streams
    description: >-
      Live events and trading data over a WebSocket, for dashboards and CRMs
      that update as things happen.
  - name: Reconciliation
    description: Balances, end-of-day snapshots, and fills for reconciliation.
  - name: Analytics
    description: Organization performance, revenue and top traders.
  - name: Risk
    description: Firm profit and loss and plan economics.
  - name: Trader insights
    description: >-
      What your traders hold right now and over time, your top traders, and the
      traders you follow.
  - name: Billing and invoices
    description: >-
      Your Hyperprop invoices, credits and billing details, with usage so far
      this month, billing cycles, forecasts and CSV exports.
  - name: Team and roles
    description: Manage dashboard access for your staff.
  - name: API keys
    description: >-
      Manage your organization's API keys: rotation, read-only keys and IP
      allowlists.
  - name: Logs and health
    description: >-
      API request logs, the audit log, integration health, and idempotency key
      recovery.
  - name: Organization profile
    description: Your organization's profile and logo.
  - name: Support
    description: Open and follow up on support tickets.
  - name: Partner access
    description: >-
      Read a trader's journal as an approved partner app, with the trader's own
      key.
paths:
  /v1/organization/risk/behavior:
    get:
      tags:
        - Risk
      summary: Get trader behavior by plan
      description: >-
        How your traders trade each plan: trade counts and frequency, hold
        times, win rate and payoff, position size, products, trading style, and
        how long accounts take to pass or fail. Every figure is given for all
        plans together, per plan, and per account type within each.


        ## How trades are counted

        A trade is one round trip in one contract, from the fill that opens a
        position to the fill that leaves it flat. Adding to or partly closing
        the position stays in the same trade; reversing it closes the trade and
        opens the next. Hold time runs from the opening to the closing fill, P&L
        is realized profit or loss before fees, and size is the largest position
        held. Trades count in the range of their closing fill. `basis` in the
        response states the full method.


        ## Trader types

        Each account with fills in the range gets one style: **scalper** (median
        hold under 5 minutes, or 25+ trades per trading day with a median hold
        under 30 minutes), **swing** (median hold of 4 hours or more),
        **intraday** (anything else), or **unclassified** (fewer than 5 trades).
        `traderTypes` counts accounts, never names them: this endpoint returns
        aggregates only.


        ## Key fields

        | Field | Description |

        |-------|-------------|

        | `trades` / `tradesPerAccountDay` | Round trips closed in the range,
        and per account per trading day |

        | `avgHoldSeconds` / `medianHoldSeconds` / `holdTimeBuckets` | Hold
        time, and trades under 1 minute, 1–5 minutes, 5–30 minutes, 30 minutes–2
        hours and over 2 hours |

        | `winRatePct` / `avgWin` / `avgLoss` / `profitFactor` | Payoff of the
        trades |

        | `outcomes` | Accounts that passed or failed within the range, pass
        rate, and calendar and trading days from start to the outcome |

        | `failureReasons` | Rule categories of the failed accounts |

        | `payouts` | Funded-account payouts in the range and days to the first
        payout |

        | `entryHours` | Trades by opening hour, America/Chicago |


        Trading days follow the CME session (a day starts at 17:00
        America/Chicago). Test accounts are excluded. Results are recomputed at
        most every 15 minutes, so they can be up to 30 minutes old.


        ## Filters

        | Parameter | Type | Example | Description |

        |-----------|------|---------|-------------|

        | `startDate` | ISO 8601 | `2026-10-01T00:00:00Z` | Start of the range
        (inclusive). Defaults to 30 days before endDate |

        | `endDate` | ISO 8601 | `2026-11-01T00:00:00Z` | End of the range
        (exclusive). Defaults to now; at most 62 days after startDate |

        | `accountType` | string | `funded` | `evaluation`, `funded` or
        `competition` |

        | `planId` | UUID | `7f8d9e0a-…` | One plan |


        ## Error codes

        | HTTP | Code | When |

        |------|------|------|

        | 400 | `INVALID_RANGE` | endDate is not after startDate, or they are
        more than 62 days apart |

        | 503 | `REPORT_TIMEOUT` | The report took too long; choose a shorter
        range or one plan |

        | 503 | `FEATURE_NOT_READY` | The report is not available yet |


        ## Example


        ```bash

        curl
        "https://api.hyperprop.com/platform/v1/organization/risk/behavior?accountType=evaluation&startDate=2026-10-01T00:00:00Z&endDate=2026-11-01T00:00:00Z"
        \
          -H "X-API-Key: hp_live_your_key_here"
        ```


        **Permissions:** requires **view** access to "Analytics".


        **Access:** read-only and full-access API keys. Dashboard members need
        view access to Analytics & audit log.
      operationId: getV1OrganizationRiskBehavior
      parameters:
        - description: >-
            Start of the range (inclusive), ISO 8601. Defaults to 30 days before
            endDate.
          x-format:
            isoDate: true
          name: startDate
          in: query
          example: '2026-10-01T00:00:00Z'
          schema:
            type: string
        - description: >-
            End of the range (exclusive), ISO 8601. Defaults to now. At most 62
            days after startDate.
          x-format:
            isoDate: true
          name: endDate
          in: query
          example: '2026-11-01T00:00:00Z'
          schema:
            type: string
        - description: >-
            Only accounts of this type: `evaluation`, `funded` (simulated funded
            included) or `competition`. Defaults to every type.
          name: accountType
          in: query
          schema:
            type: string
            enum:
              - evaluation
              - funded
              - competition
        - description: Only accounts bought under this plan
          x-format:
            guid: true
          name: planId
          in: query
          example: 7f8d9e0a-1b2c-3d4e-5f60-718293a4b5c6
          schema:
            type: string
        - name: If-None-Match
          in: header
          required: false
          description: >-
            Optional. The `ETag` of the answer you already have. When the answer
            would be the same, the response is `304` without a body.
          example: '"Hq3mB1c0s8n2JkVbQy4Tz9uXw5E"'
          schema:
            type: string
      responses:
        '200':
          description: Trade behavior, trader types and outcomes per plan and account type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TraderBehaviorResponse'
        '304':
          description: >-
            Not modified: the answer is the same as the one whose `ETag` you
            sent in `If-None-Match`. No body; keep using the answer you have.
        '400':
          description: endDate must be after startDate, at most 62 days apart
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model596'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model15'
        '403':
          description: This API key does not have admin permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model511'
        '429':
          description: >-
            Too many requests: this endpoint allows 60 calls per minute per
            organization. Wait the number of seconds in the `Retry-After`
            header. Also returned while your organization already has 6 reports
            being computed at once; wait the `Retry-After` seconds.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Always false on errors
                    example: false
                  statusCode:
                    type: integer
                    example: 429
                  error:
                    type: string
                    example: Too Many Requests
                  message:
                    type: string
                    example: >-
                      Too many requests to this endpoint. Try again in 12
                      second(s).
                  code:
                    type: string
                    enum:
                      - RATE_LIMITED
                    example: RATE_LIMITED
                    description: >-
                      Machine-readable error code — switch on this, not on
                      message text
        '500':
          description: Failed to build the trader behavior report
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model597'
        '503':
          description: >-
            `REPORT_TIMEOUT`: choose a shorter range or one plan.
            `FEATURE_NOT_READY`: the report is not available yet. The report
            took too long right now (`REPORT_TIMEOUT`). Wait the seconds in the
            `Retry-After` header (also `retryAfterSeconds` in the body) before
            asking again; the wait grows while the report keeps running out of
            time.
        '504':
          description: >-
            Gateway Timeout - The request did not complete within 25 seconds
            (`REQUEST_TIMEOUT`). Nothing was changed; retry, or narrow the
            request (for example a shorter date range).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Model598'
      security:
        - X-API-Key: []
components:
  schemas:
    TraderBehaviorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          $ref: '#/components/schemas/Model595'
    Model596:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 400
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: endDate must be after startDate, at most 62 days apart
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: INVALID_RANGE
    Model15:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 401
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Authentication required
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: UNAUTHORIZED
    Model511:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 403
        error:
          type: string
          example: Forbidden
        message:
          type: string
          example: This API key does not have admin permissions
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: INSUFFICIENT_PERMISSIONS
    Model597:
      type: object
      properties:
        success:
          type: boolean
          description: Always false on errors
          example: false
        statusCode:
          type: number
          example: 500
        error:
          type: string
          example: Internal Server Error
        message:
          type: string
          example: Failed to build the trader behavior report
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: BEHAVIOR_ERROR
    Model598:
      type: object
      properties:
        statusCode:
          type: number
          example: 504
        error:
          type: string
          example: Gateway Timeout
        message:
          type: string
          example: >-
            The request did not complete within 25 seconds. Try again, or narrow
            it (for example a shorter date range).
        code:
          type: string
          description: Machine-readable error code — switch on this, not on message text
          example: REQUEST_TIMEOUT
    Model595:
      type: object
      properties:
        organizationId:
          type: string
          example: 55555555-5555-4555-8555-555555555555
        generatedAt:
          type: string
          example: '2026-11-03T15:00:00.000Z'
          x-format:
            isoDate: true
        range:
          $ref: '#/components/schemas/Model587'
        filters:
          $ref: '#/components/schemas/Model588'
        basis:
          type: string
          description: How trades, hold times, trader types and outcomes are derived
          example: >-
            A trade is one round trip in one contract: from the first fill that
            opens a position to the fill that leaves it flat. Adding to or
            partly closing the position stays in the same trade; reversing it
            closes the trade and opens the next. Hold time runs from the opening
            fill to the closing fill, P&L is the realized profit or loss before
            fees, and size is the largest position held. Trades count in the
            range of their closing fill; positions opened more than 7 days
            before the start of the range are not included. Trading days follow
            the CME session (a day starts at 17:00 America/Chicago). Trader
            types are per account with fills in the range: under 5 trades is
            unclassified; a median hold under 5 minutes, or 25+ trades per
            trading day with a median hold under 30 minutes, is a scalper; a
            median hold of 4 hours or more is swing; anything else is intraday.
            Outcomes cover accounts that passed or failed within the range. Test
            accounts are excluded.
        totals:
          $ref: '#/components/schemas/BehaviorTotals'
        plans:
          $ref: '#/components/schemas/Model594'
    Model587:
      type: object
      description: The range covered
      properties:
        startDate:
          type: string
          example: '2026-10-04T15:00:00.000Z'
          x-format:
            isoDate: true
        endDate:
          type: string
          example: '2026-11-03T15:00:00.000Z'
          x-format:
            isoDate: true
    Model588:
      type: object
      properties:
        accountType:
          $ref: '#/components/schemas/accountType'
        planId:
          type: string
          example: null
          x-format:
            guid: true
    BehaviorTotals:
      type: object
      description: Every plan together
      properties:
        accountsTraded:
          type: integer
          description: Accounts with at least one fill in the range
          example: 412
        tradingDays:
          type: integer
          description: >-
            Account trading days with at least one fill (one account trading on
            5 days counts 5)
          example: 3180
        trades:
          type: integer
          description: Round-trip trades closed in the range
          example: 28640
        tradesPerAccountDay:
          type: number
          description: trades ÷ tradingDays
          example: 9.01
        avgHoldSeconds:
          type: integer
          description: Average hold time of a trade, in seconds
          example: 724
        medianHoldSeconds:
          type: integer
          example: 186
        winRatePct:
          type: number
          description: >-
            Trades with a realized profit ÷ all trades × 100 (break-even trades
            count as neither win nor loss)
          example: 47.3
        avgWin:
          type: number
          description: Average realized profit of a winning trade
          example: 182.4
        avgLoss:
          type: number
          description: Average realized loss of a losing trade, as a positive amount
          example: 205.1
        profitFactor:
          type: number
          description: Gross profit ÷ gross loss. Null without losing trades
          example: 0.79
        netPnl:
          type: number
          description: Sum of realized P&L of the trades, before fees
          example: -410220.5
        avgContracts:
          type: number
          description: Average largest position held per trade, in contracts
          example: 2.4
        longSharePct:
          type: number
          description: Share of trades that were long
          example: 54.2
        holdTimeBuckets:
          $ref: '#/components/schemas/holdTimeBuckets'
        traderTypes:
          $ref: '#/components/schemas/traderTypes'
        outcomes:
          $ref: '#/components/schemas/outcomes'
        failureReasons:
          $ref: '#/components/schemas/failureReasons'
        topProducts:
          $ref: '#/components/schemas/Model589'
        entryHours:
          $ref: '#/components/schemas/entryHours'
        payouts:
          $ref: '#/components/schemas/Model590'
        byAccountType:
          $ref: '#/components/schemas/byAccountType'
    Model594:
      type: array
      description: One entry per plan with activity in the range, most trades first
      items:
        $ref: '#/components/schemas/BehaviorPlan'
    accountType:
      type: string
      example: null
      enum:
        - evaluation
        - funded
        - competition
    holdTimeBuckets:
      type: object
      description: Trades by hold time
      properties:
        under1m:
          type: integer
          example: 6120
        from1to5m:
          type: integer
          example: 9840
        from5to30m:
          type: integer
          example: 8710
        from30mTo2h:
          type: integer
          example: 3150
        over2h:
          type: integer
          example: 820
    traderTypes:
      type: object
      description: Accounts by trading style in the range (see `basis`)
      properties:
        scalper:
          type: integer
          example: 131
        intraday:
          type: integer
          example: 214
        swing:
          type: integer
          example: 12
        unclassified:
          type: integer
          example: 55
    outcomes:
      type: object
      properties:
        passed:
          type: integer
          description: Accounts that passed within the range
          example: 38
        failed:
          type: integer
          description: Accounts that failed within the range
          example: 301
        passRatePct:
          type: number
          description: passed ÷ (passed + failed) × 100
          example: 11.21
        avgDaysToPass:
          type: number
          description: Calendar days from the account's start to passing
          example: 9.4
        medianDaysToPass:
          type: number
          example: 7.8
        avgDaysToFail:
          type: number
          example: 5.1
        medianDaysToFail:
          type: number
          example: 3.2
        avgTradingDaysToPass:
          type: number
          description: Days with at least one fill from start to passing
          example: 6.3
        avgTradingDaysToFail:
          type: number
          example: 3.9
    failureReasons:
      type: array
      description: Rule categories of the failed accounts, most common first
      items:
        $ref: '#/components/schemas/BehaviorFailureReason'
    Model589:
      type: array
      description: The 5 most traded products
      items:
        $ref: '#/components/schemas/BehaviorProduct'
    entryHours:
      type: array
      description: Trades by the hour they were opened, 0–23 in America/Chicago
      example:
        - 12
        - 4
        - 2
        - 1
        - 0
        - 3
        - 18
        - 210
        - 3420
        - 6110
        - 4180
        - 2650
        - 1980
        - 1450
        - 1210
        - 980
        - 0
        - 0
        - 0
        - 40
        - 120
        - 80
        - 30
        - 20
      x-constraint:
        length: 24
      items:
        type: integer
    Model590:
      type: object
      properties:
        count:
          type: integer
          description: Payouts in the range (funded accounts)
          example: 21
        amount:
          type: number
          example: 42600
        accountsWithPayouts:
          type: integer
          example: 17
        avgDaysToFirstPayout:
          type: number
          description: 'For first payouts in the range: days from the funded account''s start'
          example: 18.6
    byAccountType:
      type: array
      description: The same figures per account type with activity in the range
      items:
        $ref: '#/components/schemas/BehaviorAccountTypeMetrics'
    BehaviorPlan:
      type: object
      properties:
        planId:
          type: string
          description: Null for accounts created without a plan
          example: 7f8d9e0a-1b2c-3d4e-5f60-718293a4b5c6
          x-format:
            guid: true
        planName:
          type: string
          example: 50K Pro
        accountSize:
          type: number
          example: 50000
        accountsTraded:
          type: integer
          description: Accounts with at least one fill in the range
          example: 412
        tradingDays:
          type: integer
          description: >-
            Account trading days with at least one fill (one account trading on
            5 days counts 5)
          example: 3180
        trades:
          type: integer
          description: Round-trip trades closed in the range
          example: 28640
        tradesPerAccountDay:
          type: number
          description: trades ÷ tradingDays
          example: 9.01
        avgHoldSeconds:
          type: integer
          description: Average hold time of a trade, in seconds
          example: 724
        medianHoldSeconds:
          type: integer
          example: 186
        winRatePct:
          type: number
          description: >-
            Trades with a realized profit ÷ all trades × 100 (break-even trades
            count as neither win nor loss)
          example: 47.3
        avgWin:
          type: number
          description: Average realized profit of a winning trade
          example: 182.4
        avgLoss:
          type: number
          description: Average realized loss of a losing trade, as a positive amount
          example: 205.1
        profitFactor:
          type: number
          description: Gross profit ÷ gross loss. Null without losing trades
          example: 0.79
        netPnl:
          type: number
          description: Sum of realized P&L of the trades, before fees
          example: -410220.5
        avgContracts:
          type: number
          description: Average largest position held per trade, in contracts
          example: 2.4
        longSharePct:
          type: number
          description: Share of trades that were long
          example: 54.2
        holdTimeBuckets:
          $ref: '#/components/schemas/holdTimeBuckets'
        traderTypes:
          $ref: '#/components/schemas/traderTypes'
        outcomes:
          $ref: '#/components/schemas/outcomes'
        failureReasons:
          $ref: '#/components/schemas/failureReasons'
        topProducts:
          $ref: '#/components/schemas/Model593'
        entryHours:
          $ref: '#/components/schemas/entryHours'
        payouts:
          $ref: '#/components/schemas/Model590'
        byAccountType:
          $ref: '#/components/schemas/byAccountType'
    BehaviorFailureReason:
      type: object
      properties:
        category:
          type: string
          example: Max drawdown
        count:
          type: integer
          example: 164
    BehaviorProduct:
      type: object
      properties:
        symbol:
          type: string
          description: Product (root symbol)
          example: MNQ
        trades:
          type: integer
          example: 15210
        contracts:
          type: number
          description: Sum of the largest position of each trade
          example: 41870
        sharePct:
          type: number
          description: Share of all trades in this group
          example: 53.11
    BehaviorAccountTypeMetrics:
      type: object
      properties:
        accountType:
          $ref: '#/components/schemas/Model591'
        accountsTraded:
          type: integer
          description: Accounts with at least one fill in the range
          example: 412
        tradingDays:
          type: integer
          description: >-
            Account trading days with at least one fill (one account trading on
            5 days counts 5)
          example: 3180
        trades:
          type: integer
          description: Round-trip trades closed in the range
          example: 28640
        tradesPerAccountDay:
          type: number
          description: trades ÷ tradingDays
          example: 9.01
        avgHoldSeconds:
          type: integer
          description: Average hold time of a trade, in seconds
          example: 724
        medianHoldSeconds:
          type: integer
          example: 186
        winRatePct:
          type: number
          description: >-
            Trades with a realized profit ÷ all trades × 100 (break-even trades
            count as neither win nor loss)
          example: 47.3
        avgWin:
          type: number
          description: Average realized profit of a winning trade
          example: 182.4
        avgLoss:
          type: number
          description: Average realized loss of a losing trade, as a positive amount
          example: 205.1
        profitFactor:
          type: number
          description: Gross profit ÷ gross loss. Null without losing trades
          example: 0.79
        netPnl:
          type: number
          description: Sum of realized P&L of the trades, before fees
          example: -410220.5
        avgContracts:
          type: number
          description: Average largest position held per trade, in contracts
          example: 2.4
        longSharePct:
          type: number
          description: Share of trades that were long
          example: 54.2
        holdTimeBuckets:
          $ref: '#/components/schemas/holdTimeBuckets'
        traderTypes:
          $ref: '#/components/schemas/traderTypes'
        outcomes:
          $ref: '#/components/schemas/outcomes'
        failureReasons:
          $ref: '#/components/schemas/failureReasons'
        topProducts:
          $ref: '#/components/schemas/Model592'
        entryHours:
          $ref: '#/components/schemas/entryHours'
        payouts:
          $ref: '#/components/schemas/Model590'
    Model593:
      type: array
      description: The 5 most traded products
      items:
        $ref: '#/components/schemas/BehaviorProduct'
    Model591:
      type: string
      description: >-
        `evaluation`, `funded` (simulated funded included) or `competition`;
        `other` for accounts without a recognised type
      example: evaluation
      enum:
        - evaluation
        - funded
        - competition
        - other
    Model592:
      type: array
      description: The 5 most traded products
      items:
        $ref: '#/components/schemas/BehaviorProduct'
  securitySchemes:
    X-API-Key:
      type: apiKey
      name: X-API-Key
      in: header
      description: >-
        Organization API key (`hp_live_...`), sent in the `X-API-Key` header.
        Create, rotate and restrict keys in the dashboard or with the API keys
        endpoints; an organization can have two active keys, so you can rotate
        without downtime. A **full-access** key can call every endpoint in this
        reference. A **read-only** key can call `GET` endpoints (and create a
        trading stream token); any other request returns `403 READ_ONLY_KEY`. A
        key with an IP allowlist returns `403 IP_NOT_ALLOWED` from any other
        address. Each endpoint lists which keys can call it under **Access**.

````

## Related topics

- [Get plan performance by purchase month](https://docs.hyperprop.com/platform-api/risk/get-plan-performance-by-purchase-month.md)
- [Rate limits & quotas](https://docs.hyperprop.com/concepts/rate-limits.md)
- [Get trading plans for your organization](https://docs.hyperprop.com/platform-api/trading-plans/get-trading-plans-for-your-organization.md)
- [Get a specific trading plan](https://docs.hyperprop.com/platform-api/trading-plans/get-a-specific-trading-plan.md)
- [Get a specific purchase](https://docs.hyperprop.com/platform-api/purchases/get-a-specific-purchase.md)


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