Liquidity providers deposit funds into SpookySwap and receive trading fees from traders (supply-side fees).

SpookySwap is a non-custodial exchange protocol built on Fantom. SpookySwap was launched in April 2021.

BOO tokenholders own and govern the protocol. They currently take a cut of the total interest paid by borrowers (revenue).

governance

github

twitter

discord

website

Exchanges (DEX)

SpookySwap

# SpookySwap Total value locked Methodology

## 1. Overview

SpookySwap TVL (Total Value Locked) measures the total USD value of all assets deposited in SpookySwap V1 liquidity pools on the Fantom network. The metric is calculated by tracking reserve changes in individual liquidity pools, converting daily net deposits to USD values, and treating cumulative net deposits as the total value locked. The value that liquidity providers have committed to the protocol's automated market maker (AMM) pools is captured through this approach.

## 2. Data sources

- **Blockchain events**: `PairCreated` events from `PairFactory` contracts and `Sync` events from `Pair` contracts on Fantom
- **External data**: End-of-day price feeds and asset metadata

## 3. Step-by-step calculation

### Component A: Trading pair identification

- **Purpose**: Establishes all valid SpookySwap V1 trading pairs on Fantom and their token composition
- **Logic**: Trading pair data is extracted from `PairCreated` events, capturing the pair contract address, both token addresses, and a fixed fee tier of 0.002 (0.2%). Each pair is enriched with asset metadata including decimal places and symbols. Display names are constructed by concatenating token symbols. Denylist filtering is applied to exclude specific low-liquidity pairs that lack reliable price feeds.
- **Key fields**: `account_address` (pair contract), `token0_address`, `token1_address`, `token0_decimals`, `token1_decimals`, `account_name` (display name)

### Component B: Reserve update tracking

- **Purpose**: Captures all changes to liquidity pool reserves from blockchain events
- **Logic**: `Sync` events emitted by SpookySwap pair contracts are processed whenever reserves change due to swaps, deposits, or withdrawals. Each event contains the current reserve amounts for both tokens in the pool. Events from denylisted trading pairs are filtered out to ensure data quality. Block timestamp, transaction hash, and log index are recorded for precise event ordering.
- **Key fields**: `block_timestamp`, `account_address`, `reserve0_amount`, `reserve1_amount` (raw asset amounts)

### Component C: Daily asset flow calculation

- **Purpose**: Converts reserve snapshots into daily net deposit amounts for each liquidity pool
- **Logic**: Reserve updates are joined with trading pair metadata to access decimal information. Raw amounts are normalized by decimal precision. For each day and pool, the last reserve state is identified using window functions ordered by block timestamp and log index. Daily asset flows are calculated by subtracting the previous day's final reserves from the current day's final reserves. For new pools, the full reserve amount is used as the initial deposit. Missing decimal metadata is handled by defaulting to zero amounts.
- **Key fields**: `timestamp` (daily), `token0_amount`, `token1_amount` (normalized daily changes)

### Component D: USD conversion and aggregation

- **Purpose**: Converts asset amounts to USD values and calculates total net deposits
- **Logic**: Daily asset flows are summed across all relevant dimensions. End-of-day price feeds for both assets in each pair are joined to provide USD conversion rates. Normalized asset amounts are multiplied by their respective USD prices. The USD values of both assets are summed to determine total net deposits per day. Missing price data is handled by defaulting to zero USD value for that asset.
- **Key fields**: `net_deposits` (total USD value of daily net deposits)

### Final aggregation

- **Combining components**: Daily net deposits are treated as equivalent to TVL, since net deposits represent the cumulative value that has been added to liquidity pools.
- **Currency conversion**: USD conversion is performed at the final step using end-of-day price feeds matched by timestamp, asset address, and chain. Missing prices default to a zero contribution.
- **Time aggregation**: Data is aggregated to daily boundaries using timestamp truncation. Each day captures the net change in total value locked.
- **Final calculation**: The `finalize_metric_tvl` macro is used to apply schema standardization, validate chain and product IDs, and implement gap-filling logic with zeros for days without activity. Chain availability filtering is applied to ensure only supported networks are included in the final results.

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

Total value locked (TVL)

Total value locked (TVL) — value deposited into the project's applications.

SpookySwapBOO

Total value locked

Total value locked

Competitive landscape

Chain breakdown