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

# Account TVL

> Fetch total value locked for an account via the REST API

Equivalent to SDK's `client.amplify.vaults.getTvls()` — see [SDK AI Reference](https://developers.paxoslabs.com/v1.0.0/intro/products/earn/developers/sdk-ai-reference.md).

## Endpoint

```
GET https://api.paxoslabs.com/v2/amplify/vaultTvls
```

## Query Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `filter` | `string` | Yes | Filter expression — must include `vaultAddress=0x...`. Optionally add `AND chainId=1` |
| `includeCurrent` | `string` | No | Set to `true` to include the current (real-time) TVL entry |
| `orderByTimestamp` | `string` | No | Sort order: `desc` (newest first) or `asc` |
| `pageSize` | `int` | No | Results per page (use `1` for latest only) |

## Example Request

```bash theme={null}
VAULT_ADDRESS="0x..."
curl -s "https://api.paxoslabs.com/v2/amplify/vaultTvls?filter=vaultAddress%3D${VAULT_ADDRESS}&includeCurrent=true&orderByTimestamp=desc&pageSize=1" \
  -H "x-api-key: $AMPLIFY_API_KEY" | jq '.vaultTvls[0]'
```

## Response

```json theme={null}
{
  "vaultTvls": [
    {
      "vaultAddress": "0x...",
      "chainId": 1,
      "tvl": "15234567.89",
      "timestamp": "2025-01-15T12:00:00Z"
    }
  ]
}
```

## Response Types

| Field | Type | Description |
| - | - | - |
| `vaultAddress` | `address` | BoringVault address |
| `chainId` | `int` | Chain ID |
| `tvl` | `string` | Total value locked as a decimal string (USD denominated) |
| `timestamp` | `string` | ISO 8601 timestamp of the TVL measurement |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.