CDP Market Liquidations

One row per collateral and debt token pair liquidated in a CDP 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 cdp-market-liquidations timeseries model.


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

Endpoints

List CDP Market Liquidation Pairs

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

Batch Get CDP Market Liquidation timeseries

Up to 10 series in one request, named by CDP Market Liquidation ID in series.

Get CDP Market Liquidation timeseries

One series over a time window, keyed by its CDP Market Liquidation ID.

Metrics

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

Field	Name	Type	Description
`collateralSeizedUSD`	Collateral Seized (USD)	float64	Collateral seized from liquidated borrowers in USD.
`debtRepaidUSD`	Debt Repaid (USD)	float64	Debt repaid by liquidators in USD.
`liquidationFeesGrossUSD`	Gross Liquidation Fees (USD)	float64	Liquidation penalty paid by liquidated borrowers in USD.
`liquidationFeesNetUSD`	Net Liquidation Fees (USD)	float64	Share of the liquidation penalty paid on to keepers in USD.
`liquidationFeeRevenueUSD`	Liquidation Fee Revenue (USD)	float64	Share of the liquidation penalty kept by the protocol in USD.
`liquidationLossUSD`	Liquidation Loss (USD)	float64	Liquidation losses (bad debt) 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 cdp-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, for example sky.
`productSlug`	string	`Eq`, `IsOneOf`		The product or version within the parent protocol (sky-mcd-vaults).
`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 (for Sky, the vault ilk such as ETH-A).
`marketType`	string	`Eq`, `IsOneOf`		The market type where the protocol distinguishes one (for example vault, lp or lockstake); 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

curl

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

See Get CDP Market Liquidation 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