> ## 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 APY

> Fetch the latest annual percentage yield for an account via the REST API

Equivalent to SDK's [`getVaultAPY()`](/v0.5.2/intro/products/earn/developers/api/display/getVaultAPY).

## Endpoint

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

## Query Parameters

| Parameter          | Type     | Required | Description                                           |
| ------------------ | -------- | -------- | ----------------------------------------------------- |
| `filter`           | `string` | Yes      | Filter expression — must include `vaultAddress=0x...` |
| `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/vaultApys?filter=vaultAddress%3D${VAULT_ADDRESS}&orderByTimestamp=desc&pageSize=1" \
  -H "x-api-key: $AMPLIFY_API_KEY" | jq '.vaultApys[0]'
```

## Response

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

## Response Types

| Field          | Type      | Description                                        |
| -------------- | --------- | -------------------------------------------------- |
| `vaultAddress` | `address` | BoringVault address                                |
| `chainId`      | `int`     | Chain ID                                           |
| `apy`          | `string`  | APY as a decimal string (e.g., `"0.0523"` = 5.23%) |
| `timestamp`    | `string`  | ISO 8601 timestamp of the APY measurement          |

<Info>
  The `apy` field is a decimal (e.g., `0.0523` = 5.23%). Multiply by 100 to
  display as a percentage.
</Info>