website

twitter

github

Stablecoin issuers

Fathom

# Fathom Trading volume Methodology

## 1. Overview

Fathom DEX trading volume measures the daily USD value of all token swaps executed on the Fathom decentralized exchange on XDC blockchain. This metric captures the total trading activity by summing the USD value of all completed trades, providing insight into the exchange's liquidity utilization and market activity. The calculation processes raw swap events from Fathom DEX smart contracts, applies decimal corrections, converts to USD values using end-of-day price feeds, and aggregates to daily totals.

## 2. Data sources

The calculation relies on several raw data sources from XDC blockchain and external systems:

- **Swap events**: Parsed `Pair_Swap_event` logs from Fathom DEX v2 smart contracts on XDC blockchain, containing token amounts and swap details
- **Trading pair creation events**: `Factory_PairCreated_event` logs from Fathom DEX Factory contracts that establish new trading pairs
- **Transaction records**: XDC blockchain transaction data providing user addresses and transaction metadata
- **Token metadata**: Token registry data including decimal precision and token symbols for proper amount calculation
- **Price feeds**: End-of-day USD price feeds for tokens traded on the exchange

## 3. Step-by-step calculation

### Component A: Trading pair identification
- **Purpose**: Identifies all valid trading pairs created through Fathom DEX Factory contracts
- **Logic**: Extracts `Factory_PairCreated_event` logs from Fathom DEX v2 contracts on XDC blockchain. Each event contains the newly created pair contract address and the two token addresses being paired. Sets a fixed fee tier of 0.3% (3000 basis points divided by 10^6) for all pairs, representing the trading fee users pay. Joins with token metadata to add decimal precision and symbols for both tokens in each pair, creating descriptive pair names in format "TOKEN0-TOKEN1"
- **Key fields**: `account_address` (pair contract), `token0_address`, `token1_address`, `fee_tier`, token decimals, and constructed `account_name`

### Component B: Raw trade processing
- **Purpose**: Extracts and processes individual swap transactions from trading pair contracts
- **Logic**: Processes `Pair_Swap_event` logs from all identified trading pair contracts. For each swap, calculates the net token movement by subtracting outgoing amounts from incoming amounts for both tokens (`amount0In - amount0Out` and `amount1In - amount1Out`). Joins with XDC transaction data to retrieve the actual user address initiating the swap. Filters for trades within the incremental processing window and adds standard business classification fields
- **Key fields**: `token0_amount`, `token1_amount` (net movements), `user_address`, `contract_user_address`, and transaction identifiers

### Component C: Decimal correction and daily aggregation
- **Purpose**: Corrects token amounts for decimal precision and aggregates to daily level
- **Logic**: Joins processed trades with trading pair metadata to access token decimal information. Applies decimal correction by dividing raw token amounts by 10 raised to the power of each token's decimal precision. Takes absolute values of corrected amounts to handle bidirectional swaps properly. Truncates timestamps to day level for daily aggregation while preserving transaction-level details for downstream processing
- **Key fields**: Decimal-corrected `token0_amount` and `token1_amount`, daily `timestamp`, and trading pair identifiers

### Component D: USD conversion
- **Purpose**: Converts token amounts to USD values using price feeds
- **Logic**: Joins corrected token amounts with end-of-day price feeds for both tokens in each trading pair. Implements a fallback pricing strategy where token0 price is used preferentially, but if unavailable, token1 price is used instead. Multiplies the appropriate token amount by its corresponding USD price. If neither token has price data available, the trade contributes zero to the volume calculation. Aggregates the resulting USD values by day, chain, product, version, and fee tier
- **Key fields**: `price_usd` from price feeds, calculated `trading_volume` in USD

### Final aggregation
- **Combining components**: The processed daily trading volumes are passed to the finalization macro which validates the data schema and ensures complete time series coverage
- **Currency conversion**: USD conversion uses end-of-day price feeds with fallback logic prioritizing token0 pricing over token1 pricing
- **Time aggregation**: Daily boundaries are established by truncating swap timestamps to day level, with all swaps within a day contributing to that day's volume
- **Final calculation**: Daily trading volume equals the sum of all USD-converted swap values for that day, using the formula: trading_volume = SUM(token_amount × token_price_usd) where token_amount is the decimal-corrected absolute value and pricing follows the fallback hierarchy

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

Total value of spot trades executed on the exchange.

Fathom

Trading volume

Trading volume

Competitive landscape