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 (net) Methodology

## 1. Overview

The Illuvium treasury net metric measures the total USD value of tokens held in Illuvium's treasury address on Ethereum. This metric tracks the protocol's financial reserves by monitoring all token holdings in the designated treasury wallet, excluding specific tokens that may not represent true treasury assets. The calculation provides daily snapshots of treasury value, enabling analysis of the protocol's financial health and asset management over time.

## 2. Data sources

- **Ethereum token transfer events**: Parsed `Transfer` events from Ethereum that track token movements to and from the treasury address
- **End-of-day price feeds**: Daily token price data in USD for converting token balances to dollar values
- **Token metadata**: Token symbol and contract address information for identification and classification
- **Chain availability configuration**: Data quality filters ensuring consistent coverage across supported blockchain networks

## 3. Step-by-step calculation

### Component A: Treasury balance tracking
- **Purpose**: Tracks daily balance changes for all tokens held in Illuvium's treasury address
- **Logic**: Processes Ethereum `Transfer` events to identify token inflows and outflows for the specific treasury address `0x58c37a622cdf8ace54d8b25c58223f61d0d738aa`. Calculates net balance changes per token per day by summing all transfers where the treasury address is either the sender or recipient. The calculation excludes the token at address `0x767fe9edc9e0df98e07454847909b5e959d7ca0e` from treasury calculations
- **Key fields**: `timestamp` for daily aggregation, `account_address` for treasury identification, `token_address` for token classification, `balance` representing net daily change

### Component B: Cumulative balance calculation
- **Purpose**: Converts daily balance changes into running cumulative balances for each token
- **Logic**: Applies cumulative sum calculations partitioned by token address and treasury address, ordered chronologically. This transforms daily change values into total token holdings at each point in time
- **Key fields**: `balance` field transformed from daily changes to cumulative totals using window function summation

### Component C: Data continuity management
- **Purpose**: Ensures complete time series data by filling gaps where no transactions occurred
- **Logic**: Uses forward-filling logic to propagate the last known balance forward for periods with no trading activity. This ensures daily data points exist even when no token transfers occurred on specific days
- **Key fields**: All dimensional fields maintained while `balance` values are carried forward through time gaps

### Component D: USD conversion
- **Purpose**: Converts token balances from native units to USD values for aggregation
- **Logic**: Joins token balance data with end-of-day price feeds using timestamp, chain identifier, and token address. Multiplies token balance by corresponding USD price using safe multiplication to handle edge cases. Filters for positive balances only and uses daily price granularity for consistency
- **Key fields**: `amount` field created by multiplying `balance` and `price_usd` from the price feeds

### Final aggregation
- **Combining components**: Token-level USD values are summed to create the total treasury value, representing the aggregate USD value across all qualifying token holdings
- **Currency conversion**: Uses end-of-day price feeds for consistent daily snapshots, with safe multiplication handling potential null or invalid price data
- **Time aggregation**: Daily boundary logic ensures consistent time series with forward-filling maintaining continuity during inactive periods
- **Final calculation**: The treasury net value equals the sum of all positive token balance USD values for the treasury address, excluding the specified token, with zero-filling applied for periods with no holdings and chain availability filters ensuring data quality

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

Total value of a project's treasury excluding its native token.

IlluviumILV

Treasury (net)

Treasury (net)

Competitive landscape