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

# Institutional Allocator Performances

> Balance-weighted supply rates on each position an institutional allocator deploys to, and borrow rates on each funding line it draws on, as APR and APY, with the balances used as weights. Each series is one position or funding line token, keyed by protocol, chain, allocator, balance type, position and token.

One row per institutional allocator performance, keyed by protocol, chain, allocator, balance type, position and token: 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-performances timeseries model.

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

## Endpoints

> [card] [List Institutional Allocator Performances](https://docs.blockworks.com/api-reference/data-api/institutional-allocators/tabular-institutional-allocator-performances.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get Institutional Allocator Performance timeseries](https://docs.blockworks.com/api-reference/data-api/institutional-allocators/timeseries-institutional-allocator-performances.md)
>
> Up to 10 series in one request, named by Institutional Allocator Performance ID in `series`.

> [card] [Get Institutional Allocator Performance timeseries](https://docs.blockworks.com/api-reference/data-api/institutional-allocators/timeseries-institutional-allocator-performances-by-id.md)
>
> One series over a time window, keyed by its Institutional Allocator Performance ID.

## 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 |
| - | - | - | - | - |
| `weightedSupplyAPR` | Weighted Supply APR | float64 | | Balance-weighted supply APR, as a decimal. |
| `weightedSupplyAPY` | Weighted Supply APY | float64 | | Balance-weighted supply APY, as a decimal. |
| `weightedSupplyBalance` | Weighted Supply Balance | float64 | | Supply balance used as the rate weight, in native token units. |
| `weightedBorrowAPR` | Weighted Borrow APR | float64 | | Balance-weighted borrow APR, as a decimal. |
| `weightedBorrowAPY` | Weighted Borrow APY | float64 | | Balance-weighted borrow APY, as a decimal. |
| `weightedBorrowBalance` | Weighted Borrow Balance | float64 | | Borrow balance used as the rate weight, in native token units. |

## 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-performances timeseries model, the parent slug, chain, allocator id, balance type, position id and token address, 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. |
| `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

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/institutional-allocator-performances/1d/<id>?timeframe=7d&selections=weightedSupplyAPR,weightedSupplyAPY" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Institutional Allocator Performance timeseries](https://docs.blockworks.com/api-reference/data-api/institutional-allocators/timeseries-institutional-allocator-performances-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.