website

twitter

github

Stablecoin issuers

Fathom

# Fathom Trade count Methodology

## 1. Overview

The Fathom DEX trade count metric measures the daily number of unique trades executed on the Fathom decentralized exchange protocol. This metric counts distinct transactions containing swap events on Fathom DEX v2 deployed on the XDC blockchain. It provides insight into trading activity and user engagement with the protocol by tracking how many separate trading transactions occur each day.

## 2. Data sources

The calculation uses several raw data sources from the XDC blockchain and external systems:

- **Swap event logs**: XDC blockchain `Pair_Swap_event` logs from Fathom DEX v2 trading pair contracts, containing swap transaction details including token amounts in and out
- **Factory events**: XDC blockchain `Factory_PairCreated_event` logs from the Fathom DEX factory contract, recording when new trading pairs are created
- **Transaction records**: XDC blockchain transaction data providing user addresses and transaction metadata
- **Token metadata**: External token registry data including token decimals, symbols, and contract addresses used for normalization and display

## 3. Step-by-step calculation

### Component A: Trading pair dimension creation
- **Purpose**: Creates a reference table of all valid Fathom DEX trading pairs with metadata
- **Logic**: Processes `Factory_PairCreated_event` logs to extract all trading pairs created on Fathom DEX v2. For each pair creation event, extracts the `token0` and `token1` addresses along with the trading pair contract address. Joins with token metadata to retrieve decimal places and symbols for both tokens. Applies a fixed fee tier of 0.3% (3000 basis points divided by 1,000,000) to all pairs. Creates human-readable pair names by concatenating token symbols with a hyphen separator.
- **Key fields**: `account_address` (trading pair contract), `token0_address`, `token1_address`, `token0_decimals`, `token1_decimals`, `account_name` (token symbol pair), `fee_tier`

### Component B: Raw trade extraction
- **Purpose**: Extracts individual swap events from Fathom DEX trading pairs
- **Logic**: Processes `Pair_Swap_event` logs from all Fathom DEX v2 trading pair contracts on XDC blockchain. For each swap event, calculates the net change in token amounts by subtracting output amounts from input amounts using the formula: token0_amount = amount0In - amount0Out and token1_amount = amount1In - amount1Out. Joins with XDC transaction records to retrieve user addresses and transaction metadata. Enriches each trade with business classification metadata including market sector as 'exchanges', business segment as 'dex', and product identifier as 'Fathom DEX'.
- **Key fields**: `transaction_hash`, `log_index`, `account_address`, `token0_amount`, `token1_amount`, `user_address`, `block_timestamp`

### Component C: Trade data enrichment and normalization
- **Purpose**: Combines raw trades with trading pair metadata and normalizes token amounts
- **Logic**: Joins raw swap events with the trading pair dimension table using chain and trading pair contract address. Normalizes token amounts by dividing the absolute values by 10 raised to the power of each token's decimal places to convert from raw blockchain units to standard token units. Truncates block timestamps to daily boundaries to enable daily aggregation. Preserves transaction hash and log index for unique trade identification.
- **Key fields**: `timestamp` (daily), `transaction_hash`, `log_index`, `token0_address`, `token1_address`, `fee_tier`, normalized `token0_amount` and `token1_amount`

### Final aggregation
- **Combining components**: Uses the enriched trade data as the foundation for trade counting
- **Currency conversion**: No currency conversion is applied since this metric counts trades rather than measuring value
- **Time aggregation**: Groups trades by daily timestamp boundaries, with all trades occurring within the same calendar day counted together
- **Final calculation**: Counts the number of distinct transaction hashes within each day, chain, market sector, business segment, and product group. Each unique transaction hash represents one trade regardless of how many individual swap events it contains. Applies the finalize_metric_trade_count macro to standardize output format with proper metadata structure and implements a zero-filling strategy to ensure continuous daily data even when no trades occur.

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

Number of trades executed on a decentralized exchange.

Fathom

Trade count

Trade count

Competitive landscape