API Reference

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

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.