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

# Get Live Vault State

> Reads directly from the AegisUSDC vault smart contract to return live metrics including Total Value Locked (TVL), estimated APY, and the current Price Per Share. Crucial for understanding appreciation.

Fetch the live metrics from the AegisUSDC vault contract, including Total Value Locked (TVL) and current Price Per Share.


## OpenAPI

````yaml GET /v1/actions/yield/vault
openapi: 3.1.0
info:
  title: Aegis Secure API
  description: >-
    Zero-trust API for Developer-Controlled Wallets (DCW) and programmatic
    Policy Engine controls.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.aegisintent.xyz
    description: Production API Server
security: []
paths:
  /v1/actions/yield/vault:
    get:
      tags:
        - Actions API
        - Yield
      summary: Get Live Vault State
      description: >-
        Reads directly from the AegisUSDC vault smart contract to return live
        metrics including Total Value Locked (TVL), estimated APY, and the
        current Price Per Share. Crucial for understanding appreciation.
      parameters:
        - name: X-Aegis-Email
          in: header
          required: true
          schema:
            type: string
          description: Agent email address
      responses:
        '200':
          description: Live Vault State
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  vault:
                    type: object
                    properties:
                      address:
                        type: string
                      totalAssets:
                        type: string
                      totalShares:
                        type: string
                      pricePerShare:
                        type: string
                      estimatedAPYPercent:
                        type: number
      security:
        - BearerAuth: []
        - AegisEmail: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Provide raw API session token issued by `/v1/connect/complete`
    AegisEmail:
      type: apiKey
      in: header
      name: X-Aegis-Email
      description: Dual-header token holder identity confirmation

````