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

# Lending Market Flows

> Daily net, gross inflow and gross outflow in USD for one token in one lending market, split by balance type (deposit or borrow) and subtype. Each series is keyed like lending-market-balances, by protocol, product, chain, market, token, balance type and balance subtype. Many series per market, so name the series you need.

One row per lending market flow, 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-flows timeseries model, and the same key as lending-market-balances.

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

## Endpoints

<CardGroup cols={2}>
  <Card title="List Lending Market Flows" icon="arrow-right" href="/api-reference/data-api/lending-protocols/tabular-lending-market-flows">
    One page of rows with per-column filters, sorting and pagination.
  </Card>

  <Card title="Batch Get Lending Market Flow timeseries" icon="arrow-right" href="/api-reference/data-api/lending-protocols/timeseries-lending-market-flows">
    Up to 20 series in one request, named by Lending Market Flow ID in `series`.
  </Card>

  <Card title="Get Lending Market Flow timeseries" icon="arrow-right" href="/api-reference/data-api/lending-protocols/timeseries-lending-market-flows-by-id">
    One series over a time window, keyed by its Lending Market Flow ID.
  </Card>
</CardGroup>

## Metrics

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

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `netFlowUSD` | Net Flow (USD) | float64 | | Net flow in USD, gross inflow plus gross outflow. |
| `grossInflowUSD` | Gross Inflow (USD) | float64 | | Gross inflow in USD. |
| `grossOutflowUSD` | Gross Outflow (USD) | float64 | | Gross outflow in USD (negative). |

## 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-flows timeseries model, the parent slug, product slug, chain, market key, token key, balance type and balance subtype, joined with underscores; identical to the lending-market-balances id. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the flow, 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 flow is into deposits or borrows. |
| `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

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/lending-market-flows/1d/<id>?timeframe=7d&selections=netFlowUSD,grossInflowUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Lending Market Flow timeseries](/api-reference/data-api/lending-protocols/timeseries-lending-market-flows-by-id) for the response and the errors.


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