> 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/counters.md).

# Counters

How to monitor rolling buy/sell trade counts or volume across configured intervals.

Counters summarizes aggregator buy/sell activity over configured rolling intervals. It is a compact heartbeat for activity, not a price chart.

![Counters pane showing rolling buy and sell activity for several configured intervals.](https://492667312-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbAbZvilC5_MURToRmD%2Fuploads%2FZy1SgKq60xl6v2yJSMkg%2Fwidget-counters.jpg?alt=media)

*Each row summarizes buy and sell activity over its labeled rolling interval.*

## Find and open it

Open the widget drawer, select **AGGR Widgets**, then choose **Counters**. 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

* Choose count or volume mode; count measures events, while volume measures traded amount/notional according to the feed.
* Enter intervals in minutes, for example `1m, 5m, 10m, 15m`. The widget reads the numeric value as minutes, rejects entries without a number, and removes duplicates.
* Enable liquidation-only counting when you want to isolate those events; market coverage follows the pane’s market configuration and dashboard sync.

## How to read the display

Each interval shows buy and sell portions as opposing widths. In amount mode, labels show formatted buy/sell amounts; in count mode, they show event counts. Values are rolling snapshots from the selected market feed, not candle boundaries. Liquidation-only mode, interval list, granularity, and count/amount settings change what is measured.

## Five practical market-watch uses

1. Compare count with volume mode to distinguish many small events from fewer large ones.
2. Watch short and longer intervals together to see whether activity is accelerating or normalizing.
3. Enable liquidation-only mode to review liquidation activity in the same interval set.
4. Align a counter change to Chart or Trades using the closest shared timestamp.
5. Record the configured intervals when sharing a snapshot so another reader knows the measurement window.

## Data limits and troubleshooting

Results depend on the selected market feed, configured intervals, mode, and event classifications. Rolling windows differ from candle buckets. If no value appears, check interval syntax, liquidation-only setting, selected market, and feed state.

## Related guides

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