# Use Cases

> Markdown export of the Gearbox Protocol documentation page for agents and retrieval systems.

Canonical page: https://docs.gearbox.finance/developers/use-cases
Source file: content/developers/use-cases.mdx
Section router: https://docs.gearbox.finance/developers/llms.txt
Section full export: https://docs.gearbox.finance/developers/llms-full.txt

The SDK guide shows you how to use individual methods. This section shows you how to combine them to build real applications.

## Choose Your Path

| If you're building...             | Start here                                                                                                           | You'll learn                                                    |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| Web dashboard, portfolio UI       | [Frontend Applications](https://docs.gearbox.finance/developers/frontend-applications)       | Data fetching patterns, display mapping, real-time updates      |
| Indexer, analytics, data pipeline | [Backend Services](https://docs.gearbox.finance/developers/backend-services)                 | Historical snapshots, event indexing, state tracking            |
| Liquidation bot                   | [Liquidation Bots](https://docs.gearbox.finance/developers/liquidation-bots)                 | Account monitoring, health factor filtering, execution patterns |
| Health monitoring                 | [Health Factor Monitoring](https://docs.gearbox.finance/developers/health-factor-monitoring) | Track HF over time, alerts, risk analysis                       |

## Quick Decision Guide

**Need to display data to users in real-time?** Start with [Frontend Applications](https://docs.gearbox.finance/developers/frontend-applications). You'll use `marketRegister` for cached data and compressors for fresh queries.

**Need to collect and analyze historical data?** Start with [Backend Services](https://docs.gearbox.finance/developers/backend-services). You'll index events and snapshot state at specific blocks.

**Need to monitor accounts and execute on-chain actions?** Start with [Liquidation Bots](https://docs.gearbox.finance/developers/liquidation-bots). You'll filter accounts by health factor and use the Router for execution.

**Need to track account health and alert on risk?** Start with [Health Factor Monitoring](https://docs.gearbox.finance/developers/health-factor-monitoring). You'll poll compressors, classify risk levels, and build alerting.

## Prerequisites

Before diving into use-case guides, complete:

1. [**Setup**](https://docs.gearbox.finance/developers/sdk-setup) - Install the SDK and initialize `GearboxSDK`
2. [**Reading Data**](https://docs.gearbox.finance/developers/reading-data) - Understand `marketRegister` and basic queries

## Common Foundation: Compressors

All use cases rely on compressors for efficient data fetching. Compressors aggregate on-chain data into single calls, reducing RPC overhead.

| Compressor                | Use Case                                      |
| ------------------------- | --------------------------------------------- |
| `MarketCompressor`        | Pool state, credit manager config, token data |
| `CreditAccountCompressor` | Account queries with filtering and pagination |
| `PriceFeedCompressor`     | Oracle status and update requirements         |

See [Compressors Reference](https://docs.gearbox.finance/developers/compressors) for the complete API.

## Relationship to Other Guides

```
SDK Guide
├── setup.md              # Installation and initialization
├── reading-data.md       # Basic queries
├── credit-accounts.md    # Account operations
├── multicalls.md         # Operation overview
├── multicalls/           # Individual operation docs
│   └── [10 operation pages]
└── use-cases/            # <-- You are here
    ├── frontend-applications.md
    ├── backend-services.md
    ├── liquidation-bots.md
    └── health-factor-monitoring.md
```

The **multicalls/** directory documents individual operations (add collateral, manage debt, etc.). The **use-cases/** directory shows how to combine those operations with data fetching to build complete applications.