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

# Get a vault's sampled performance series

> Returns a time series of a vault's mark-to-market performance (NAV, share price, total and curator shares, high-water mark, optional benchmark) sampled hourly and downsampled to the requested resolution (1h, 8h, 24h, or 1wk). Supports optional from/to unix-second bounds and a limit (newest first, default 1000, capped at 10000). Values are decimal strings, with live prices nullable. Unauthenticated.



## OpenAPI

````yaml /openapi.json post /public/get_vault_performance_history
openapi: 3.1.0
info:
  title: Derive v3 API
  version: 0.2.0
  description: JSON-RPC 2.0 methods, served over WebSocket and HTTP POST.
servers:
  - url: https://api.derive.xyz/v3
    description: Production (HTTP POST base)
  - url: https://testnet.api.derive.xyz/v3
    description: Testnet (HTTP POST base)
security: []
tags:
  - name: Subaccounts
    description: >-
      List, inspect, and label subaccounts, portfolios, positions, and
      collateral.
  - name: Session Keys
    description: Register, edit, and list delegated signing keys.
  - name: Account
    description: Wallet-level account information and settings.
  - name: Orderbook
    description: Place, replace, cancel, and query orders, trigger orders, and algos.
  - name: RFQ
    description: 'Request-for-quote: send RFQs, quote, and execute block trades.'
  - name: Vault Shareholders
    description: >-
      Deposit into and withdraw from vaults, and track shares, requests, and
      performance.
  - name: Vault Curators
    description: >-
      Create and operate curated vaults: settle deposit and withdrawal requests,
      and manage vault metadata.
  - name: History
    description: >-
      Per-account historical records: orders, trades, transfers, and
      settlements.
  - name: Market Maker Protection
    description: Configure, read, and reset market-maker protection.
  - name: Transfers & Withdrawals
    description: Move collateral between subaccounts, to other wallets, and on-chain.
  - name: System
    description: Rate limits and transaction lookups.
  - name: Market Data
    description: Instruments, currencies, tickers, and market-wide feeds.
  - name: Referrals
    description: Referral codes and program performance.
  - name: Other
    description: Uncategorized.
paths:
  /public/get_vault_performance_history:
    post:
      tags:
        - Vault Shareholders
      summary: Get a vault's sampled performance series
      description: >-
        Returns a time series of a vault's mark-to-market performance (NAV,
        share price, total and curator shares, high-water mark, optional
        benchmark) sampled hourly and downsampled to the requested resolution
        (1h, 8h, 24h, or 1wk). Supports optional from/to unix-second bounds and
        a limit (newest first, default 1000, capped at 10000). Values are
        decimal strings, with live prices nullable. Unauthenticated.
      operationId: public_get_vault_performance_history
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetVaultPerformanceHistoryRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VaultPerformanceHistoryResult'
        default:
          description: JSON-RPC error (see Error Codes)
components:
  schemas:
    GetVaultPerformanceHistoryRequest:
      type: object
      required:
        - resolution
        - subaccount_id
      properties:
        from:
          description: Optional inclusive lower bound (unix seconds).
          default: null
          type:
            - integer
            - 'null'
          format: int64
        limit:
          description: Max points to return, newest first (default 1000, capped at 10000).
          default: null
          type:
            - integer
            - 'null'
          format: uint64
          minimum: 0
        resolution:
          $ref: '#/components/schemas/PerformanceResolution'
        subaccount_id:
          type: integer
          format: uint64
          minimum: 0
        to:
          description: Optional exclusive upper bound (unix seconds).
          default: null
          type:
            - integer
            - 'null'
          format: int64
    VaultPerformanceHistoryResult:
      type: object
      required:
        - points
        - resolution
        - subaccount_id
      properties:
        points:
          type: array
          items:
            $ref: '#/components/schemas/VaultPerformancePointResponse'
        resolution:
          $ref: '#/components/schemas/PerformanceResolution'
        subaccount_id:
          type: integer
          format: uint64
          minimum: 0
    PerformanceResolution:
      description: Quantization of the hourly samples, requested by the caller.
      type: string
      enum:
        - 1h
        - 8h
        - 24h
        - 1wk
    VaultPerformancePointResponse:
      description: >-
        One point in a vault's performance series. `ts` is the bucket time
        (epoch millis); each monetary value is the bucket's last sample as a
        decimal string. Live prices are nullable (a vault that couldn't be
        priced).
      type: object
      required:
        - benchmark_price
        - curator_shares
        - global_hwm
        - nav
        - nav_benchmark
        - share_price
        - total_shares
        - ts
      properties:
        benchmark_price:
          description: >-
            Optional non-negative decimal string of the human value (e.g.
            `"1.5"`), up to 12 fractional digits, or null; a string or JSON
            number is accepted
          type:
            - string
            - 'null'
          format: decimal
        curator_shares:
          description: >-
            Non-negative decimal string of the human value (e.g. `"1.5"`), up to
            12 fractional digits; a string or JSON number is accepted
          type: string
          format: decimal
        global_hwm:
          description: >-
            Non-negative decimal string of the human value (e.g. `"1.5"`), up to
            12 fractional digits; a string or JSON number is accepted
          type: string
          format: decimal
        nav:
          description: >-
            Optional decimal string of the human value (e.g. `"1.5"`), up to 12
            fractional digits, or null; a string or JSON number is accepted
          type:
            - string
            - 'null'
          format: decimal
        nav_benchmark:
          description: >-
            Optional decimal string of the human value (e.g. `"1.5"`), up to 12
            fractional digits, or null; a string or JSON number is accepted
          type:
            - string
            - 'null'
          format: decimal
        share_price:
          description: >-
            Decimal string of the human value (e.g. `"1.5"`), up to 12
            fractional digits; a string or JSON number is accepted
          type: string
          format: decimal
        total_shares:
          description: >-
            Non-negative decimal string of the human value (e.g. `"1.5"`), up to
            12 fractional digits; a string or JSON number is accepted
          type: string
          format: decimal
        ts:
          type: integer
          format: int64

````

## Related topics

- [Process Deposits & Withdrawals](/vaults/deposits-withdrawals.md)
- [Get a vault's economic action history](/api-reference/vault-shareholders/get-a-vaults-economic-action-history.md)
- [Create a Vault](/vaults/create-a-vault.md)
