Skip to main content

Overview

The Total Supply Monitor by Allocations tracks the circulating balance of individual tokenomics allocation addresses (e.g., team wallet, treasury, vesting contracts). Rather than comparing against a single expected cap, it reports the real-time balance of every active allocation defined in the project’s tokenomics configuration. On each scheduled run the monitor:
  1. Fetches active allocation categories for the monitored contract from the Extractor API
  2. Queries Dune Analytics for per-address transfer totals (debit, credit, balance) on-chain
  3. Emits one alert per allocation with the current balance

Allocation Source

Allocation definitions are pulled automatically from the Extractor API.

Decimals

The number of decimal places used by the token contract. Passed directly to the Dune Analytics query to return human-readable balance values. Override this for tokens that use non-standard precision (e.g., USDC uses 6).

Severity

A fixed severity level applied to all alerts emitted by this monitor. Unlike the basic Total Supply Monitor, there is no match/mismatch distinction — every run unconditionally emits one alert per allocation. Set a higher severity if you want allocation balance updates to appear as actionable alerts rather than informational reports.

Alert Metadata

Every alert emitted by this monitor includes the following fields:

Alert Types