Vault Balances

One row per token in a vault, keyed by protocol, product, chain, vault and token: the vault, its curator and classification, the token, the parent protocol and product, chain and the mapped protocol, project and network records. The id is the series key of the vault-balances timeseries model.


Access	Vaults-dataset
Tabular model	`vault-balances`: primary key `id`
Timeseries model	`vault-balances`: intervals `1d`, series key `id` (Vault Balance ID), series must be named (up to 20 per call)

Endpoints

List Vault Balances

One page of rows with per-column filters, sorting and pagination.

Batch Get Vault Balance timeseries

Up to 20 series in one request, named by Vault Balance ID in series.

Get Vault Balance timeseries

One series over a time window, keyed by its Vault Balance ID.

Metrics

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

Field	Name	Type	Unit	Description
`balance`	Balance	float64		Vault balance in native units of the vault asset.
`balanceUSD`	Balance (USD)	float64		Vault balance 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 vault-balances timeseries model, the parent slug, product slug, chain, vault key and token key, joined with underscores. (primary key)
`name`	string	`Eq`, `IsOneOf`, `Contains`	default	The display name of the series, the vault name and token symbol.
`slug`	string	`Eq`, `IsOneOf`	yes	The project’s slug, the slug used for the same project across the API.
`parentSlug`	string	`Eq`, `IsOneOf`	yes	The parent protocol’s short name (aave, morpho).
`productSlug`	string	`Eq`, `IsOneOf`		The product within the parent protocol (morpho-vault).
`chain`	string	`Eq`, `IsOneOf`		The short name of the chain the vault lives on (ethereum, base, solana).
`vaultID`	string	`Eq`, `IsOneOf`		The vault contract or program address; null when the protocol does not label vaults.
`vaultName`	string	`Eq`, `IsOneOf`, `Contains`		The vault display name.
`vaultType`	string	`Eq`, `IsOneOf`		The vault type.
`vaultVersion`	string	`Eq`, `IsOneOf`		The vault version.
`vaultStrategy`	string	`Eq`, `IsOneOf`		The vault strategy.
`vaultCategory`	string	`Eq`, `IsOneOf`		The vault category.
`vaultSubcategory`	string	`Eq`, `IsOneOf`		The vault subcategory within its category.
`curator`	string	`Eq`, `IsOneOf`, `Contains`		The curator’s display name (Steakhouse Financial, Gauntlet); Unknown when unattributed.
`curatorSlug`	string	`Eq`, `IsOneOf`		The curator’s slug, the id in vault-curators (steakhouse-financial, unknown).
`curatorProjectID`	string	`Eq`, `IsOneOf`		The identifier of the curator’s project record; null when unmapped.
`curatorProjectSlug`	string	`Eq`, `IsOneOf`		The slug of the curator’s project record; null when unmapped.
`institutionalPartner`	string	`Eq`, `IsOneOf`		The institutional partner the vault is run for; null otherwise.
`tokenAddress`	string	`Eq`, `IsOneOf`		The vault asset’s contract address (the mint address on Solana); null when unlabeled.
`tokenSymbol`	string	`Eq`, `IsOneOf`, `Contains`	yes	The vault asset’s ticker symbol.
`protocolSlug`	string	`Eq`, `IsOneOf`		The slug of the protocol record mapped to the product; null when unmapped.
`protocolName`	string	`Eq`, `IsOneOf`		The name of the protocol record mapped to the product; null when unmapped.
`projectID`	string	`Eq`, `IsOneOf`		The identifier of the parent protocol’s project record; null when unmapped.
`networkID`	string	`Eq`, `IsOneOf`		The chain’s networkID in the blockchains model; null when unmapped.

Example

curl

curl "https://api.blockworks.com/query/timeseries/vault-balances/1d/<id>?timeframe=7d&selections=balance,balanceUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get Vault Balance timeseries for the response and the errors.

Getting Started

Discovery

Concepts

Market Data

Onchain Fundamentals

Institutional

Fundraising

Social & Mindshare

News

Research

Token Unlocks

Token Transparency Framework

Charts

Token Unlocks

Endpoints

List Vault Balances

Batch Get Vault Balance timeseries

Get Vault Balance timeseries

Metrics

Columns

Example

​Endpoints

List Vault Balances

Batch Get Vault Balance timeseries

Get Vault Balance timeseries

​Metrics

​Columns

​Example

Endpoints

Metrics

Columns

Example