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

# Check portfolio heat

> Check current portfolio heat against tier limits.

## Heat Calculation

Portfolio heat = sum(position_heat) / account_value

Where position_heat = position_value × risk_percentage

## Heat Status Levels

- **green**: Below 50% of max heat - can add positions freely
- **yellow**: 50-75% of max heat - caution on new positions
- **orange**: 75-90% of max heat - reduce position sizes
- **red**: 90-100% of max heat - no new positions

## Response

- **current_heat_pct**: Current portfolio heat percentage
- **max_heat_pct**: Maximum allowed for account tier
- **heat_status**: Color-coded status (green/yellow/orange/red)
- **can_add_position**: Whether new positions are allowed
- **remaining_heat_pct**: Available heat capacity

## Performance Target

<100ms response time.



## OpenAPI

````yaml /api/openapi.json get /api/graph/v1/risk/heat
openapi: 3.1.0
info:
  title: Sequency Graph API
  description: >

    # Sequency Graph-Native Trading API


    Graph-native API for trading intelligence, built on FalkorDB.


    ## Features


    - **Screener**: Filter stocks using graph-native queries with relationship
    expansion

    - **Stock Detail**: Complete stock context with all relationships

    - **Confluence Scoring**: Setup quality assessment with weighted components

    - **Strategy Matching**: Find matching options strategies via graph
    traversal

    - **Market Context**: Current market-wide context for trading decisions


    ## Data Sources


    All data is sourced from the FalkorDB knowledge graph, populated by:

    - Pattern detector (Go) - Technical indicators, patterns

    - Graph sync service - Levels, volume profiles, news, day classification
  version: 1.0.0
servers: []
security: []
paths:
  /api/graph/v1/risk/heat:
    get:
      tags:
        - Risk Management
      summary: Check portfolio heat
      description: |-
        Check current portfolio heat against tier limits.

        ## Heat Calculation

        Portfolio heat = sum(position_heat) / account_value

        Where position_heat = position_value × risk_percentage

        ## Heat Status Levels

        - **green**: Below 50% of max heat - can add positions freely
        - **yellow**: 50-75% of max heat - caution on new positions
        - **orange**: 75-90% of max heat - reduce position sizes
        - **red**: 90-100% of max heat - no new positions

        ## Response

        - **current_heat_pct**: Current portfolio heat percentage
        - **max_heat_pct**: Maximum allowed for account tier
        - **heat_status**: Color-coded status (green/yellow/orange/red)
        - **can_add_position**: Whether new positions are allowed
        - **remaining_heat_pct**: Available heat capacity

        ## Performance Target

        <100ms response time.
      operationId: check_portfolio_heat_api_graph_v1_risk_heat_get
      parameters:
        - name: account_id
          in: query
          required: true
          schema:
            type: string
            format: uuid
            description: Account UUID
            title: Account Id
          description: Account UUID
        - name: account_value
          in: query
          required: true
          schema:
            type: number
            exclusiveMinimum: 0
            description: Current account value in USD
            title: Account Value
          description: Current account value in USD
        - name: tier
          in: query
          required: false
          schema:
            anyOf:
              - type: integer
                maximum: 3
                minimum: 1
              - type: 'null'
            description: >-
              Account tier (1-3). If not provided, calculated from account
              value.
            title: Tier
          description: Account tier (1-3). If not provided, calculated from account value.
      responses:
        '200':
          description: Portfolio heat status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PortfolioHeatResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PortfolioHeatResponse:
      properties:
        account_id:
          type: string
          format: uuid
          title: Account Id
        current_heat_pct:
          type: number
          title: Current Heat Pct
        max_heat_pct:
          type: number
          title: Max Heat Pct
        heat_status:
          type: string
          title: Heat Status
        can_add_position:
          type: boolean
          title: Can Add Position
        remaining_heat_pct:
          type: number
          title: Remaining Heat Pct
        message:
          type: string
          title: Message
      type: object
      required:
        - account_id
        - current_heat_pct
        - max_heat_pct
        - heat_status
        - can_add_position
        - remaining_heat_pct
        - message
      title: PortfolioHeatResponse
      description: Response for portfolio heat check.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````