> ## Documentation Index > Fetch the complete documentation index at: https://docs.defindex.io/llms.txt > Use this file to discover all available pages before exploring further. # Get vault historical performance metrics > **User Experience Function**: Retrieves comprehensive historical performance data for a specific vault including Price Per Share (PPS) history, supply tracking, deposits, withdrawals, gains, fees, and APY metrics across different time periods. The endpoint supports flexible period selection (all, 7d, 30d, 90d, 1y) and data aggregation intervals (hourly, daily, weekly, monthly). ## OpenAPI ````yaml GET /vault/{address}/history openapi: 3.0.0 info: title: DeFindex API description: API documentation for DeFindex endpoints version: 1.0.0 contact: {} x-logo: url: https://links.paltalabs.io/defindex-full.svg backgroundColor: '#0e0e0e' altText: DeFindex Logo href: https://defindex.io servers: [] security: [] tags: [] paths: /vault/{address}/history: get: tags: - Historical Data summary: Get vault historical performance metrics description: >- **User Experience Function**: Retrieves comprehensive historical performance data for a specific vault including Price Per Share (PPS) history, supply tracking, deposits, withdrawals, gains, fees, and APY metrics across different time periods. The endpoint supports flexible period selection (all, 7d, 30d, 90d, 1y) and data aggregation intervals (hourly, daily, weekly, monthly). operationId: HistoricalDataController_getVaultHistory parameters: - name: address required: true in: path description: Vault contract address schema: example: CC767WIU5QGJMXYHDDYJAJEF2YWPHOXOZDWD3UUAZVS4KQPRXCKPT2YZ type: string - name: network required: true in: query description: Stellar network to query (mainnet or testnet) schema: enum: - testnet - mainnet type: string - name: period required: false in: query description: >- Time period for historical data. Period must be one of the following values: all, 7d, 30d, 90d, 1y. Default: all schema: enum: - all - 7d - 30d - 90d - 1y type: string - name: interval required: false in: query description: >- Data aggregation interval: hourly, daily, weekly, or monthly. Default: daily schema: enum: - hourly - daily - weekly - monthly type: string - name: startDate required: false in: query description: >- Start date in ISO 8601 format (overrides period parameter if provided). Example: 2025-11-10T00:00:00.000Z schema: example: '2025-11-10T00:00:00.000Z' type: string - name: endDate required: false in: query description: >- End date in ISO 8601 format (default: current time). Example: 2025-12-10T00:00:00.000Z schema: example: '2025-12-10T00:00:00.000Z' type: string responses: '200': description: Vault historical data retrieved successfully content: application/json: schema: type: object properties: vaultAddress: type: string description: Vault contract address example: CC767WIU5QGJMXYHDDYJAJEF2YWPHOXOZDWD3UUAZVS4KQPRXCKPT2YZ vaultName: type: string description: Vault display name example: DeFindex-Vault-SeevVault vaultSymbol: type: string description: Vault token symbol example: SVT period: type: string description: Time period queried (all, 7d, 30d, 90d, 1y) example: 30d interval: type: string description: Data aggregation interval (hourly, daily, weekly, monthly) example: daily currentState: type: object description: Current vault state at the time of query properties: totalSupply: type: string description: >- Total vault token supply (string to handle large numbers) example: '24145383239' totalManagedFunds: type: array description: Current asset allocation across all assets items: type: object properties: asset: type: string description: Asset contract address example: >- CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75 idle_amount: type: string description: Amount not currently invested example: '0' invested_amount: type: string description: Total amount invested in strategies example: '124522000892' strategy_allocations: type: array description: Per-strategy allocation breakdown items: type: object properties: amount: type: string description: Amount allocated to this strategy example: '124522000892' paused: type: boolean description: Whether the strategy is paused example: false strategy_address: type: string description: Strategy contract address example: >- CCSRX5E4337QMCMC3KO3RDFYI57T5NZV5XB3W3TWE4USCASKGL5URKJL total_amount: type: string description: Total amount (idle + invested) example: '124522000892' vaultPPS: type: number description: Current Price Per Share (PPS) of the vault example: 5.157073337145221 assets: type: array description: Assets and their associated strategies items: type: object properties: address: type: string description: Asset contract address example: >- CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75 strategies: type: array description: Investment strategies for this asset items: type: object properties: address: type: string description: Strategy contract address example: >- CDB2WMKQQNVZMEBY7Q7GZ5C7E7IAFSNMZ7GGVD6WKTCEWK7XOIAVZSAP name: type: string description: Strategy name/identifier example: usdc_blend_autocompound_fixed paused: type: boolean description: Whether the strategy is paused example: false lastUpdated: type: string description: Timestamp of last vault state update (ISO 8601) example: '2025-12-10T19:11:00.038Z' metrics: type: object description: Aggregated vault performance metrics properties: totalDeposits: type: string description: Total deposits in smallest asset unit example: '196897810000' totalDepositsDisplay: type: string description: Total deposits formatted for display example: 19,689.78 totalWithdrawals: type: string description: Total withdrawals in smallest asset unit example: '107266493935' totalWithdrawalsDisplay: type: string description: Total withdrawals formatted for display example: 10,726.64 uniqueDepositors: type: number description: Number of unique accounts that have deposited example: 29 totalTransactions: type: number description: Total number of deposit and withdrawal transactions example: 289 totalRebalances: type: number description: Total number of rebalance operations example: 1 period7d: type: object description: 7-day period performance metrics properties: apy: type: number description: 7-day Annual Percentage Yield (%) example: 9923.65 ppsChange: type: number description: Price Per Share change over 7 days (decimal) example: 0.25658639623196144 netDeposits: type: string description: >- Net deposits (deposits - withdrawals) in smallest unit example: '-8280000292' netDepositsDisplay: type: string description: Net deposits formatted for display example: '-828.00' totalGains: type: string description: Total gains in smallest asset unit example: '0' totalGainsDisplay: type: string description: Total gains formatted for display example: '0.00' totalFees: type: string description: Total fees in smallest asset unit example: '0' totalFeesDisplay: type: string description: Total fees formatted for display example: '0.00' period30d: type: object description: 30-day period performance metrics properties: apy: type: number description: 30-day Annual Percentage Yield (%) example: 14.89 ppsChange: type: number description: Price Per Share change over 30 days (decimal) example: 1.0582073423171412 netDeposits: type: string description: >- Net deposits (deposits - withdrawals) in smallest unit example: '-21026900968' netDepositsDisplay: type: string description: Net deposits formatted for display example: '-2,102.69' totalGains: type: string description: Total gains in smallest asset unit example: '0' totalGainsDisplay: type: string description: Total gains formatted for display example: '0.00' totalFees: type: string description: Total fees in smallest asset unit example: '0' totalFeesDisplay: type: string description: Total fees formatted for display example: '0.00' fullPeriod: type: object description: Full selected period performance metrics properties: days: type: number description: Number of days in the selected period example: 30 totalReturn: type: number description: Total return over the period (decimal) example: 1.068675023552057 annualizedReturn: type: number description: Annualized return percentage (%) example: 13.806822015824105 totalGains: type: string description: Total gains in smallest asset unit example: '-2' totalGainsDisplay: type: string description: Total gains formatted for display example: '-0.00' totalFees: type: string description: Total fees in smallest asset unit example: '0' totalFeesDisplay: type: string description: Total fees formatted for display example: '0.00' data: type: array description: Historical time series data points items: type: object properties: timestamp: type: string description: Timestamp for this data point (ISO 8601) example: '2025-11-10T00:00:00.000Z' vaultPPS: type: number description: Price Per Share at this timestamp example: 5.102135787948024 totalSupply: type: string description: Total vault token supply at this timestamp example: '21819770658' totalManagedFunds: type: string description: >- Total managed funds at this timestamp in smallest unit example: '111327432759' totalManagedFundsDisplay: type: string description: Total managed funds formatted for display example: 11,132.74 periodDeposits: type: string description: Deposits in this period/interval in smallest unit example: '30000000' periodDepositsDisplay: type: string description: Deposits formatted for display example: '3.00' periodWithdrawals: type: string description: Withdrawals in this period/interval in smallest unit example: '35000003' periodWithdrawalsDisplay: type: string description: Withdrawals formatted for display example: '3.50' netDeposits: type: string description: >- Net deposits (deposits - withdrawals) in smallest unit example: '-5000003' netDepositsDisplay: type: string description: Net deposits formatted for display example: '-0.50' periodGains: type: string description: Gains in this period/interval in smallest unit example: '0' periodFees: type: string description: >- Realized fees distributed within this interval (sum of fee_distribution events). BigInt string in stroops. v1: distributed portion only (excludes currently locked fees). example: '150000' periodFeesDisplay: type: string description: >- periodFees formatted for display (decimal with commas) example: '0.02' ppsChangeFromPrevious: type: number nullable: true description: >- PPS change from previous data point (null for first point or periods with no activity) example: 0.00025893586694802906 example: vaultAddress: C...Z vaultName: DeFindex-Vault-Name vaultSymbol: SVT period: 30d interval: daily currentState: totalSupply: '24145383239' totalManagedFunds: - asset: >- CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75 idle_amount: '0' invested_amount: '124522000892' strategy_allocations: - amount: '0' paused: false strategy_address: >- CDB2WMKQQNVZMEBY7Q7GZ5C7E7IAFSNMZ7GGVD6WKTCEWK7XOIAVZSAP - amount: '124522000892' paused: false strategy_address: >- CCSRX5E4337QMCMC3KO3RDFYI57T5NZV5XB3W3TWE4USCASKGL5URKJL total_amount: '124522000892' vaultPPS: 5.157073337145221 assets: - address: >- CCW67TSZV3SSS2HXMBQ5JFGCKJNXKZM7UQUWUZPUTHXSTZLEO7SJMI75 strategies: - address: >- CDB2WMKQQNVZMEBY7Q7GZ5C7E7IAFSNMZ7GGVD6WKTCEWK7XOIAVZSAP name: usdc_blend_autocompound_fixed paused: false - address: >- CCSRX5E4337QMCMC3KO3RDFYI57T5NZV5XB3W3TWE4USCASKGL5URKJL name: usdc_blend_autocompound_yieldblox paused: false lastUpdated: '2025-12-10T19:11:00.038Z' metrics: totalDeposits: '196897810000' totalDepositsDisplay: 19,689.78 totalWithdrawals: '107266493935' totalWithdrawalsDisplay: 10,726.64 uniqueDepositors: 29 totalTransactions: 289 totalRebalances: 1 period7d: apy: 9923.65 ppsChange: 0.25658639623196144 netDeposits: '-8280000292' netDepositsDisplay: '-828.00' totalGains: '0' totalGainsDisplay: '0.00' totalFees: '0' totalFeesDisplay: '0.00' period30d: apy: 14.89 ppsChange: 1.0582073423171412 netDeposits: '-21026900968' netDepositsDisplay: '-2,102.69' totalGains: '0' totalGainsDisplay: '0.00' totalFees: '0' totalFeesDisplay: '0.00' fullPeriod: days: 30 totalReturn: 1.068675023552057 annualizedReturn: 13.806822015824105 totalGains: '-2' totalGainsDisplay: '-0.00' totalFees: '0' totalFeesDisplay: '0.00' data: - timestamp: '2025-11-10T00:00:00.000Z' vaultPPS: 5.102135787948024 totalSupply: '21819770658' totalManagedFunds: '111327432759' totalManagedFundsDisplay: 11,132.74 periodDeposits: '30000000' periodDepositsDisplay: '3.00' periodWithdrawals: '35000003' periodWithdrawalsDisplay: '3.50' netDeposits: '-5000003' netDepositsDisplay: '-0.50' periodGains: '0' periodFees: '150000' periodFeesDisplay: '0.02' ppsChangeFromPrevious: 0.00025893586694802906 - timestamp: '2025-12-01T00:00:00.000Z' vaultPPS: 5.140029400646425 totalSupply: '21186685184' totalManagedFunds: '108900184748' totalManagedFundsDisplay: 10,890.01 periodDeposits: '10000000000' periodDepositsDisplay: 1,000.00 periodWithdrawals: '35000003' periodWithdrawalsDisplay: '3.50' netDeposits: '9964999997' netDepositsDisplay: '996.49' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.008499104596970675 - timestamp: '2025-12-02T00:00:00.000Z' vaultPPS: 5.140029400646425 totalSupply: '21186685184' totalManagedFunds: '108900184748' totalManagedFundsDisplay: 10,890.01 periodDeposits: '10000000000' periodDepositsDisplay: 1,000.00 periodWithdrawals: '35000003' periodWithdrawalsDisplay: '3.50' netDeposits: '9964999997' netDepositsDisplay: '996.49' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: null - timestamp: '2025-12-03T00:00:00.000Z' vaultPPS: 5.142829984242702 totalSupply: '25752986409' totalManagedFunds: '132443230688' totalManagedFundsDisplay: 13,244.32 periodDeposits: '10000000000' periodDepositsDisplay: 1,000.00 periodWithdrawals: '9595000222' periodWithdrawalsDisplay: '959.50' netDeposits: '404999778' netDepositsDisplay: '40.49' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.0014881516920528526 - timestamp: '2025-12-04T00:00:00.000Z' vaultPPS: 5.143874854030582 totalSupply: '25756874528' totalManagedFunds: '132490139203' totalManagedFundsDisplay: 13,249.01 periodDeposits: '10020000000' periodDepositsDisplay: 1,002.00 periodWithdrawals: '9595000222' periodWithdrawalsDisplay: '959.50' netDeposits: '424999778' netDepositsDisplay: '42.49' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.020317019833071548 - timestamp: '2025-12-05T00:00:00.000Z' vaultPPS: 5.143874854030582 totalSupply: '25756874528' totalManagedFunds: '132490139203' totalManagedFundsDisplay: 13,249.01 periodDeposits: '10020000000' periodDepositsDisplay: 1,002.00 periodWithdrawals: '9595000222' periodWithdrawalsDisplay: '959.50' netDeposits: '424999778' netDepositsDisplay: '42.49' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: null - timestamp: '2025-12-06T00:00:00.000Z' vaultPPS: 5.149579823732469 totalSupply: '24857656315' totalManagedFunds: '128006485425' totalManagedFundsDisplay: 12,800.64 periodDeposits: '10390000000' periodDepositsDisplay: 1,039.00 periodWithdrawals: '14595000319' periodWithdrawalsDisplay: 1,459.50 netDeposits: '-4205000319' netDepositsDisplay: '-420.50' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.01191735893903978 - timestamp: '2025-12-07T00:00:00.000Z' vaultPPS: 5.151452431717395 totalSupply: '24143119556' totalManagedFunds: '124372131946' totalManagedFundsDisplay: 12,437.21 periodDeposits: '12990000000' periodDepositsDisplay: 1,299.00 periodWithdrawals: '20875000486' periodWithdrawalsDisplay: 2,087.50 netDeposits: '-7885000486' netDepositsDisplay: '-788.50' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.0002604537930661621 - timestamp: '2025-12-08T00:00:00.000Z' vaultPPS: 5.15253976020816 totalSupply: '24548744779' totalManagedFunds: '126488383537' totalManagedFundsDisplay: 12,648.83 periodDeposits: '15080000000' periodDepositsDisplay: 1,508.00 periodWithdrawals: '20875000486' periodWithdrawalsDisplay: 2,087.50 netDeposits: '-5795000486' netDepositsDisplay: '-579.50' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.0004893624977686528 - timestamp: '2025-12-09T00:00:00.000Z' vaultPPS: 5.15253976020816 totalSupply: '24548744779' totalManagedFunds: '126488383537' totalManagedFundsDisplay: 12,648.83 periodDeposits: '15080000000' periodDepositsDisplay: 1,508.00 periodWithdrawals: '20875000486' periodWithdrawalsDisplay: 2,087.50 netDeposits: '-5795000486' netDepositsDisplay: '-579.50' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: null - timestamp: '2025-12-10T00:00:00.000Z' vaultPPS: 5.156661038781535 totalSupply: '24145383239' totalManagedFunds: '124509557015' totalManagedFundsDisplay: 12,450.95 periodDeposits: '15190000000' periodDepositsDisplay: 1,519.00 periodWithdrawals: '23065000514' periodWithdrawalsDisplay: 2,306.50 netDeposits: '-7875000514' netDepositsDisplay: '-787.50' periodGains: '0' periodFees: '0' periodFeesDisplay: '0.00' ppsChangeFromPrevious: 0.002218295611711163 '400': description: >- Invalid parameters (invalid date format, invalid period or interval value) '404': description: Vault not found or has no transaction history ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.