> ## Documentation Index > Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt > Use this file to discover all available pages before exploring further. # Get MicroVault performance series > Returns chronological lifetime-earned, NAV, and trailing-APY observations for charting and performance analysis. Read historical NAV, earnings, and trailing APY checkpoints. MicroVaults are in private preview for enabled sandbox organizations on Ethereum Sepolia. ## OpenAPI ````yaml swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/performance-series openapi: 3.0.0 info: title: Ground API description: Core API for Portfolio Wallets, gtokens, MicroVaults, and webhooks. version: 2.0.0 servers: - url: https://sandbox.groundtech.co - url: https://production.groundtech.co security: - bearerAuth: [] tags: - name: System description: System health and utility endpoints. - name: Sandbox Faucets description: Sandbox-only test token faucets. - name: Portfolio Wallets description: >- Portfolio wallets with strategy allocation, deposits, withdrawals, and yield positions. - name: gVaults description: >- Direct access to gtokens with deposit access controls and optional fee wrappers. - name: MicroVaults description: >- Customer-owned onchain vaults with externally held ERC-20 shares. Private preview in sandbox on Ethereum Sepolia. - name: Webhook Endpoints description: Webhook endpoint management for portfolio wallet notifications. paths: /v2/microvaults/vaults/{vaultId}/performance-series: parameters: - name: vaultId in: path required: true schema: $ref: '#/components/schemas/UuidV4' description: >- Ground identifier of the MicroVault. This is distinct from its onchain contract address. get: tags: - MicroVaults summary: Get historical MicroVault performance description: >- Returns chronological lifetime-earned, NAV, and trailing-APY observations for charting and performance analysis. operationId: getMicrovaultPerformanceSeries parameters: - name: range in: query schema: type: string enum: - 7d - 30d - 90d - ytd - 1y - all default: 30d description: >- Preset period for the returned performance series. Use `start` and `end` for a custom period. - name: start in: query schema: type: string format: date description: >- First UTC calendar date to include for a custom period, formatted as `YYYY-MM-DD`. - name: end in: query schema: type: string format: date description: >- Last UTC calendar date to include for a custom period, formatted as `YYYY-MM-DD`. responses: '200': description: Historical performance points. content: application/json: schema: $ref: '#/components/schemas/MicroVaultPerformanceSeries' '401': $ref: '#/components/responses/Unauthorized' components: schemas: UuidV4: type: string format: uuid pattern: >- ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$ example: 8f4c52d7-62ab-4db9-a964-92f481f6b851 MicroVaultPerformanceSeries: type: object additionalProperties: true required: - baseAssetAddress - baseAssetDecimals - period - points properties: baseAssetAddress: allOf: - $ref: '#/components/schemas/NullableNonzeroEvmAddress' description: >- Base asset used to express cumulative earnings and NAV, or `null` when no observations exist. baseAssetDecimals: type: integer nullable: true description: >- Decimal precision for asset-valued fields, or `null` when no observations exist. period: type: object description: >- Requested date window, sampling interval, and completeness of the returned series. required: - range - start - end - interval - status properties: range: type: string enum: - 7d - 30d - 90d - ytd - 1y - all description: Preset date range used to select the series. start: type: string format: date nullable: true description: >- First calendar date included, or `null` when the series has no observations. end: type: string format: date description: Last calendar date included. interval: type: string enum: - day - week - month description: Time bucket represented by each point. status: type: string enum: - ok - partial description: >- '`ok` when all relevant vault observations are included; `partial` when some are unavailable.' points: type: array description: Chronological valuation points sampled for the requested period. items: type: object required: - asOf - cumulativeEarnedAssets - navPerShare - trailingApyBps - status properties: asOf: type: string format: date-time description: Valuation time represented by this point. cumulativeEarnedAssets: allOf: - $ref: '#/components/schemas/MicroVaultUint256' description: >- Lifetime investment earnings through this point in base-asset units. navPerShare: allOf: - $ref: '#/components/schemas/MicroVaultUint256' description: >- Base-asset value of one whole share at this point, scaled by the base asset's decimals. trailingApyBps: type: integer nullable: true description: >- Annualized trailing return in basis points, or `null` when the observation history is insufficient. status: type: string enum: - ok - partial description: Whether this point includes every relevant vault valuation. example: baseAssetAddress: '0x1c7d4b196cb0c7b01d743fbc6116a902379c7238' baseAssetDecimals: 6 period: range: 30d start: '2026-08-11' end: '2026-09-10' interval: day status: ok points: - asOf: '2026-09-10T00:00:00.000Z' cumulativeEarnedAssets: '325000' navPerShare: '1002400' trailingApyBps: 412 status: ok NullableNonzeroEvmAddress: type: string nullable: true description: >- Deployed nonzero EVM contract address, or null while deployment is pending. minLength: 42 maxLength: 42 pattern: ^0x(?!0{40}$)[0-9a-fA-F]{40}$ example: '0x7c4a1cb5a3d5c3c4e019c3f6ab29a0f98c21b814' MicroVaultUint256: type: string pattern: ^(0|[1-9][0-9]*)$ description: Unsigned base-10 integer in token base units. example: '1000000' AuthErrorResponse: type: object required: - error properties: error: type: string description: Authentication or authorization error message. message: type: string nullable: true description: Additional auth middleware detail, when present. code: type: string nullable: true enum: - unauthenticated - forbidden description: >- Some auth and scope failures include a stable code; middleware errors may omit it. responses: Unauthorized: description: >- The request is missing a valid bearer token, or the token is invalid or expired. content: application/json: schema: $ref: '#/components/schemas/AuthErrorResponse' example: error: Unauthenticated request message: Missing or invalid bearer token securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````