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

# Get treasury cash forecast

> Projects future cash position from historical external transfer rates. expenses_by_category / revenue_by_category are deferred (always empty). See data_availability for missing provider/sync data.



## OpenAPI

````yaml /api-reference/platform-api.json get /v2/treasury/forecast
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.16
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
  - Authorization: []
tags:
  - name: Address Information
    description: Get information about a crypto address.
  - name: Transfer Enrichments
    description: Attach workspace-scoped notes and categories to transfers.
  - name: Counterparties
    description: Manage external entities, their addresses, bank accounts, and documents.
paths:
  /v2/treasury/forecast:
    get:
      tags:
        - Treasury
      summary: Get treasury cash forecast
      description: >-
        Projects future cash position from historical external transfer rates.
        expenses_by_category / revenue_by_category are deferred (always empty).
        See data_availability for missing provider/sync data.
      operationId: getForecast
      parameters:
        - name: group
          required: false
          in: query
          description: Filter accounts by group name (exact match, case-sensitive).
          schema:
            type: string
            example: Treasury
        - name: type
          required: false
          in: query
          schema:
            example: bank
            type: string
            enum:
              - eoa
              - multisig
              - contract
              - custodian
              - exchange
              - bank
              - defi
        - name: provider
          required: false
          in: query
          schema:
            example: utila
            type: string
            enum:
              - utila
              - kraken
              - binance
              - okx
              - bybit
              - bitget
              - gate
              - kucoin
              - plaid
              - squads
              - altitude
              - coinbase
              - realms
              - wise
              - safe
              - hyperliquid
              - cubist
              - privy
              - dfns
              - anchorage
              - revolut_business
              - turnkey
              - octav
              - fordefi
              - coins_ph
              - fireblocks
              - pave_bank
        - name: network
          required: false
          in: query
          description: Filter by account network/chain.
          schema:
            type: string
            example: ethereum
        - name: denom
          required: false
          in: query
          description: Filter balances and transfer legs by asset symbol.
          schema:
            type: string
            example: USDC
        - name: months_forward
          required: false
          in: query
          description: How many months to project forward.
          schema:
            minimum: 1
            maximum: 36
            default: 12
            type: number
        - name: lookback_months
          required: false
          in: query
          description: How many months of history to average for rates.
          schema:
            minimum: 1
            maximum: 12
            default: 3
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TreasuryForecastResponseDto'
components:
  schemas:
    TreasuryForecastResponseDto:
      type: object
      properties:
        starting_cash_usd:
          type: number
          example: 724819.43
        avg_monthly_inflow_usd:
          type: number
          example: 18000
        avg_monthly_outflow_usd:
          type: number
          example: 47200
        net_monthly_rate_usd:
          type: number
          example: -29200
        coverage_months:
          type: number
          nullable: true
          example: 24.8
        expenses_by_category:
          description: >-
            Deferred this sprint (RNG-4135) — always []. Categorized spend
            returns later.
          type: array
          items:
            $ref: '#/components/schemas/TreasuryCategoryAverageDto'
        revenue_by_category:
          description: >-
            Deferred this sprint (RNG-4135) — always []. Categorized revenue
            returns later.
          type: array
          items:
            $ref: '#/components/schemas/TreasuryCategoryAverageDto'
        projection:
          type: array
          items:
            $ref: '#/components/schemas/TreasuryProjectionPointDto'
        data_availability:
          $ref: '#/components/schemas/TreasuryDataAvailabilityDto'
      required:
        - starting_cash_usd
        - avg_monthly_inflow_usd
        - avg_monthly_outflow_usd
        - net_monthly_rate_usd
        - expenses_by_category
        - revenue_by_category
        - projection
        - data_availability
    TreasuryCategoryAverageDto:
      type: object
      properties:
        category:
          type: string
          example: Payroll
        avg_monthly_usd:
          type: number
          example: 42000
      required:
        - category
        - avg_monthly_usd
    TreasuryProjectionPointDto:
      type: object
      properties:
        month:
          type: string
          example: 2026-06
        projected_balance_usd:
          type: number
          example: 695619.43
      required:
        - month
        - projected_balance_usd
    TreasuryDataAvailabilityDto:
      type: object
      properties:
        balances:
          type: string
          enum:
            - available
            - unavailable
            - partial
            - truncated
          example: available
          description: >-
            Whether current account balances could be summed. `partial` when
            some accounts lack priced balances.
        flows:
          type: string
          enum:
            - available
            - unavailable
            - partial
            - truncated
          example: available
          description: >-
            Whether connection-transaction flows could be aggregated.
            `unavailable` when no synced history exists; `truncated` when the
            lookback exceeded the page cap.
        historical_balances:
          type: string
          enum:
            - available
            - unavailable
          example: available
          description: >-
            Whether a point-in-time balance snapshot ~30d ago was found for
            comparison.total_funds_usd.
        unpriced_asset_count:
          type: number
          example: 0
          description: >-
            Count of asset lines with usd=null that were excluded from totals
            (not silently dropped from account_count).
        notes:
          example: []
          description: Human-readable notes about missing or incomplete data.
          type: array
          items:
            type: string
      required:
        - balances
        - flows
        - historical_balances
        - unpriced_asset_count
        - notes
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````