website

twitter

github

Stablecoin issuers

Fathom

# Fathom Outstanding supply Methodology

## 1. Overview

Outstanding supply measures the total circulating supply of Fathom's Fathom Dollar stablecoin by tracking all mint and burn events over time. This metric represents the cumulative net issuance of Fathom Dollar tokens, calculated by summing all token mints and subtracting all burns from the protocol's inception. The calculation provides a daily time series of how many Fathom Dollar tokens are in circulation, converted to USD values using end-of-day price feeds.

## 2. Data sources

The calculation relies on the following raw data sources:

- **XDC blockchain events**: Parsed `Transfer` events from the XDC blockchain for the Fathom Dollar stablecoin token contract (`0x49d3f7543335cf38fa10889ccff10207e22110b5`)
- **Token transfer data**: XDC token transfer records containing transaction details, addresses, amounts, and timestamps
- **Token metadata**: Fathom Dollar token information including decimal precision and symbol for proper amount calculation
- **External price feeds**: End-of-day USD price data for the Fathom Dollar token to enable currency conversion
- **Chain availability data**: Information about XDC blockchain data availability periods for filtering

## 3. Step-by-step calculation

### Component A: Fathom Dollar token mints
- **Purpose**: Identifies all new Fathom Dollar token issuance events on the XDC blockchain
- **Logic**: Filters XDC token transfer events where the `from_address` is the null address (`0x0000000000000000000000000000000000000000`), indicating new token creation. Only includes non-removed transfer events for the Fathom Dollar token contract. Each mint event captures the `block_timestamp`, `transaction_hash`, `log_index`, recipient address, and raw token `value`
- **Key fields**: Extracts `block_timestamp`, `to_address`, `value` amounts, and adds classification fields including `business_line` as "Interest", `market_sector_id` as "stablecoin_issuers", `business_segment_id` as "stablecoin_issuer", and `product_id` as "Fathom Dollar"

### Component B: Fathom Dollar token burns
- **Purpose**: Identifies all Fathom Dollar token destruction events on the XDC blockchain
- **Logic**: Filters XDC token transfer events where the `to_address` is either the null address (`0x0000000000000000000000000000000000000000`) or dead address (`0x000000000000000000000000000000000000dead`), indicating token destruction. Only includes non-removed transfer events for the Fathom Dollar token contract. Each burn event captures the same transaction details as mints but represents token removal from circulation
- **Key fields**: Extracts `block_timestamp`, `from_address`, `value` amounts, and adds the same classification fields as mints for consistent categorization

### Component C: Daily supply changes
- **Purpose**: Combines mint and burn events to calculate net daily supply changes
- **Logic**: Unions mint and burn events into a single dataset, applying negative values to burn amounts to represent supply reduction. Truncates timestamps to daily boundaries and applies token decimal correction to convert raw values into proper token amounts. Groups events by day and sums the net mint/burn amounts to calculate daily supply changes
- **Key fields**: Produces daily `timestamp`, token classification fields, and corrected `amount` values representing net supply changes

### Component D: Cumulative supply calculation
- **Purpose**: Calculates the running total of outstanding Fathom Dollar tokens over time
- **Logic**: Applies a cumulative sum window function partitioned by chain and token address, ordered by timestamp. This creates a running total that starts from zero and increases with mints, decreases with burns, producing the total outstanding supply for each day
- **Key fields**: Generates `outstanding_supply` field containing the cumulative token amount in circulation

### Final aggregation
- **Combining components**: The intermediate model combines all processed mint and burn data into daily cumulative supply values
- **Gap filling**: Applies forward-fill logic to propagate the last known supply value to any missing dates, ensuring a continuous daily time series
- **Currency conversion**: Converts token amounts to USD using end-of-day price feeds and applies the `convert_to_usd_and_correct_decimals` macro
- **Final processing**: Applies the `finalize_metric_outstanding_supply` macro to validate schema, ensure proper time series formatting, and handle any remaining gaps with a "fill_zeros" strategy
- **Chain filtering**: Applies chain availability filters to ensure data is only included for periods when XDC blockchain data is reliably available
- **Final calculation**: The result is a daily time series showing the total USD value of Fathom Dollar tokens in circulation, representing Fathom's outstanding stablecoin supply

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

Circulating supply of stablecoins issued by the project.

Fathom

Outstanding supply

Outstanding supply

Competitive landscape