Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.extractor.live/llms.txt

Use this file to discover all available pages before exploring further.

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.
FieldTypeDefault
decimalsint18
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.
FieldTypeDefault
severityfloat0.1 (Info)
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:
FieldDescription
monitored_contractAddress of the token contract being monitored
allocationHuman-readable name of the allocation category (from Extractor API)
real_valueCurrent on-chain balance of the allocation address (adjusted for decimals)

Alert Types

Event TypeTrigger
total_supply_by_allocationsEmitted once per active allocation per scheduled run