Lending Market Balances

One row per lending market balance, the finest grain of the lending data, keyed by protocol, product, chain, market, token, balance type and balance subtype: the market and token, the parent protocol and product, chain and the mapped protocol, project and network records. The id is the series key of the lending-market-balances timeseries model.


Access	Lending-protocols-dataset
Tabular model	`lending-market-balances`: primary key `id`
Timeseries model	`lending-market-balances`: intervals `1d`, series key `id` (Lending Market Balance ID), series must be named (up to 20 per call)

Endpoints

List Lending Market Balances

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

Batch Get Lending Market Balance timeseries

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

Get Lending Market Balance timeseries

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

Metrics

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

Field	Name	Type	Unit	Description
`balanceUSD`	Balance (USD)	float64		The balance in USD of the token for this market, balance type and subtype.

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 lending-market-balances timeseries model, the parent slug, product slug, chain, market key, token key, balance type and balance subtype, joined with underscores. (primary key)
`name`	string	`Eq`, `IsOneOf`, `Contains`	default	The display name of the balance, the market name, token symbol and balance subtype (or type).
`slug`	string	`Eq`, `IsOneOf`	yes	The parent protocol’s project slug, the slug used for the same protocol across the API.
`parentSlug`	string	`Eq`, `IsOneOf`	yes	The parent protocol’s short name, the id in lending-protocols (aave).
`productSlug`	string	`Eq`, `IsOneOf`		The product or version within the parent protocol (aave-v3).
`chain`	string	`Eq`, `IsOneOf`		The short name of the chain the market lives on (ethereum, bnb, solana).
`marketID`	string	`Eq`, `IsOneOf`		The market or pool address; null when the protocol does not label markets.
`marketName`	string	`Eq`, `IsOneOf`, `Contains`		The market display name.
`marketType`	string	`Eq`, `IsOneOf`		The market type where the protocol distinguishes one (for example core, pooled or credit_vault); null otherwise.
`tokenAddress`	string	`Eq`, `IsOneOf`		The token contract address (the mint address on Solana); null when unlabeled.
`tokenSymbol`	string	`Eq`, `IsOneOf`, `Contains`	yes	The token’s ticker symbol.
`balanceType`	string	`Eq`, `IsOneOf`		Whether the balance is a deposit or a borrow.
`balanceSubtype`	string	`Eq`, `IsOneOf`		The finer balance classification (for example supply, collateral, variable_borrow or fixed_borrow); null for protocols that do not distinguish one.
`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.
`networkID`	string	`Eq`, `IsOneOf`		The chain’s networkID in the blockchains model; null when unmapped.

Example

curl

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

See Get Lending Market 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 Lending Market Balances

Batch Get Lending Market Balance timeseries

Get Lending Market Balance timeseries

Metrics

Columns

Example

​Endpoints

List Lending Market Balances

Batch Get Lending Market Balance timeseries

Get Lending Market Balance timeseries

​Metrics

​Columns

​Example

Endpoints

Metrics

Columns

Example