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.

Last updated