---
title: "Get Equity"
method: GET
path: "/v1/deployments/{deployment_id}/equity"
tags: ["deployments"]
---

# Get Equity

`GET /v1/deployments/{deployment_id}/equity`

## Request

- Base URL: `https://api.usekeel.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.usekeel.io/v1/deployments/{deployment_id}/equity`
- Auth: none declared

Equity curve for a deployment.

## Path parameters

- `deployment_id` string, required

## Query parameters

- `range` string

## Headers

- `Authorization` string, nullable
- `X-Org-Id` string, nullable
- `X-Keel-Performance-Contract` 'account_performance.v1'

## Response `200`

Successful Response

- union
  - EquityCurveResponse
    - `points` EquityPoint[], required
      - `timestamp` string, required
      - `equity` number, required
      - `pnl` number
      - `flow` number, nullable
      - `twr_pct` number, nullable
    - `baseline_value` number, required
    - `current_value` number, nullable
    - `initial_deposit` number
    - `money_freshness` MoneyFreshness: Coverage state of the money facts behind a performance read (spec 04 §5.1, M4). Freshness is part of the answer: the number beside this block is only as fresh as the capture coverage that produced its inputs, and this block says exactly how fresh — * ``COVERED`` — coverage reaches the requested interval's end; ``fresh_as_of`` is the weakest fact class's reach. * ``SYNCING`` — the interval is managed and post-epoch but coverage has not reached its end yet; ``synced_through`` is how far it has (null when no coverage row speaks for the interval at all — absence never reads as fresh). * ``LEGACY`` — the interval predates the account's first coverage row (the epoch cutover): pre-capture history, served ungated but labeled. Until the capture lane goes live, every account reads this. * ``UNMANAGED`` — the interval overlaps no managed window; strategy performance is not defined there. Phase 1 labels only — no numeric field elsewhere in the response changes because of this block.
      - `state` 'COVERED' | 'SYNCING' | 'LEGACY' | 'UNMANAGED', required
      - `fresh_as_of` string, nullable
      - `synced_through` string, nullable
    - `managed_segments` ManagedSegmentResponse[], nullable
      - `start` string, required
      - `end` string, required
      - `managed` boolean, required
    - `today_pnl` number, nullable
    - `today_flows` number, nullable
    - `pending_flows` PendingFlow[], nullable
      - `timestamp` string, required
      - `amount` number, required
    - `gaps` EquityGapResponse[], nullable
      - `from` string, date-time, required
      - `to` string, date-time, nullable, required
      - `kind` 'missed' | 'failed' | 'stalled', required
  - PerformanceView
    - `contract_version` 'account_performance.v1'
    - `scope` union, required
      - AccountScope
        - `kind` 'account'
        - `scope_id` string, required
        - `account_id` string, required
        - `deployment_id` string, required
        - `reporting_interval_id` string, required
        - `start` string, date-time, required
        - `end` string, date-time, nullable, required
      - PortfolioScope
        - `kind` 'portfolio'
        - `scope_id` string, required
        - `scope_hash` string, required
        - `accounts` AccountScope[], required
          - `kind` 'account'
          - `scope_id` string, required
          - `account_id` string, required
          - `deployment_id` string, required
          - `reporting_interval_id` string, required
          - `start` string, date-time, required
          - `end` string, date-time, nullable, required
        - `basis_components` BasisComponent[], required
          - `account_id` string, required
          - `reporting_interval_id` string, required
          - `basis_id` string, required
          - `binding_revision` integer, required
        - `population` 'current_active_accounts'
    - `basis_id` string, nullable, required
    - `basis_binding_revision` integer, nullable, required
    - `basis_components` BasisComponent[], required
      - `account_id` string, required
      - `reporting_interval_id` string, required
      - `basis_id` string, required
      - `binding_revision` integer, required
    - `numeraire` 'USDC'
    - `method_id` string, required
    - `policy_sha256` string, required
    - `return_quality` 'valuation_linked' | 'estimated' | 'unavailable', required
    - `exact_twr_pct` string, nullable, required
    - `estimated_return_pct` string, nullable, required
    - `estimated_interval_count` integer, required
    - `first_estimated_at` string, date-time, nullable, required
    - `generated_at` string, date-time, required
    - `revision_token` string, required
    - `value_quality` 'current' | 'stale' | 'unavailable', required
    - `performance_quality` 'complete' | 'pending' | 'partial' | 'unavailable', required
    - `reason_codes` string[], required
    - `baseline` Baseline, required
      - `observation_ref` union, required
        - AccountReference
          - `kind` 'account_observation'
          - `observation_id` string, required
          - `verdict_revision` integer, required
          - `observed_at_lower` string, date-time, required
          - `observed_at_upper` string, date-time, required
          - `source_cutoff_sha256` string, required
          - `comparator_id` string, required
          - `comparator_version` string, required
          - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
        - PortfolioFrame
          - `kind` 'portfolio_frame'
          - `frame_id` string, required
          - `ordinal` integer, required
          - `constituents` FrameConstituent[], required
            - `account_id` string, required
            - `reporting_interval_id` string, required
            - `basis_id` string, required
            - `binding_revision` integer, required
            - `opening_observation_id` string, required
            - `closing_observation_id` string, required
            - `common_boundary_proof_ref` string, required
            - `observation_id` string, required
            - `verdict_revision` integer, required
            - `observed_at` string, date-time, required
            - `observed_at_lower` string, date-time, required
            - `observed_at_upper` string, date-time, required
            - `source_cutoff_sha256` string, required
            - `comparator_id` string, required
            - `comparator_version` string, required
            - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
            - `absorbed_from` string, date-time, required
            - `absorbed_through` string, date-time, required
            - `absorbed_principal` string, nullable, required
            - `membership_capital` string, nullable, required
          - `oldest_observed_at` string, date-time, required
          - `newest_observed_at` string, date-time, required
      - `observed_at` string, date-time, required
      - `value` string, required
    - `semantic_revisions` SemanticRevision[], required
      - `account_id` string, required
      - `basis_id` string, required
      - `revision` integer, required
    - `coverage` ClassifiedCoverage, required
      - `classified_through` string, date-time, nullable, required
      - `revision_refs` AccountBasisCoverageReference[], required
        - `kind` 'coverage'
        - `account_id` string, required
        - `basis_id` string, required
        - `source_class` string, required
        - `measure_role` 'account_nav' | 'perps_performance' | 'fee_capital', nullable
        - `performance_scope_id` string, nullable
        - `window_start` string, date-time, required
        - `window_end` string, date-time, required
        - `revision` integer, required
      - `interval_start` string, date-time, required
      - `interval_end` string, date-time, required
      - `unresolved_count` integer, required
      - `complete` boolean, required
    - `points` PerformancePoint[], required
      - `observed_at` string, date-time, required
      - `observation_ref` union, required
        - AccountReference
          - `kind` 'account_observation'
          - `observation_id` string, required
          - `verdict_revision` integer, required
          - `observed_at_lower` string, date-time, required
          - `observed_at_upper` string, date-time, required
          - `source_cutoff_sha256` string, required
          - `comparator_id` string, required
          - `comparator_version` string, required
          - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
        - PortfolioFrame
          - `kind` 'portfolio_frame'
          - `frame_id` string, required
          - `ordinal` integer, required
          - `constituents` FrameConstituent[], required
            - `account_id` string, required
            - `reporting_interval_id` string, required
            - `basis_id` string, required
            - `binding_revision` integer, required
            - `opening_observation_id` string, required
            - `closing_observation_id` string, required
            - `common_boundary_proof_ref` string, required
            - `observation_id` string, required
            - `verdict_revision` integer, required
            - `observed_at` string, date-time, required
            - `observed_at_lower` string, date-time, required
            - `observed_at_upper` string, date-time, required
            - `source_cutoff_sha256` string, required
            - `comparator_id` string, required
            - `comparator_version` string, required
            - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
            - `absorbed_from` string, date-time, required
            - `absorbed_through` string, date-time, required
            - `absorbed_principal` string, nullable, required
            - `membership_capital` string, nullable, required
          - `oldest_observed_at` string, date-time, required
          - `newest_observed_at` string, date-time, required
      - `value` string, required
      - `pnl` string, nullable, required
      - `wealth` string, nullable, required
      - `return_pct` string, nullable, required
      - `return_quality` 'valuation_linked' | 'estimated' | 'unavailable', required
      - `factor_kind` 'no_flow' | 'flow_boundary' | 'modified_dietz' | 'unavailable', required
      - `exact_twr_pct` string, nullable, required
      - `estimated_return_pct` string, nullable, required
      - `estimated_interval_count` integer, required
      - `flow` string, nullable, required
      - `validity` 'complete' | 'pending' | 'held' | 'unavailable', required
      - `segment_id` string, required
      - `perps_performance` PerpsPerformanceView, required
        - `performance_basis_id` 'perps_usdc_performance.v1'
        - `performance_scope_id` 'hyperliquid.main_perps.v1'
        - `scope_hash` string, required
        - `interval_start` string, date-time, required
        - `interval_end` string, date-time, required
        - `pnl` string, nullable, required
        - `quality` 'complete' | 'pending' | 'held' | 'unavailable', required
        - `reason_codes` string[], required
        - `input_revision_token` string, required
        - `evidence_manifest_ref` string, nullable, required
        - `return_pct` string, nullable, required
        - `return_quality` 'exact' | 'estimated' | 'unavailable', required
        - `exact_twr_pct` string, nullable, required
        - `estimated_return_pct` string, nullable, required
        - `return_method_id` string, nullable, required
        - `return_equivalence_proof_ref` string, nullable, required
    - `performance_tip` PerformanceTip, required
      - `observed_at` string, date-time, required
      - `observation_ref` union, required
        - AccountReference
          - `kind` 'account_observation'
          - `observation_id` string, required
          - `verdict_revision` integer, required
          - `observed_at_lower` string, date-time, required
          - `observed_at_upper` string, date-time, required
          - `source_cutoff_sha256` string, required
          - `comparator_id` string, required
          - `comparator_version` string, required
          - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
        - PortfolioFrame
          - `kind` 'portfolio_frame'
          - `frame_id` string, required
          - `ordinal` integer, required
          - `constituents` FrameConstituent[], required
            - `account_id` string, required
            - `reporting_interval_id` string, required
            - `basis_id` string, required
            - `binding_revision` integer, required
            - `opening_observation_id` string, required
            - `closing_observation_id` string, required
            - `common_boundary_proof_ref` string, required
            - `observation_id` string, required
            - `verdict_revision` integer, required
            - `observed_at` string, date-time, required
            - `observed_at_lower` string, date-time, required
            - `observed_at_upper` string, date-time, required
            - `source_cutoff_sha256` string, required
            - `comparator_id` string, required
            - `comparator_version` string, required
            - `flow_inclusion_quality` 'complete' | 'pending' | 'held', required
            - `absorbed_from` string, date-time, required
            - `absorbed_through` string, date-time, required
            - `absorbed_principal` string, nullable, required
            - `membership_capital` string, nullable, required
          - `oldest_observed_at` string, date-time, required
          - `newest_observed_at` string, date-time, required
      - `value` string, required
      - `pnl` string, nullable, required
      - `wealth` string, nullable, required
      - `return_pct` string, nullable, required
      - `return_quality` 'valuation_linked' | 'estimated' | 'unavailable', required
      - `factor_kind` 'no_flow' | 'flow_boundary' | 'modified_dietz' | 'unavailable', required
      - `exact_twr_pct` string, nullable, required
      - `estimated_return_pct` string, nullable, required
      - `estimated_interval_count` integer, required
      - `flow` string, nullable, required
      - `validity` 'complete' | 'pending' | 'held' | 'unavailable', required
      - `segment_id` string, required
      - `perps_performance` PerpsPerformanceView, required
        - `performance_basis_id` 'perps_usdc_performance.v1'
        - `performance_scope_id` 'hyperliquid.main_perps.v1'
        - `scope_hash` string, required
        - `interval_start` string, date-time, required
        - `interval_end` string, date-time, required
        - `pnl` string, nullable, required
        - `quality` 'complete' | 'pending' | 'held' | 'unavailable', required
        - `reason_codes` string[], required
        - `input_revision_token` string, required
        - `evidence_manifest_ref` string, nullable, required
        - `return_pct` string, nullable, required
        - `return_quality` 'exact' | 'estimated' | 'unavailable', required
        - `exact_twr_pct` string, nullable, required
        - `estimated_return_pct` string, nullable, required
        - `return_method_id` string, nullable, required
        - `return_equivalence_proof_ref` string, nullable, required
      - `revision_token` string, required
      - `interval_start` string, date-time, required
      - `covered_through` string, date-time, required
      - `complete` true
    - `quote` Quote, required
      - `value` string, required
      - `basis_id` string, required
      - `representation_id` string, required
      - `observed_at` string, date-time, required
      - `observed_interval_start` string, date-time, required
      - `observed_interval_end` string, date-time, required
      - `quality` 'current' | 'stale' | 'unavailable', required
      - `reason_codes` string[], required
    - `portfolio_context` PortfolioContext, required
      - `scope_hash` string, required
      - `constituent_revision_refs` object[], required
      - `oldest_observed_at` string, date-time, nullable, required
      - `newest_observed_at` string, date-time, nullable, required
      - `asof_value` string, nullable, required
      - `asof_value_quality` 'current' | 'stale' | 'unavailable', required
      - `return_boundary_status` 'aligned' | 'unaligned' | 'unavailable', required
    - `perps_performance` PerpsPerformanceView, required
      - `performance_basis_id` 'perps_usdc_performance.v1'
      - `performance_scope_id` 'hyperliquid.main_perps.v1'
      - `scope_hash` string, required
      - `interval_start` string, date-time, required
      - `interval_end` string, date-time, required
      - `pnl` string, nullable, required
      - `quality` 'complete' | 'pending' | 'held' | 'unavailable', required
      - `reason_codes` string[], required
      - `input_revision_token` string, required
      - `evidence_manifest_ref` string, nullable, required
      - `return_pct` string, nullable, required
      - `return_quality` 'exact' | 'estimated' | 'unavailable', required
      - `exact_twr_pct` string, nullable, required
      - `estimated_return_pct` string, nullable, required
      - `return_method_id` string, nullable, required
      - `return_equivalence_proof_ref` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usekeel/apis/keel-api.md) · [All operations](https://skmtc.dev/usekeel/apis/keel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usekeel/apis/keel-api/revisions/3191ca10b0ab?raw)