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

# Monitoring & API

> Monitor vault performance and health using the Ranger Earn API and SDK

<Info>
  API services are only available for indexed vaults. Reach out to the team if your vault should be enabled.
</Info>

## Ranger Earn API

The Ranger Earn API provides read-only endpoints for querying vault data. This is the recommended approach for monitoring and user-facing applications.

* Base URL: `https://api.voltr.xyz`
* API docs: [api.voltr.xyz/docs](https://api.voltr.xyz/docs)

## SDK For Real-Time Or Derived Reads

The v2 SDK exposes direct fetchers and extension helpers:

```typescript theme={null}
import { createSolanaRpc } from "@solana/kit";
import {
  fetchVault,
  getAccumulatedAdminFeesForVault,
  getAccumulatedManagerFeesForVault,
  getCurrentAssetPerLpForVault,
  getHighWaterMarkForVault,
  getPositionAndTotalValuesForVault,
  getVaultLpSupplyBreakdown,
} from "@voltr/vault-sdk";

const rpc = createSolanaRpc("your-rpc-url");
const vault = "your-vault-address" as const;
```

### Vault State

```typescript theme={null}
const vaultData = await fetchVault(rpc, vault);
console.log("Total assets:", vaultData.data.asset.totalValue.toString());
console.log("Admin:", vaultData.data.admin);
console.log("Manager:", vaultData.data.manager);
```

### Fee And HWM Data

```typescript theme={null}
const adminFees = await getAccumulatedAdminFeesForVault(rpc, vault);
const managerFees = await getAccumulatedManagerFeesForVault(rpc, vault);
const hwm = await getHighWaterMarkForVault(rpc, vault);
```

### LP Economics

```typescript theme={null}
const assetPerLp = await getCurrentAssetPerLpForVault(rpc, vault);
const lpBreakdown = await getVaultLpSupplyBreakdown(rpc, vault);
```

### Strategy Positions

```typescript theme={null}
const positions = await getPositionAndTotalValuesForVault(rpc, vault);
```

<Tip>
  **API for reads, SDK for writes**: Use the Ranger Earn API for monitoring, dashboards, and user-facing queries. Use the SDK for manager/admin operations that require signing transactions.
</Tip>

## Best Practice Split

| Use Case                          | Recommended Source |
| --------------------------------- | ------------------ |
| Dashboard / UI showing vault data | Ranger Earn API    |
| Monitoring vault APY over time    | Ranger Earn API    |
| User deposit/withdraw UI          | Ranger Earn API    |
| Checking fees before harvesting   | SDK (real-time)    |
| Automation scripts (rebalancing)  | SDK                |

## What To Alert On

* falling share price
* unusually high idle balance
* repeated strategy transaction failures
* low SOL on admin or manager wallets
* reward balances not being claimed on schedule