> For the complete documentation index, see [llms.txt](https://docs.satoshiterminal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.satoshiterminal.io/resources/copy-of-defi-analytics/insights-and-predictive-analytics/defi-liquidation-predictors.md).

# DeFi Liquidation Predictors

**Implementation Details**

**Class Names**

| Model Name                | Parameters Class       | Data Class               |
| ------------------------- | ---------------------- | ------------------------ |
| DeFiLiquidationPredictors | LiquidationQueryParams | LiquidationPredictorData |

**Import Statement**

```python
pythonCopyEditfrom satoshi_terminal.models.defi_liquidation_predictors import (
    DeFiLiquidationPredictors,
    LiquidationQueryParams,
    LiquidationPredictorData,
)
```

***

**Parameters**

| Name               | Type  | Description                                                               | Default | Optional |
| ------------------ | ----- | ------------------------------------------------------------------------- | ------- | -------- |
| protocol\_name     | str   | Name of the protocol to monitor (e.g., Aave, MakerDAO).                   | None    | False    |
| at-risk\_threshold | float | Minimum collateralization ratio to flag positions as at-risk.             | 1.5     | True     |
| time\_horizon      | int   | Forward-looking time horizon (in hours) for liquidation risk projections. | 24      | True     |

***

**Data**

| Name                   | Type     | Description                                                                 |
| ---------------------- | -------- | --------------------------------------------------------------------------- |
| protocol\_name         | str      | Protocol being analyzed for liquidation risks.                              |
| at\_risk\_positions    | int      | Total number of positions flagged as at-risk.                               |
| largest\_liquidation   | dict     | Details of the largest potential liquidation event (wallet, amount, asset). |
| projected\_liquidation | float    | Estimated liquidation volume (in USD).                                      |
| timestamp              | datetime | Timestamp of the analysis.                                                  |

***

**Key Features**

* **Real-Time At-Risk Position Tracking:** Continuously monitors lending and borrowing positions for collateralization risks.
* **Market Impact Projections:** Simulate the price impact of liquidation events on tokens and protocols.
* **Multi-Protocol Monitoring:** Simultaneous analysis of liquidation risks across interconnected protocols.
* **Threshold Customization:** User-defined thresholds for flagging at-risk positions.