Institutional Allocator Financials

One row per institutional allocator financial, keyed by protocol, chain, allocator, balance type, position, token and recognition basis: the parent protocol and product, chain, token and the mapped protocol, project and network records. The id is the series key of the institutional-allocator-financials timeseries model.


Access	Lending-protocols-dataset
Tabular model	`institutional-allocator-financials`: primary key `id`
Timeseries model	`institutional-allocator-financials`: intervals `1d`, series key `id` (Institutional Allocator Financial ID), series must be named (up to 10 per call)

Endpoints

List Institutional Allocator Financials

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

Batch Get Institutional Allocator Financial timeseries

Up to 10 series in one request, named by Institutional Allocator Financial ID in series.

Get Institutional Allocator Financial timeseries

One series over a time window, keyed by its Institutional Allocator Financial ID.

Metrics

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

Field	Name	Type	Description
`grossYieldUSD`	Gross Yield (USD)	float64	Gross yield earned in USD.
`incentivesUSD`	Incentives (USD)	float64	Incentives earned in USD.
`fundingCostUSD`	Funding Cost (USD)	float64	Funding cost paid 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 institutional-allocator-financials timeseries model, the parent slug, chain, allocator id, balance type, position id, token address and recognition basis, joined with underscores. (primary key)
`name`	string	`Eq`, `IsOneOf`, `Contains`	default	The display name of the series, the allocator name, position id, token symbol and balance 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.
`productSlug`	string	`Eq`, `IsOneOf`		The product or version within the parent protocol.
`chain`	string	`Eq`, `IsOneOf`		The short name of the chain (ethereum, base, solana).
`allocatorID`	string	`Eq`, `IsOneOf`		The institutional allocator’s identifier.
`balanceType`	string	`Eq`, `IsOneOf`		The balance type as classified by Blockworks Research.
`positionID`	string	`Eq`, `IsOneOf`		The identifier of the allocator’s position or funding line.
`tokenAddress`	string	`Eq`, `IsOneOf`		The token contract address (the mint address on Solana); null when unlabeled.
`recognitionBasis`	string	`Eq`, `IsOneOf`		How the amount is recognized, for example realized or accrued.
`allocatorName`	string	`Eq`, `IsOneOf`, `Contains`		The institutional allocator’s display name.
`tokenSymbol`	string	`Eq`, `IsOneOf`, `Contains`	yes	The token’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/institutional-allocator-financials/1d/<id>?timeframe=7d&selections=grossYieldUSD,incentivesUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"

See Get Institutional Allocator Financial 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