Documentation Index Fetch the complete documentation index at: https://docs.allium.so/llms.txt
Use this file to discover all available pages before exploring further.
Table Overview
All tables are located in the crosschain.stablecoin schema
Table Purpose Row Grain Update Frequency filtered_transfers Organic transfers only One row per transfer Real-time wallet_classification Wallet profiling One row per wallet per day Daily transaction_classification Transaction type tagging One row per transaction Real-time payment_categorization Granular payment purpose One row per payment Real-time
1. filtered_transfers
Purpose: Organic stablecoin transfers with CEX/DeFi/Infrastructure addresses removed.
Use Case: Calculate adjusted payment volume, track organic adoption.
Schema
Column Name Data Type Description chainVARCHAR Blockchain network (ethereum, polygon, arbitrum, etc.) token_symbolVARCHAR Stablecoin token symbol (USDC, USDT, DAI, etc.) from_addressVARCHAR Sender address to_addressVARCHAR Recipient address usd_amountNUMBER Transfer amount in USD transaction_hashVARCHAR Transaction hash block_timestampTIMESTAMP Block timestamp block_numberNUMBER Block number unique_idVARCHAR Unique transfer identifier (hash + log_index)
Key Features
✅ Attribution filtered: CEX/DeFi/Infrastructure excluded
✅ Cross-chain: All supported chains aggregated
✅ Real-time updates: New transfers added as they occur
❌ No attribution labels exposed: Labels are internal only
Example Queries
Total Adjusted Volume by Chain (30d)
SELECT
chain,
SUM (usd_amount) AS adjusted_volume_30d
FROM crosschain . stablecoin .filtered_transfers
WHERE block_timestamp >= CURRENT_DATE - 30
GROUP BY 1
ORDER BY 2 DESC ;
Daily Payment Volume Trend
SELECT
DATE_TRUNC( 'day' , block_timestamp) AS day ,
COUNT ( * ) AS transfer_count,
SUM (usd_amount) AS daily_volume
FROM crosschain . stablecoin .filtered_transfers
WHERE block_timestamp >= CURRENT_DATE - 90
GROUP BY 1
ORDER BY 1 ;
Top Stablecoins by Organic Volume
SELECT
token_symbol,
COUNT ( * ) AS transfer_count,
SUM (usd_amount) AS total_volume
FROM crosschain . stablecoin .filtered_transfers
WHERE block_timestamp >= CURRENT_DATE - 30
GROUP BY 1
ORDER BY 3 DESC ;
2. wallet_classification
Purpose: Comprehensive wallet profiling with behavioral segments, engagement scores, and risk metrics.
Use Case: Customer segmentation, risk assessment, wallet analysis.
Schema
Column Name Data Type Description chainVARCHAR Blockchain network addressVARCHAR Wallet address snapshot_dateDATE Date of the classification snapshot balance_tierVARCHAR Balance tier (whale, large, medium, small, micro, dust) behavioral_segmentVARCHAR Activity segment (new, active, dormant, churned) combined_segmentVARCHAR Combined classification (e.g., “Whale Active”, “Small Dormant”) engagement_scoreNUMBER Overall engagement score (0-100) engagement_tierVARCHAR Engagement tier (highly_engaged, engaged, moderately_engaged, low_engagement, inactive) recency_scoreNUMBER Recency component (0-40 points) frequency_scoreNUMBER Frequency component (0-40 points) consistency_scoreNUMBER Consistency component (0-20 points) risk_scoreNUMBER Overall risk score (0-100) risk_flagVARCHAR Risk flag (high, medium, low) volatility_risk_scoreNUMBER Balance volatility risk (0-50 points) anomaly_risk_scoreNUMBER Balance anomaly risk (0-50 points) volume_30d_usdNUMBER 30-day transaction volume in USD current_balance_usdNUMBER Current wallet balance in USD days_since_last_activityNUMBER Days since most recent activity days_active_30dNUMBER Number of active days in past 30 days days_active_lifetimeNUMBER Total number of active days (lifetime) lifetime_span_daysNUMBER Days between first and last activity tokens_used_countNUMBER Number of unique stablecoin tokens used chains_used_countNUMBER Number of chains wallet has been active on
Balance Tiers
Tier Balance Range (USD) Description whale > $1M High-value accounts large 100 K − 100K - 100 K − 1MInstitutional/business accounts medium 10 K − 10K - 10 K − 100KActive users/small businesses small 1 K − 1K - 1 K − 10KRegular users micro 100 − 100 - 100 − 1KCasual users dust < $100 Minimal activity
Behavioral Segments
Segment Criteria Description new First activity < 30 days ago New wallet active Active in last 7 days Currently engaged dormant Active 7-30 days ago Recently inactive churned Active >30 days ago Long-term inactive
Engagement Scoring
Total: 100 points
Component Points Criteria Recency 0-40 Days since last activity Frequency 0-40 Number of active days (30d) Consistency 0-20 Activity pattern regularity
Engagement Tiers:
highly_engaged: 80-100
engaged: 60-79
moderately_engaged: 40-59
low_engagement: 20-39
inactive: 0-19
Risk Scoring
Total: 100 points
Component Points Criteria Volatility 0-50 Balance fluctuation rate Anomaly 0-50 Unusual balance patterns
Risk Flags:
high: 70-100
medium: 40-69
low: 0-39
Example Queries
Wallet Segmentation Distribution
SELECT
balance_tier,
behavioral_segment,
COUNT ( * ) AS wallet_count,
AVG (engagement_score) AS avg_engagement,
AVG (risk_score) AS avg_risk
FROM crosschain . stablecoin .wallet_classification
WHERE snapshot_date = CURRENT_DATE
GROUP BY 1 , 2
ORDER BY 3 DESC ;
High-Value Active Wallets
SELECT
chain,
address ,
balance_tier,
current_balance_usd,
engagement_score,
risk_flag
FROM crosschain . stablecoin .wallet_classification
WHERE snapshot_date = CURRENT_DATE
AND balance_tier IN ( 'whale' , 'large' )
AND behavioral_segment = 'active'
ORDER BY current_balance_usd DESC
LIMIT 100 ;
Risk Analysis
SELECT
risk_flag,
COUNT ( * ) AS wallet_count,
AVG (volume_30d_usd) AS avg_volume,
AVG (volatility_risk_score) AS avg_volatility,
AVG (anomaly_risk_score) AS avg_anomaly
FROM crosschain . stablecoin .wallet_classification
WHERE snapshot_date = CURRENT_DATE
GROUP BY 1 ;
3. transaction_classification
Purpose: Classify transactions by type (Real-World Payment, Investment/Trade, Store as Value) and wallet type combinations.
Use Case: Payment type analysis, wallet interaction patterns.
Schema
Column Name Data Type Description chainVARCHAR Blockchain network token_symbolVARCHAR Stablecoin token symbol activity_dateDATE Date of transaction block_timestampTIMESTAMP Block timestamp transaction_hashVARCHAR Transaction hash from_addressVARCHAR Sender address to_addressVARCHAR Recipient address usd_amountNUMBER Transfer amount in USD from_wallet_typeVARCHAR Sender wallet type (Consumer, Business, Institutional, Unclassified) to_wallet_typeVARCHAR Recipient wallet type from_balance_tierVARCHAR Sender balance tier to_balance_tierVARCHAR Recipient balance tier transaction_typeVARCHAR Transaction classification wallet_type_combinationVARCHAR Wallet type pair (C2C, C2B, B2C, B2B, etc.) from_30d_volumeNUMBER Sender’s 30-day volume in USD to_30d_volumeNUMBER Recipient’s 30-day volume in USD from_avg_txn_sizeNUMBER Sender’s avg transaction size (30d) to_avg_txn_sizeNUMBER Recipient’s avg transaction size (30d)
Transaction Types
Type Description Examples Real-World Payment P2P, retail, payroll, B2B payments Salary, purchase, invoice Investment/Trade Speculative, trading, yield-seeking Swap prep, arbitrage Store as Value Long-term holding, savings Accumulation, vault Unclassified Ambiguous or insufficient data -
Wallet Types
Type Description Identification Criteria Consumer Individual users Low volume, small balances, P2P patterns Business Merchants, service providers Medium-high volume, regular receipts Institutional Large entities, funds Very high volume, large balances Unclassified Insufficient data New wallets, low activity
Wallet Type Combinations
Combination Description Examples C2C Consumer to Consumer P2P payments, personal transfers C2B Consumer to Business Retail purchases, service payments B2C Business to Consumer Salaries, refunds, payouts B2B Business to Business Supplier payments, invoices I2C Institutional to Consumer Airdrops, grants I2B Institutional to Business Investments, funding I2I Institutional to Institutional Large settlements C2I Consumer to Institutional Investments B2I Business to Institutional - U2U Unclassified to Unclassified - U2X Unclassified to any - Other Mixed or edge cases -
Example Queries
Transaction Type Distribution
SELECT
transaction_type,
COUNT ( * ) AS tx_count,
SUM (usd_amount) AS total_volume
FROM crosschain . stablecoin .transaction_classification
WHERE activity_date >= CURRENT_DATE - 30
GROUP BY 1
ORDER BY 3 DESC ;
Wallet Combination Analysis
SELECT
wallet_type_combination,
COUNT ( * ) AS tx_count,
AVG (usd_amount) AS avg_amount,
SUM (usd_amount) AS total_volume
FROM crosschain . stablecoin .transaction_classification
WHERE activity_date >= CURRENT_DATE - 30
AND transaction_type = 'Real-World Payment'
GROUP BY 1
ORDER BY 4 DESC ;
C2B Payment Trends
SELECT
DATE_TRUNC( 'week' , activity_date) AS week ,
COUNT ( * ) AS payment_count,
SUM (usd_amount) AS weekly_volume
FROM crosschain . stablecoin .transaction_classification
WHERE wallet_type_combination = 'C2B'
AND transaction_type = 'Real-World Payment'
AND activity_date >= CURRENT_DATE - 90
GROUP BY 1
ORDER BY 1 ;
4. payment_categorization
Purpose: Granular payment purpose classification for real-world payments only.
Use Case: Payment category analytics, merchant insights, payroll tracking.
Schema
Includes all columns from transaction_classification plus:
Column Name Data Type Description core_payment_categoryVARCHAR High-level payment category payment_purposeVARCHAR Granular payment purpose
Core Payment Categories
Category Description C2C Payment Consumer-to-Consumer transfers C2B Payment Consumer-to-Business purchases/services B2C Payment Business-to-Consumer payouts/refunds B2B Payment Business-to-Business settlements I2C Payment Institutional-to-Consumer grants/airdrops I2B Payment Institutional-to-Business funding Institutional Payment Institutional-to-Institutional Other Mixed or unclassified
Payment Purposes
C2C (Consumer to Consumer)
Purpose Amount Range Description P2P Micro Payment < $100 Small personal transfers P2P Remittance 100 − 100 - 100 − 10KCross-border remittances P2P Large Transfer > $10K Large personal transfers
C2B (Consumer to Business)
Purpose Amount Range Description Retail Purchase < $500 Small retail transactions Service Payment 500 − 500 - 500 − 5KProfessional services Large Purchase > $5K High-value goods/services
B2C (Business to Consumer)
Purpose Amount Range Description Micro Payout < $100 Small rewards, cashback Gig/Creator Payout 100 − 100 - 100 − 2KFreelance, content creator Salary/Payroll 2 K − 2K - 2 K − 20KEmployee salaries Large Disbursement > $20K Bonuses, large payouts
B2B (Business to Business)
Purpose Amount Range Description Service Fee < $5K Subscription, small invoices Supplier Payment 5 K − 5K - 5 K − 50KVendor payments Large B2B Settlement > $50K Major contracts
Example Queries
Payment Purpose Breakdown
SELECT
core_payment_category,
payment_purpose,
COUNT ( * ) AS payment_count,
SUM (usd_amount) AS total_usd,
AVG (usd_amount) AS avg_payment_size
FROM crosschain . stablecoin .payment_categorization
WHERE activity_date >= CURRENT_DATE - 30
GROUP BY 1 , 2
ORDER BY 4 DESC ;
Payroll Volume Tracking
SELECT
DATE_TRUNC( 'month' , activity_date) AS month ,
COUNT ( * ) AS payroll_count,
SUM (usd_amount) AS total_payroll_usd
FROM crosschain . stablecoin .payment_categorization
WHERE payment_purpose = 'Salary/Payroll'
AND activity_date >= CURRENT_DATE - 180
GROUP BY 1
ORDER BY 1 ;
Retail vs Service Payments
SELECT
payment_purpose,
COUNT ( * ) AS payment_count,
SUM (usd_amount) AS volume
FROM crosschain . stablecoin .payment_categorization
WHERE payment_purpose IN ( 'Retail Purchase' , 'Service Payment' )
AND activity_date >= CURRENT_DATE - 30
GROUP BY 1 ;
Table Relationships
Common Joins
Filtered Transfers + Wallet Classification
SELECT
ft . transaction_hash ,
ft . usd_amount ,
wc_from . balance_tier AS from_balance_tier,
wc_from . engagement_score AS from_engagement,
wc_to . balance_tier AS to_balance_tier,
wc_to . engagement_score AS to_engagement
FROM crosschain . stablecoin .filtered_transfers ft
LEFT JOIN crosschain . stablecoin .wallet_classification wc_from
ON ft . from_address = wc_from . address
AND DATE ( ft . block_timestamp ) = wc_from . snapshot_date
LEFT JOIN crosschain . stablecoin .wallet_classification wc_to
ON ft . to_address = wc_to . address
AND DATE ( ft . block_timestamp ) = wc_to . snapshot_date
WHERE ft . block_timestamp >= CURRENT_DATE - 7 ;
Transaction Classification + Payment Categorization
SELECT
tc . transaction_type ,
pc . payment_purpose ,
COUNT ( * ) AS tx_count
FROM crosschain . stablecoin .transaction_classification tc
LEFT JOIN crosschain . stablecoin .payment_categorization pc
ON tc . transaction_hash = pc . transaction_hash
WHERE tc . activity_date >= CURRENT_DATE - 30
GROUP BY 1 , 2 ;
Next Steps
Adjusted Volume Methodology Learn how organic volume is calculated
Pipeline Overview Back to payments pipeline overview