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

# Get vault details

> Retrieve vault-level information like current APY, TVL, and available liquidity.

Use the [get vault details](/api-reference/wallets/earn/get-vault-details) endpoint to retrieve vault-level information like current APY, TVL, and available liquidity. This is useful for displaying vault metrics to users before they deposit, or for checking liquidity before initiating a large withdrawal.

<Info>
  View the full [API reference](/api-reference/wallets/earn/get-vault-details) for the get vault
  details endpoint.
</Info>

## Usage

<Tabs>
  <Tab title="REST API">
    Make a `GET` request to:

    ```bash theme={"system"}
    https://auth.privy.io/api/v1/earn/ethereum/vaults/{vault_id}
    ```

    ### Parameters

    <ParamField path="vault_id" type="string" required>
      The unique identifier for the vault.
    </ParamField>

    ### Returns

    <ResponseField name="id" type="string">
      The vault's unique identifier.
    </ResponseField>

    <ResponseField name="name" type="string">
      Display name of the vault.
    </ResponseField>

    <ResponseField name="provider" type="string">
      The protocol powering the vault (e.g. `"morpho"`).
    </ResponseField>

    <ResponseField name="vault_address" type="string">
      The onchain address of the vault contract.
    </ResponseField>

    <ResponseField name="asset" type="object">
      The vault's underlying asset.

      <Expandable title="Asset fields">
        <ResponseField name="asset.address" type="string">
          The token contract address.
        </ResponseField>

        <ResponseField name="asset.symbol" type="string">
          The token symbol (e.g. `"usdc"`).
        </ResponseField>

        <ResponseField name="asset.decimals" type="number">
          The number of decimals for the token.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="caip2" type="string">
      Chain identifier in CAIP-2 format.
    </ResponseField>

    <ResponseField name="user_apy" type="number">
      Current APY in basis points (e.g. `500` = 5%).
    </ResponseField>

    <ResponseField name="app_apy" type="number">
      The application's share of the APY in basis points.
    </ResponseField>

    <ResponseField name="tvl_usd" type="number">
      Total value locked in the vault in USD.
    </ResponseField>

    <ResponseField name="available_liquidity_usd" type="number">
      Liquidity available for withdrawal in USD.
    </ResponseField>

    ### Example

    ```bash theme={"system"}
    curl https://auth.privy.io/api/v1/earn/ethereum/vaults/{vault_id} \
      -H "privy-app-id: <your-app-id>" \
      -H "Authorization: Basic <credentials>"
    ```

    ```json Example response theme={"system"}
    {
      "id": "<your-vault-id>",
      "name": "Gauntlet USDC Prime",
      "provider": "morpho",
      "vault_address": "0x04422053aDDbc9bB2759b248B574e3FCA76Bc145",
      "asset": {
        "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
        "symbol": "usdc",
        "decimals": 6
      },
      "caip2": "eip155:1",
      "user_apy": 500,
      "app_apy": 100,
      "tvl_usd": 1000000,
      "available_liquidity_usd": 500000
    }
    ```
  </Tab>
</Tabs>

<Tip>
  Check `available_liquidity_usd` before initiating large withdrawals. If the vault's lending
  markets are fully utilized, a withdrawal may partially fill or fail. See [liquidity
  considerations](/wallets/actions/earn/withdraw#liquidity-considerations) for more details.
</Tip>

## Next steps

<Card title="Webhooks" icon="bell" href="/wallets/actions/earn/webhooks" arrow>
  Track deposit, withdrawal, and claim activity in real time.
</Card>