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

# Vaults by Chain

> Vault metrics summed across all vault protocols on a blockchain: assets under management, active vaults, curators, gross yield, net yield and fees, in USD. Each series is one chain, keyed by its chain slug.

One row per blockchain with vault activity, keyed by the short chain name: name, the chain's slug and its network id. The id is the series key of the vaults-by-chain timeseries model.

|                  |                                                                                                   |
| ---------------- | ------------------------------------------------------------------------------------------------- |
| Access           | Projects\_protocols\_unified                                                                      |
| Tabular model    | `vault-chains`: primary key `id`, identifiers `slug`                                              |
| Timeseries model | `vaults-by-chain`: intervals `1d`, series key `id` (Chain ID), every series available in one call |

## Endpoints

<CardGroup cols={2}>
  <Card title="List Vault Chains" icon="arrow-right" href="/api-reference/data-api/vaults/tabular-vault-chains">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Batch Get Chain timeseries" icon="arrow-right" href="/api-reference/data-api/vaults/timeseries-vaults-by-chain">
    Every series in one request, or the named ones.
  </Card>

  <Card title="Get Chain timeseries" icon="arrow-right" href="/api-reference/data-api/vaults/timeseries-vaults-by-chain-by-id">
    One series over a time window, keyed by its Chain ID.
  </Card>
</CardGroup>

## Metrics

6 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field           | Name              | Type    | Unit | Description                                     |
| --------------- | ----------------- | ------- | ---- | ----------------------------------------------- |
| `aumUSD`        | AUM (USD)         | float64 |      | Total assets under management in vaults in USD. |
| `vaultCount`    | Vault Count       | float64 |      | Number of active vaults.                        |
| `curatorCount`  | Curator Count     | float64 |      | Number of distinct vault curators.              |
| `grossYieldUSD` | Gross Yield (USD) | float64 |      | Yield generated by vaults before fees in USD.   |
| `netYieldUSD`   | Net Yield (USD)   | float64 |      | Yield paid to depositors net of fees in USD.    |
| `feesUSD`       | Fees (USD)        | float64 |      | Fees taken by vaults and curators in USD.       |

## Columns

Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes).

| Field       | Type   | Filters                     | Sort    | Description                                                                                            |
| ----------- | ------ | --------------------------- | ------- | ------------------------------------------------------------------------------------------------------ |
| `id`        | string | `Eq`, `IsOneOf`             |         | The series key of the vaults-by-chain timeseries model, the short chain name (arbitrum). (primary key) |
| `name`      | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the chain.                                                                         |
| `slug`      | string | `Eq`, `IsOneOf`             | yes     | The chain's slug in the blockchains model (arbitrum-one). (identifier 1)                               |
| `networkID` | string | `Eq`, `IsOneOf`             |         | The chain's networkID in the blockchains model.                                                        |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/vaults-by-chain/1d/arbitrum?timeframe=7d&selections=aumUSD,vaultCount" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Chain timeseries](/api-reference/data-api/vaults/timeseries-vaults-by-chain-by-id) for the response and the errors.