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

> Daily liquidations for one collateral and debt token pair in one lending market: collateral seized, debt repaid, losses and fees in USD and the liquidation count. Each series is one pair, keyed by protocol, product, chain, market, collateral token and debt token. Many series per market, so name the series you need.

One row per collateral and debt token pair liquidated in a lending market, keyed by protocol, product, chain, market, collateral token and debt token: the market and both tokens, the parent protocol and product, chain and the mapped protocol, project and network records. The id is the series key of the lending-market-liquidations timeseries model.

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

## Endpoints

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

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

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

## Metrics

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

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `collateralSeizedUSD` | Collateral Seized (USD) | float64 | | Collateral seized from liquidated borrowers in USD. |
| `debtSeizedUSD` | Debt Seized (USD) | float64 | | Debt repaid by liquidators in USD. |
| `liquidationLossUSD` | Liquidation Loss (USD) | float64 | | Liquidation losses (bad debt) in USD. |
| `liquidationFeesUSD` | Liquidation Fees (USD) | float64 | | Liquidation fees in USD. |
| `liquidationCount` | Liquidation Count | float64 | | Number of liquidation events. |

## 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-liquidations timeseries model, the parent slug, product slug, chain, market key, collateral token key and debt token key, joined with underscores. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the series, the market name and the collateral and debt token symbols. |
| `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. |
| `collateralTokenAddress` | string | `Eq`, `IsOneOf` | | The seized collateral token's contract address (the mint address on Solana); null when unlabeled. |
| `collateralTokenSymbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The seized collateral token's ticker symbol. |
| `debtTokenAddress` | string | `Eq`, `IsOneOf` | | The repaid debt token's contract address (the mint address on Solana); null when unlabeled. |
| `debtTokenSymbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The repaid debt 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. |
| `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-liquidations/1d/<id>?timeframe=7d&selections=collateralSeizedUSD,debtSeizedUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

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


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