> For the complete documentation index, see [llms.txt](https://docs.thekingfisher.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thekingfisher.io/tools/stats.md).

# Stats

How to build rolling aggregator metrics and display trade, volume, delta, or liquidation series.

Stats plots rolling metrics from the selected aggregator stream. A bucket is a configured formula and time window, so the displayed series reflects those choices rather than a universal market statistic.

<figure><img src="https://492667312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbAbZvilC5_MURToRmD%2Fuploads%2FR34lUUoexivtrsdqzP7l%2Fimage.png?alt=media&amp;token=14d2c331-ba97-469e-bfe1-9639cf0aad65" alt="Stats widget showing trade-count, volume-delta, trade-delta, and liquidation-delta readouts beside their plotted history."><figcaption><p>The left-side values and plotted history reflect the configured metric buckets; each formula and window determines what its series means.</p></figcaption></figure>

## Find and open it

Open the widget drawer, select **AGGR Widgets**, then choose **Stats**. Select a placement to add it to your workspace, or use **Open in fullscreen** in the drawer when you need a larger view.

## Controls and filters

* Add or remove metric buckets and choose the metric/formula, rolling window, chart style (line, area, or histogram), color, and precision.
* Use crosshair synchronization with compatible charts. Visible ranges remain pane-specific.

## How to read the display

Each bucket displays its configured expression over a rolling window. Defaults include TRADES (cbuy + csell), VOLUME Δ (vbuy − vsell), TRADES Δ (cbuy − csell), and optional 1H LIQUIDATIONS Δ (lbuy − lsell). Signed deltas show buy-versus-sell imbalance, not total activity. Line/area/histogram, precision, and window settings change the display; use Trades or Chart to inspect event order.

## Five practical market-watch uses

1. Compare total trades with trade delta to separate activity from imbalance.
2. Track a rolling volume delta over more than one window to see whether its sign is persistent or short-lived.
3. Use a liquidation bucket as an event series and align it with price rather than interpreting a quiet interval as no risk.
4. Change line/area/histogram presentation to make scale and timing easier to inspect, keeping formulas fixed.
5. Sync crosshair with Chart to compare a bucket change to the same price interval.

## Data limits and troubleshooting

Metrics depend on chosen formula, market feed, window, precision, and stream coverage. Rolling windows are not necessarily candle boundaries. If a line is flat or missing, check bucket formula, interval, data coverage, and visibility; ensure comparisons use the same settings.

## Related guides

See [AGGR Widgets](https://docs.thekingfisher.io/tools/aggr-widgets.md), [Chart](https://docs.thekingfisher.io/tools/chart.md), [Trades](https://docs.thekingfisher.io/tools/trades.md), [Counters](https://docs.thekingfisher.io/tools/counters.md).
