> For the complete documentation index, see [llms.txt](https://perps.gitbook.io/perps./llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://perps.gitbook.io/perps./overview-1/indexer-and-data-flow.md).

# Indexer & Data Flow

`perps.` uses indexed blockchain data to make the app fast and readable.

The chain remains the source of truth for contract state. Indexed data is used to power product views such as charts, activity feeds, search, profile summaries, market stats, and progression surfaces.

## Event Sources

Public event categories include:

* Creator-token creation.
* Spot buys and sells.
* Graduation events.
* Perpetual position opens and closes.
* Liquidations.
* Funding updates.
* Profile and progression events.

## Data Outputs

Indexed and derived data can power:

* Creator profiles.
* Market pages.
* Trade history.
* Candles and chart history.
* Leaderboards.
* Notifications.
* XP, badges, and ranks.

## Freshness

Indexed data can lag the latest block. Critical trading actions should still be reviewed in wallet prompts and transaction previews.

## Public Status Surfaces

The app may expose health or status surfaces to make chain/indexer state easier to understand. These surfaces are informational and may change during testnet.