---
description: >-
  The flow.lease REST API allows integrators, explorers, dashboards, and dApps
  to retrieve protocol state and historical data directly from the indexer.
---

# API Reference

### Chain

| Endpoint                                         | Description                                                      |
| ------------------------------------------------ | ---------------------------------------------------------------- |
| `GET /chain/info`                                | Get general chain info, contract addresses, start block, tokens. |
| `GET /chain/delay`                               | Get current average block delay (ms).                            |
| `GET /chain/blocks/height`                       | Get current block height.                                        |
| `GET /chain/addresses/balance/details/{address}` | Get full balance details for an address.                         |
| `GET /chain/addresses/data/{dAppAddress}/{key}`  | Read raw contract data storage by key.                           |
| `GET /chain/alias/by-address/{address}`          | List aliases of an address.                                      |
| `GET /chain/transactions/status?id=...`          | Get transaction status by IDs.                                   |

***

#### Cycles

| Endpoint                 | Description                          |
| ------------------------ | ------------------------------------ |
| `GET /cycles/current`    | Get current cycle info and progress. |
| `GET /cycles/{cycleNum}` | Get historical cycle info.           |
| `GET /cycles`            | Paginated cycles history.            |

***

#### Leases

| Endpoint                   | Description                                            |
| -------------------------- | ------------------------------------------------------ |
| `GET /leases/isInProgress` | Check if leasing rebalancing is currently in progress. |

***

#### Liquidity Providers (LP)

| Endpoint                             | Description                                   |
| ------------------------------------ | --------------------------------------------- |
| `GET /lp/apr`                        | Get current APR for liquidity providers.      |
| `GET /lp/balances`                   | Get current LP pool balances.                 |
| `GET /lp/withdraw-request/{address}` | Get withdrawal request for LP address.        |
| `GET /lp/history/{address}`          | Paginated LP history (deposits, withdrawals). |

***

#### Validators

| Endpoint                                     | Description                                     |
| -------------------------------------------- | ----------------------------------------------- |
| `GET /validators`                            | Paginated list of validators with full details. |
| `GET /validators/history/{validatorAddress}` | Historical leasing and payouts per validator.   |

***

#### Votes

| Endpoint                                  | Description                           |
| ----------------------------------------- | ------------------------------------- |
| `GET /votes/total`                        | Total active votes.                   |
| `GET /votes/validators`                   | Votes per validator.                  |
| `GET /votes/{address}`                    | Votes history for address.            |
| `GET /votes/stats/{address}`              | Vote statistics for address.          |
| `GET /votes/validator/{validatorAddress}` | Votes history for specific validator. |

***

#### Emergency Votes

| Endpoint                                            | Description                           |
| --------------------------------------------------- | ------------------------------------- |
| `GET /votes-emergency/total`                        | Total emergency votes.                |
| `GET /votes-emergency/validators`                   | Emergency votes per validator.        |
| `GET /votes-emergency/{address}`                    | Emergency vote history for address.   |
| `GET /votes-emergency/stats/{address}`              | Emergency vote stats for address.     |
| `GET /votes-emergency/validator/{validatorAddress}` | Emergency vote history for validator. |
