---
title: "DeFi lending liquidations"
method: GET
path: "/api/public/defi-liquidations"
tags: ["DeFi", "free"]
---

# DeFi lending liquidations

`GET /api/public/defi-liquidations`

## Request

- Base URL: `https://coinlobster.com`
- URL: `https://coinlobster.com/api/public/defi-liquidations`
- Auth: none required

Lending liquidations from Aave V3 on Ethereum, Arbitrum and Base. A third party repaid the debt and seized the collateral, so both wallets are named. Distinct from a perp liquidation and never summed with one. count and total_usd cover exactly the rows returned, and the window field states the period those rows span: it is a page sum, not a fixed 24h total. The 24h lending figure lives on /api/public/liquidations. Aave profitUSD is broken upstream and is never reported.

## Query parameters

- `chain` string
- `protocol` string
- `limit` integer

## Response `200`

Success

- object
  - `success` true, required
  - `data` LiquidationLane, required: ONE lane. Perp and lending liquidations are different events and are never summed.
    - `count` integer
    - `totalUsd` number
    - `longUsd` number
    - `shortUsd` number
    - `longSharePct` number, nullable: null on an empty window. Never defaults to 50.
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)