Players buy/sell in-game NFTs on the IlluviDEX (The Illuvium Exchange). Players were also able to buy a limited number of land plots in June 2022.

Illuvium is a collectible NFT RPG game and auto-battler rolled into one. Illuvium was founded by Kieran & Aaron Warwick and launched in 2020.

ILV tokenholders own & govern the protocol. They currently take a cut of the transaction fees paid on IlluviDEX and kept all the proceeds from the land sale (revenue). Illuvium's investors include Delphi Digital, Yield Guild Games, Bitscale, etc.

github

twitter

discord

etherscan

website

Gaming

Illuvium

# Illuvium Treasury Methodology

## 1. Overview

The Illuvium treasury metric measures the total USD value of all tokens held in Illuvium's designated treasury address on Ethereum. This metric answers the business question: "What is the current market value of assets held in Illuvium's treasury?" The calculation tracks token balance changes over time, maintains cumulative balances for each token, and converts everything to USD using daily price feeds to provide a comprehensive view of treasury holdings.

## 2. Data sources

The calculation uses several raw data sources:
- **Blockchain events**: Parsed Ethereum `Transfer` events and transaction traces to track token movements into and out of the treasury address
- **Transaction data**: Ethereum transaction records that affect token balances for the specified treasury address
- **External data**: End-of-day token price feeds for USD conversion of all held tokens
- **Token metadata**: Token information including symbols and decimal precision for proper balance calculations

## 3. Step-by-step calculation

### Component A: Balance change extraction
- **Purpose**: Identifies and quantifies all token balance changes for the Illuvium treasury address
- **Logic**: The system monitors the specific Ethereum address `0x58c37a622cdf8ace54d8b25c58223f61d0d738aa` for all token movements. It processes `Transfer` events and transaction traces to capture when tokens are received or sent from this address. Each balance change is recorded with a timestamp, token address, and the net change amount (positive for inflows, negative for outflows). The macro `calculate_token_balance_changes` handles the complex logic of parsing blockchain data and attributing balance changes correctly
- **Key fields**: `timestamp` for when the change occurred, `account_address` for the treasury address, `token_address` identifying which token, `balance` representing the net change amount, and `token_symbol` for identification

### Component B: Cumulative balance calculation
- **Purpose**: Maintains running totals of each token held in the treasury over time
- **Logic**: Balance changes are aggregated using window functions that sum all changes for each token chronologically. The calculation partitions data by timestamp grain, chain, account address, and token address to ensure accurate cumulative tracking. This creates a time series showing the total balance of each token held at any given point in time
- **Key fields**: `balance` field becomes the cumulative total rather than individual changes, maintaining all other identifying fields for proper partitioning

### Component C: Data completeness and continuity
- **Purpose**: Ensures consistent daily data points for accurate treasury valuation
- **Logic**: The `fill_forward` macro addresses gaps in the data by carrying forward the last known balance for each token on days when no transactions occurred. This prevents the treasury value from appearing to drop to zero simply because no transactions happened on a given day. The forward-filling is applied across timestamp grain, chain, account address, and token address dimensions
- **Key fields**: All existing fields are maintained while filling forward the `balance` values for missing dates

### Component D: USD conversion
- **Purpose**: Converts all token balances to USD for consistent valuation
- **Logic**: Each token balance is joined with end-of-day price feeds using timestamp, chain, and token address as matching keys. The system uses `safe_multiply` to calculate USD values, which handles potential null values gracefully. Only tokens with positive balances and available price data are included in the conversion. The price feeds use daily grain to ensure consistent end-of-day valuations
- **Key fields**: `amount` field contains the USD-converted value, calculated as token balance multiplied by USD price

### Final aggregation
- **Combining components**: All USD-converted token balances are summed together to produce a single treasury value for each day
- **Currency conversion**: USD conversion occurs before aggregation using end-of-day prices to ensure consistent valuation timing
- **Time aggregation**: The metric uses daily boundaries with forward-filling to maintain continuity across all calendar dates
- **Final calculation**: The treasury value equals the sum of all positive token balances multiplied by their respective end-of-day USD prices, with the `finalize_metric_treasury` macro applying a fill-zeros strategy to handle any remaining data gaps and ensure proper metric formatting

*This methodology was automatically generated by Token Terminal's methodology analyzer.*

Total value of a project's onchain treasury, including its native token.

IlluviumILV

Treasury

Treasury

Competitive landscape