> ## 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. # List Lending Market Liquidation Pairs > 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. ## OpenAPI ````yaml api-reference/data-api/openapi.json GET /query/tabular/lending-market-liquidations openapi: 3.0.0 info: description: >- The Blockworks Data API is a unified, read-only REST interface to Blockworks' warehouse-modeled crypto dataset, powered by Messari's research and data infrastructure. It serves two kinds of models: tabular models, which return current, filterable, sortable rows for entities such as assets, networks, protocols, exchanges, stablecoins, and ETFs; and timeseries models, which return historical metric series at a chosen granularity for one or many entities. Every endpoint shares the same query grammar (column projection, per-column filters, sorting, and pagination) and returns the standard `{ "error": ..., "data": ... }` envelope. Authenticate by sending your API key in the `X-Blockworks-API-Key` header. title: Blockworks Data API version: 0.1.0 servers: - description: Blockworks API url: https://api.blockworks.com security: - apiKey: [] tags: - description: >- Models documented under Assets: Assets (table), Tokens (table), Asset Marketcap (timeseries), Asset Price (timeseries), Asset Sharpe (timeseries), Asset Supply (timeseries), Asset Volatility (timeseries), Project Tokens (timeseries). name: Assets - description: >- Models documented under Blockchains: Blockchains (table), Blockchains (timeseries). name: Blockchains - description: >- Models documented under Derivatives: Perpetual Markets (table), Perpetual Markets (timeseries). name: Derivatives - description: >- Models documented under Digital Asset Treasury Companies: DAT Companies (table), DAT Company Assets (table), DAT Companies (timeseries), DAT Companies by Asset (timeseries). name: Digital Asset Treasury Companies - description: >- Models documented under ETFs: ETF Assets (table), ETF Providers (table), ETF Assets (timeseries), ETF Providers (timeseries). name: ETFs - description: >- Models documented under Exchanges: Exchange Country (timeseries), Exchange Region (timeseries), Exchange Type (timeseries), Exchanges (timeseries). name: Exchanges - description: >- Models documented under Fundraising: Acquisition Deals (table), Fund Managers (table), Funding Round Investors (table), Funding Rounds (table), Funds (table), Sector Fundraising (timeseries). name: Fundraising - description: >- Models documented under Launchpads: Launchpad Chains (table), Launchpads (table), Launchpads (timeseries), Launchpads by Chain (timeseries). name: Launchpads - description: >- Models documented under Lending Protocols: Lending Market Balances (table), Lending Market Financials (table), Lending Market Flows (table), Lending Market Interest Rates (table), Lending Market Liquidations (table), Lending Protocol Product Markets (table), Lending Protocol Products (table), Lending Protocols (table), Lending Market Balances (timeseries), Lending Market Financials (timeseries), Lending Market Flows (timeseries), Lending Market Interest Rates (timeseries), Lending Market Liquidations (timeseries), Lending Protocols (timeseries), Lending Protocols by Product (timeseries), Lending Protocols by Product Market (timeseries). name: Lending Protocols - description: >- Models documented under Markets: Markets (table), Market (BQEN) (timeseries). name: Markets - description: >- Models documented under Mindshare & Sentiment: Asset Group Sentiment (timeseries), Asset Investor Mentions (timeseries), Asset Mindshare (timeseries), Asset Sentiment (timeseries), Project Mindshare (timeseries), Sector Asset Mindshare (timeseries), Sector Asset Sentiment (timeseries), Sector Investor Mentions (timeseries), Sub-Sector Asset Mindshare (timeseries), Sub-Sector Asset Sentiment (timeseries). name: Mindshare & Sentiment - description: 'Models documented under News: News Feed (table), Topics (timeseries).' name: News - description: >- Models documented under Perp DEX Protocols: Perp DEX Protocols (table), Perp DEX Protocols (timeseries). name: Perp DEX Protocols - description: >- Models documented under Projects: Project Tokens (table), Projects (timeseries). name: Projects - description: >- Models documented under Protocol Revenue: Protocol Revenue (timeseries), Protocol Revenue by Product (timeseries). name: Protocol Revenue - description: >- Models documented under Real World Assets: RWA Spot DEX Segments (table), RWA Spot DEX Activity (timeseries). name: Real World Assets - description: >- Models documented under Research Reports (Tabular): Research Reports (table). name: Research Reports (Tabular) - description: >- Models documented under Sector Market Data: Sector Marketdata (timeseries), Sub-Sector Marketdata (timeseries). name: Sector Market Data - description: >- Models documented under Spot DEX Protocols: Spot DEX Protocol Chains (table), Spot DEX Protocols (table), Spot DEX Protocols (timeseries), Spot DEX Protocols by Chain (timeseries). name: Spot DEX Protocols - description: >- Models documented under Stablecoins: Stablecoin Chains (table), Stablecoin Currencies (table), Stablecoin FX Pairs (table), Stablecoin Issuers (table), Stablecoin Products (table), Stablecoin Reserve Entities (table), Stablecoin FX (timeseries), Stablecoin Reserves (timeseries), Stablecoins by Chain (timeseries), Stablecoins by Currency (timeseries), Stablecoins by Issuer (timeseries), Stablecoins by Product (timeseries). name: Stablecoins - description: >- Models documented under TCG Platforms: TCG Platform Chains (table), TCG Platforms by Chain (timeseries). name: TCG Platforms - description: >- Discovery of the tabular models: one row per entity, with per-column filters, sorting and pagination. name: Tabular - description: >- Discovery of the timeseries models: one series per entity, as points at the granularities each model declares. name: Timeseries - description: >- Models documented under Token Transparency: Token Transparency Filing Questions (table), Token Transparency Filing Schemas (table), Token Transparency Filings (table), Token Transparency Projects (table). name: Token Transparency - description: 'Models documented under Token Unlocks: Token Unlocks (timeseries).' name: Token Unlocks - description: >- Models documented under Tokenized Commodities: Tokenized Commodities (table), Tokenized Commodity Chains (table), Tokenized Commodity Issuers (table), Tokenized Commodity Products (table), Tokenized Commodities by Chain (timeseries), Tokenized Commodities by Commodity (timeseries), Tokenized Commodities by Issuer (timeseries), Tokenized Commodities by Product (timeseries). name: Tokenized Commodities - description: >- Models documented under Tokenized Equities: Tokenized Equities (table), Tokenized Equity Chains (table), Tokenized Equity Issuers (table), Tokenized Equity Products (table), Tokenized Equities by Chain (timeseries), Tokenized Equities by Equity (timeseries), Tokenized Equities by Issuer (timeseries), Tokenized Equities by Product (timeseries). name: Tokenized Equities - description: >- Models documented under Vaults: Vault Chains (table), Vault Curators (table), Vault Protocols (table), Vault Curators (timeseries), Vault Protocols (timeseries), Vaults by Chain (timeseries). name: Vaults paths: /query/tabular/lending-market-liquidations: get: tags: - Lending Protocols summary: List Lending Market Liquidation Pairs description: >- 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. operationId: getTabular_lending_market_liquidations parameters: - description: Lending Market Liquidation ID equals. in: query name: idEq schema: type: string - description: Lending Market Liquidation ID is one of (comma-separated). in: query name: idIsOneOf schema: items: type: string type: array - description: Name equals. in: query name: nameEq schema: type: string - description: Name is one of (comma-separated). in: query name: nameIsOneOf schema: items: type: string type: array - description: Name contains (case-insensitive substring). in: query name: nameContains schema: type: string - description: Slug equals. in: query name: slugEq schema: type: string - description: Slug is one of (comma-separated). in: query name: slugIsOneOf schema: items: type: string type: array - description: Parent Slug equals. in: query name: parentSlugEq schema: type: string - description: Parent Slug is one of (comma-separated). in: query name: parentSlugIsOneOf schema: items: type: string type: array - description: Product Slug equals. in: query name: productSlugEq schema: type: string - description: Product Slug is one of (comma-separated). in: query name: productSlugIsOneOf schema: items: type: string type: array - description: Chain equals. in: query name: chainEq schema: type: string - description: Chain is one of (comma-separated). in: query name: chainIsOneOf schema: items: type: string type: array - description: Market ID equals. in: query name: marketIDEq schema: type: string - description: Market ID is one of (comma-separated). in: query name: marketIDIsOneOf schema: items: type: string type: array - description: Market Name equals. in: query name: marketNameEq schema: type: string - description: Market Name is one of (comma-separated). in: query name: marketNameIsOneOf schema: items: type: string type: array - description: Market Name contains (case-insensitive substring). in: query name: marketNameContains schema: type: string - description: Market Type equals. in: query name: marketTypeEq schema: type: string - description: Market Type is one of (comma-separated). in: query name: marketTypeIsOneOf schema: items: type: string type: array - description: Collateral Token Address equals. in: query name: collateralTokenAddressEq schema: type: string - description: Collateral Token Address is one of (comma-separated). in: query name: collateralTokenAddressIsOneOf schema: items: type: string type: array - description: Collateral Token Symbol equals. in: query name: collateralTokenSymbolEq schema: type: string - description: Collateral Token Symbol is one of (comma-separated). in: query name: collateralTokenSymbolIsOneOf schema: items: type: string type: array - description: Collateral Token Symbol contains (case-insensitive substring). in: query name: collateralTokenSymbolContains schema: type: string - description: Debt Token Address equals. in: query name: debtTokenAddressEq schema: type: string - description: Debt Token Address is one of (comma-separated). in: query name: debtTokenAddressIsOneOf schema: items: type: string type: array - description: Debt Token Symbol equals. in: query name: debtTokenSymbolEq schema: type: string - description: Debt Token Symbol is one of (comma-separated). in: query name: debtTokenSymbolIsOneOf schema: items: type: string type: array - description: Debt Token Symbol contains (case-insensitive substring). in: query name: debtTokenSymbolContains schema: type: string - description: Protocol Slug equals. in: query name: protocolSlugEq schema: type: string - description: Protocol Slug is one of (comma-separated). in: query name: protocolSlugIsOneOf schema: items: type: string type: array - description: Protocol Name equals. in: query name: protocolNameEq schema: type: string - description: Protocol Name is one of (comma-separated). in: query name: protocolNameIsOneOf schema: items: type: string type: array - description: Project ID equals. in: query name: projectIDEq schema: type: string - description: Project ID is one of (comma-separated). in: query name: projectIDIsOneOf schema: items: type: string type: array - description: Network ID equals. in: query name: networkIDEq schema: type: string - description: Network ID is one of (comma-separated). in: query name: networkIDIsOneOf schema: items: type: string type: array - description: Field to sort by; defaults to the model's default sort column. in: query name: sortBy schema: default: name enum: - name - slug - parentSlug - collateralTokenSymbol - debtTokenSymbol type: string - description: Sort direction. in: query name: sortDirection schema: default: asc enum: - asc - desc type: string - description: 1-based page number. in: query name: page schema: type: integer - description: Rows per page (max 1000, default 100). in: query name: pageSize schema: type: integer - description: Comma-separated fields to return; defaults to all fields. in: query name: selections schema: items: enum: - id - name - slug - parentSlug - productSlug - chain - marketID - marketName - marketType - collateralTokenAddress - collateralTokenSymbol - debtTokenAddress - debtTokenSymbol - protocolSlug - protocolName - projectID - networkID type: string type: array - description: >- Response format, overriding the Accept header: json (default), csv, or jsonl (NDJSON). csv and jsonl return the rows as a downloadable file. in: query name: acceptFormat schema: default: json enum: - json - csv - jsonl type: string responses: '200': content: application/json: example: data: - chain: collateralTokenAddress: collateralTokenSymbol: debtTokenAddress: debtTokenSymbol: id: marketID: marketName: marketType: name: networkID: parentSlug: productSlug: projectID: protocolName: protocolSlug: slug: error: null metadata: totalPages: 1 totalRows: 1 schema: properties: data: items: $ref: '#/components/schemas/LendingMarketLiquidationsRow' type: array error: nullable: true type: string metadata: description: >- Pagination totals for the full filtered result set, independent of the current page. properties: totalPages: format: int64 type: integer totalRows: format: int64 type: integer required: - totalRows - totalPages type: object required: - data - metadata type: object application/x-ndjson: schema: description: JSON Lines (NDJSON); one JSON object per line. type: string text/csv: schema: description: CSV with a header row; one row per record. type: string description: >- One page of matching rows, with the totals for the whole filtered set. '400': content: application/json: example: data: null error: unknown query parameter "id" schema: $ref: '#/components/schemas/ErrorResponse' description: >- The request is malformed: an unknown query parameter (a filter needs its operator suffix, such as idEq), a filter value of the wrong type, a sortBy field that is not sortable, an unknown selections field, or a pageSize above 1000. '401': content: application/json: example: data: null error: this model requires authentication schema: $ref: '#/components/schemas/ErrorResponse' description: No API key was sent and the model requires one. '403': content: application/json: example: data: null error: >- this model requires the "lending-protocols-dataset" permission; see https://app.blockworks.com/account/api for the public API permissions you hold schema: $ref: '#/components/schemas/ErrorResponse' description: >- The API key is not valid, or does not hold the "lending-protocols-dataset" permission. '404': content: application/json: example: data: null error: tabular model "unknown-model" not found schema: $ref: '#/components/schemas/ErrorResponse' description: >- The path names a model that does not exist: the slug is mistyped or the model was removed. components: schemas: LendingMarketLiquidationsRow: properties: chain: description: >- The short name of the chain the market lives on (ethereum, bnb, solana). nullable: true type: string collateralTokenAddress: description: >- The seized collateral token's contract address (the mint address on Solana); null when unlabeled. nullable: true type: string collateralTokenSymbol: description: The seized collateral token's ticker symbol. nullable: true type: string debtTokenAddress: description: >- The repaid debt token's contract address (the mint address on Solana); null when unlabeled. nullable: true type: string debtTokenSymbol: description: The repaid debt token's ticker symbol. nullable: true type: string id: description: >- 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. nullable: true type: string marketID: description: >- The market or pool address; null when the protocol does not label markets. nullable: true type: string marketName: description: The market display name. nullable: true type: string marketType: description: >- The market type where the protocol distinguishes one (for example core, pooled or credit_vault); null otherwise. nullable: true type: string name: description: >- The display name of the series, the market name and the collateral and debt token symbols. nullable: true type: string networkID: description: The chain's networkID in the blockchains model; null when unmapped. nullable: true type: string parentSlug: description: >- The parent protocol's short name, the id in lending-protocols (aave). nullable: true type: string productSlug: description: The product or version within the parent protocol (aave-v3). nullable: true type: string projectID: description: The identifier of the parent protocol's project record. nullable: true type: string protocolName: description: >- The name of the protocol record mapped to the product; null when unmapped. nullable: true type: string protocolSlug: description: >- The slug of the protocol record mapped to the product; null when unmapped. nullable: true type: string slug: description: >- The parent protocol's project slug, the slug used for the same protocol across the API. nullable: true type: string type: object ErrorResponse: properties: data: description: Always null on an error. nullable: true type: object error: description: What went wrong, in one sentence. type: string required: - error - data type: object securitySchemes: apiKey: description: >- API key sent in the `X-Blockworks-API-Key` header; `x-messari-api-key` is accepted for existing integrations. The catalog endpoints and models open to everyone need no key. in: header name: X-Blockworks-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.