Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
Free 30-min Web3 Consultation
Book Consultation
Smart Contract Security Audits
View Audit Services
Custom DeFi Protocol Development
Explore DeFi
Full-Stack Web3 dApp Development
View App Services
LABS
Guides

Launching a Meme Propagation Tracker Using Blockchain Data

A technical guide for developers to build a system that traces memecoin adoption through transaction graphs, identifying influencers and propagation pathways.
Chainscore © 2026
introduction
INTRODUCTION

Launching a Meme Propagation Tracker Using Blockchain Data

This guide explains how to build a system that tracks the spread of memecoins by analyzing on-chain transaction data.

A meme propagation tracker is an analytical tool that monitors the creation, trading, and distribution of memecoins across blockchain networks. Unlike traditional financial assets, memecoins often gain value through social virality, which is reflected in on-chain activity. By analyzing public blockchain data, you can identify key metrics like new holder growth, transaction velocity, and liquidity pool interactions. This data provides a real-time, transparent view of a token's lifecycle, from its initial mint to peak trading frenzies.

The core of this tracker is built on blockchain indexers and data providers. Services like The Graph for Ethereum L2s, Dune Analytics for custom queries, or direct RPC calls to nodes allow you to extract raw transaction logs. You'll filter for specific token contract addresses and decode event data such as Transfer, Swap, and LiquidityAdded. This process transforms raw blockchain bytes into structured datasets showing who is buying, selling, and providing liquidity, forming the basis for propagation analysis.

To measure propagation, you need to define and calculate specific on-chain metrics. Key indicators include the daily count of unique new token holders, the ratio of buys to sells, the concentration of holdings among top wallets (using the Gini coefficient or Nakamoto coefficient), and the volume of trades on decentralized exchanges like Uniswap or Pump.fun. Tracking these metrics over time reveals if a token is experiencing organic growth, a coordinated pump, or rapid abandonment by early holders.

Implementing the tracker requires a backend service to periodically fetch and process this data. A simple architecture involves a script using web3 libraries (like ethers.js or viem) to query an RPC provider, parse the events, and store the results in a database. For scalability, you can use The Graph's subgraphs to index historical data or leverage specialized APIs from providers like Alchemy or Chainscore, which offer enriched memecoin analytics endpoints to reduce development time.

Finally, visualizing the data is crucial for interpretation. Dashboards can chart holder growth over time, map transaction networks to identify influential wallets, and alert on suspicious patterns like rapid large-scale dumps. This tracker serves multiple audiences: traders seeking alpha, researchers studying crypto-sociology, and developers building on-chain reputation systems. By following this guide, you'll create a powerful tool to quantify the often chaotic and social-driven market of memecoins.

prerequisites
TECHNICAL FOUNDATIONS

Prerequisites

Before building a meme propagation tracker, you need a solid technical foundation in blockchain data access and analysis. This section outlines the core concepts and tools required.

To track meme coin propagation, you must first understand how to access and process on-chain data. This requires familiarity with blockchain explorers like Etherscan and indexing protocols such as The Graph. You'll be working with raw transaction data, which includes wallet addresses, token transfers, and contract interactions. A basic understanding of EVM-based chains (Ethereum, Arbitrum, Base) and Solana is essential, as these are primary hubs for meme activity. You should know how to read a transaction hash and identify key fields like from, to, value, and contractAddress.

Proficiency in a programming language is non-negotiable. Python is the industry standard for data analysis due to libraries like pandas, web3.py, and requests. For real-time tracking, you may also use JavaScript/TypeScript with ethers.js or viem. You will need to write scripts to fetch data from RPC nodes (via services like Alchemy, Infura, or QuickNode) and REST APIs (from explorers or indexing services). Setting up a local development environment with Node.js or Python and managing dependencies with npm or pip is a prerequisite step.

You must grasp the data models specific to meme coin propagation. This involves tracking token creation (ERC-20 or SPL mint events), liquidity pool deposits (especially on DEXs like Uniswap or Raydium), and social sentiment signals. You should understand how to calculate key metrics from this data, such as unique holder growth, concentration ratios (using the Herfindahl-Hirschman Index), and transaction velocity. Knowing how to filter for Transfer events and aggregate them by time intervals is a core analytical skill for this project.

Finally, you will need a strategy for data storage and processing. For small-scale analysis, a local SQLite database or CSV files may suffice. For tracking propagation across thousands of tokens in real-time, you'll need a more robust setup. This could involve a time-series database (like TimescaleDB), a data pipeline (using Apache Airflow or Dagster), and potentially a cloud data warehouse (BigQuery, Snowflake). Understanding how to structure your schema to efficiently query for holder addresses, transaction timelines, and token metadata is critical for performance.

system-architecture
SYSTEM ARCHITECTURE OVERVIEW

Launching a Meme Propagation Tracker Using Blockchain Data

This guide outlines the technical architecture for building a system that tracks the spread of meme coins and tokens across blockchains, using on-chain data to identify trends and propagation patterns.

A meme propagation tracker is a data analytics platform that monitors the creation, liquidity provisioning, and trading activity of meme tokens. The core data source is the blockchain itself. By indexing raw transaction data from networks like Ethereum, Solana, and Base, you can detect new token deployments (e.g., via CREATE2 or specific program IDs), track liquidity pool creations on DEXs like Uniswap V3 and Raydium, and analyze subsequent trading volume and holder growth. This on-chain footprint provides a real-time, immutable record of a meme's lifecycle.

The system architecture typically follows an ETL (Extract, Transform, Load) pipeline. First, a data extraction layer uses node RPCs or services like The Graph to stream raw blockchain logs and transactions. This data is then processed to identify key events: token contracts, large buy/sell swaps, and liquidity additions. For example, you would filter for Swap events on a DEX and correlate them with new token addresses that have seen a surge in unique interacting wallets over a short period, a common early signal for meme propagation.

Transforming this raw data involves aggregating and structuring it for analysis. You would calculate metrics such as holder count over time, concentration of top holders, buy/sell pressure ratios, and cross-chain bridge inflows (e.g., tracking a token's movement from Ethereum to Arbitrum via the Arbitrum Bridge). Storing this in a time-series database like TimescaleDB or a data warehouse enables efficient querying for trend analysis and the generation of propagation graphs showing how a token spreads across wallets and chains.

The final component is the application layer, which presents the insights. This could be a dashboard showing real-time alerts for new high-velocity tokens, charts of social sentiment correlated with on-chain buys (by fetching data from APIs like Birdeye or Helius), or network graphs visualizing the flow of funds. The architecture must be scalable to handle the high transaction throughput of chains like Solana and cost-effective, potentially using specialized RPC providers for reliable data access without running full nodes.

key-data-signals
MEME TRACKING

Key On-Chain Signals for Propagation

To build an effective meme tracker, you need to monitor specific on-chain data points that indicate genuine community growth and viral spread, not just price action.

01

Unique Holders & Concentration

Track the number of unique wallet addresses holding the token and the distribution of supply. A healthy, organic meme often shows a steady, linear increase in holders. Use the Gini Coefficient or Nakamoto Coefficient to measure decentralization. A low concentration (e.g., top 10 holders own <20% of supply) suggests a broad, community-driven asset, while a high concentration signals potential for a rug pull or pump-and-dump.

02

New vs. Existing Holder Inflows

Distinguish between first-time buyers and existing holders adding to their position. A surge in new, unique buyers is a stronger signal of viral propagation than existing wallets simply trading among themselves. Monitor metrics like:

  • First-time buyer ratio: New addresses / Total daily buyers.
  • Net new holders: New addresses minus addresses that sold out completely. Tools like Dune Analytics or Nansen allow you to segment holder cohorts by their first transaction date.
03

Exchange Netflow & CEX Listings

Analyze the movement of tokens between centralized exchanges (CEXs) and decentralized wallets. Negative netflow (more tokens moving from CEXs to self-custody) can indicate accumulation and long-term holding conviction. Conversely, positive netflow into exchanges may signal impending selling pressure. The announcement and execution of a listing on a major CEX like Binance or Coinbase is a critical propagation event, often leading to a massive spike in new user acquisition and liquidity.

04

Social Volume & On-Chain Activity Correlation

Correlate spikes in social media mentions (from platforms like Twitter, DexScreener, Birdeye) with on-chain activity. A genuine propagation event shows a lagged correlation: social buzz is followed by an increase in daily active addresses, transaction count, and gas spent on the relevant chain (e.g., Solana, Base). Tools like LunarCrush or DEX aggregator sentiment feeds can provide this social data. The key is to identify when online chatter translates into real, measurable on-chain action.

05

Liquidity Pool Health & DEX Volume

A meme's longevity depends on its trading infrastructure. Monitor:

  • Liquidity Pool Depth: Total value locked in primary DEX pools (e.g., on Uniswap, Raydium). Deep, stable liquidity reduces price slippage.
  • Concentration Risk: Check if liquidity is overly reliant on a single pool or if it's diversified.
  • DEX Volume vs. Market Cap Ratio: High daily volume relative to market cap (e.g., >50%) indicates strong trading interest and liquidity efficiency, which are essential for sustaining momentum.
06

Smart Contract Interactions & Airdrop Farming

Propagation isn't just about buying and holding. Monitor interactions with the token's smart contract beyond simple transfers. An increase in approve() transactions may signal new users preparing to provide liquidity or use the token in a dApp. Be aware of airdrop farming patterns, where users perform minimal, repetitive transactions to qualify for a potential future reward. While this inflates activity metrics, it doesn't always indicate genuine adoption. Differentiate this from organic interactions with staking contracts or meme-integrated games.

ingesting-transaction-data
DATA PIPELINE

Step 1: Ingesting and Filtering Transaction Data

The foundation of any meme tracker is a robust data pipeline. This step focuses on sourcing raw blockchain transaction data and applying filters to isolate the signal from the noise, specifically targeting token deployment and transfer activity.

To track a meme token's propagation, you must first capture its creation and subsequent movements on-chain. This requires connecting to a blockchain node's data stream. For Ethereum and EVM-compatible chains like Base or Arbitrum, you can use WebSocket connections to an RPC provider (e.g., Alchemy, QuickNode, or a self-hosted node) to subscribe to new block headers. Upon receiving a new block, your application fetches the full block data, which contains an array of transaction objects. Each transaction includes critical fields: from, to, input data, and value. For token tracking, the input data is especially important as it encodes function calls like transfer() or the details of a new token contract deployment.

Raw block data is overwhelming. A single Ethereum block can contain hundreds of transactions unrelated to your target. Effective filtering is therefore essential. The first filter targets contract creation. Look for transactions where the to address is null (or 0x0) and the input data starts with the contract creation bytecode preamble. This identifies new token deployments. You can further filter by checking if the deployed contract bytecode matches common token standards, like ERC-20's totalSupply() function selector, using tools like the 4byte directory. This isolates newly launched tokens, which are prime candidates for meme propagation analysis.

The second filter focuses on token transfer events. Instead of parsing all transaction input data, it's more efficient to parse transaction logs for specific events. When a standard ERC-20 transfer occurs, the contract emits a log with a defined topic hash (0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef). Your ingestion service should decode these logs to extract the from, to, and value (token amount) arguments. To scale this process, you should implement a system that maintains a list of token contract addresses you are actively tracking (initially populated by your contract creation filter) and only processes logs from those addresses. This dramatically reduces computational load.

For practical implementation, here is a simplified Node.js example using the Ethers.js library to listen for new blocks and filter for contract creations:

javascript
import { ethers } from 'ethers';
const provider = new ethers.WebSocketProvider('YOUR_WS_RPC_URL');

provider.on('block', async (blockNumber) => {
  const block = await provider.getBlock(blockNumber, true); // Get full tx details
  
  if (block && block.transactions) {
    block.transactions.forEach(tx => {
      // Filter 1: Contract Creation
      if (!tx.to) {
        console.log(`New contract deployed by: ${tx.from}`);
        console.log(`Deployment tx hash: ${tx.hash}`);
        // Optional: Analyze init code for token signatures
      }
      // Filter 2 could be applied here for known token addresses
    });
  }
});

This code establishes a live listener, but for production, you would add error handling, queueing, and database persistence.

The output of this ingestion and filtering step is a structured stream of relevant on-chain events: new token contract addresses and all transfers for tracked tokens. This clean data feed is the essential input for the next stage: analyzing these events to map holder networks, calculate velocity, and identify propagation patterns. Without precise filtering here, downstream analysis becomes computationally expensive and noisy, undermining the entire tracking system's accuracy.

building-transaction-graph
DATA MODELING

Step 2: Building the Transaction Graph

Transform raw blockchain transaction data into a structured network graph to visualize and analyze meme token propagation.

A transaction graph is a network representation where nodes are wallet addresses and edges are token transfers between them. For meme token analysis, you build a directed graph where each edge points from the sender to the receiver, weighted by the transaction value or count. This model transforms a flat list of transactions into a map of economic relationships, revealing key patterns like central hubs, propagation pathways, and potential wash trading clusters that are invisible in raw data.

To construct this graph, you first query and filter transaction data. Using a provider like Alchemy or QuickNode, you fetch all Transfer events for the target ERC-20 token contract within a specific block range. The core data for each event includes: from (sender address), to (receiver address), value (amount transferred), and transactionHash. You must filter out transfers to/from the token's own contract (e.g., mint/burn) and centralized exchange deposit addresses to focus on peer-to-peer propagation.

With the filtered data, you build the graph using a library like NetworkX in Python. Each unique from and to address becomes a node. You then create a directed edge for each transfer. It's crucial to aggregate edges; if wallet A sends to wallet B multiple times, you should create a single edge with a weight representing the total volume or number of transactions. This prevents the graph from being skewed by repetitive micro-transactions and highlights significant relationships.

python
import networkx as nx
# Initialize a directed graph
G = nx.DiGraph()

# aggregated_transfers is a list of dicts: {'from': '0x...', 'to': '0x...', 'total_value': 1000}
for tx in aggregated_transfers:
    # Add nodes (NetworkX handles duplicates)
    G.add_node(tx['from'])
    G.add_node(tx['to'])
    # Add edge with weight
    G.add_edge(tx['from'], tx['to'], weight=tx['total_value'])

Analyzing the graph's structure reveals the meme's propagation mechanics. Calculate network centrality metrics to identify influential actors. Degree centrality shows wallets with the most connections (high-volume traders). Betweenness centrality finds wallets that act as bridges between different communities. PageRank algorithmically identifies the most "important" wallets, often highlighting the core promoters or early buyers who are central to the token's spread. Visualizing this with a tool like Gephi or PyVis can immediately show if the network is organic (decentralized, web-like) or artificial (centralized around a few nodes).

For deeper insight, implement community detection using algorithms like the Louvain method. This partitions the graph into clusters of wallets that transact more frequently with each other than with the rest of the network. In meme token analysis, these clusters often represent distinct social communities (e.g., different Telegram groups, influencer followings, or geographic regions). Tracking how these communities interact—whether they trade amongst themselves or bridge to others—provides a nuanced view of the meme's cross-community viral potential.

Finally, persist your graph for the next analytical steps. Export the node and edge lists to a structured format like CSV or Parquet, or use a graph database like Neo4j for complex, recurring queries. Store node attributes (address, centrality scores, cluster ID) and edge attributes (total volume, transaction count, first/last timestamp). This prepared dataset is the foundation for Step 3, where you will calculate specific propagation metrics like velocity, saturation, and holder concentration to gauge the meme's lifecycle stage.

KEY METRICS

Propagation Metrics and Their Calculation

Core on-chain and social metrics for quantifying meme token propagation, with formulas and data sources.

MetricCalculation FormulaData SourceInterpretation

Holder Growth Rate (HGR)

(New Holders Today - New Holders Yesterday) / New Holders Yesterday

Token Contract (e.g., Etherscan)

Daily percentage change in unique addresses holding the token.

Velocity (V)

Daily Transfer Count / Current Holder Count

Token Contract Transfers

Average number of transfers per holder per day, indicating churn.

Concentration Ratio (CR)

Top 10 Holder Balance / Total Supply

Token Holder Distribution

Percentage of supply held by the 10 largest wallets; high values suggest vulnerability.

Social Volume (SV)

Count of Unique Mentions on X/Twitter, Telegram, Discord

Social API (Dune, Bitquery)

Raw measure of discussion volume across platforms.

Sentiment Score (SS)

(Positive Mentions - Negative Mentions) / Total Mentions

NLP Analysis of Social Posts

Ranges from -1 (fully negative) to +1 (fully positive).

DEX Liquidity Depth

Total Value Locked in Primary DEX Pool (e.g., Uniswap V2)

DEX Subgraph / Contract

Available liquidity for trading; below $100k is often considered thin.

Price-Volume Correlation (PVC)

Correlation Coefficient of 1h Price & Volume over 24h

DEX Trades (The Graph)

Value near +1 suggests organic, volume-driven moves; near 0 suggests wash trading.

New Pair Creation Rate

New DEX Pairs Created (Last 24h) / Total Pairs

DEX Factory Contracts

Spike indicates rapid expansion to new exchanges or chains.

identifying-influencers-pathways
ANALYSIS

Step 3: Identifying Influencers and Propagation Pathways

With raw blockchain data collected, the next step is to analyze it to pinpoint key accounts and map how information spreads across the network.

The core of a meme propagation tracker is identifying influencer accounts and the transaction pathways they create. An influencer in this context is any wallet whose activity demonstrably triggers subsequent, related actions by other wallets. This is not about social media followers, but on-chain behavioral influence. You'll analyze your dataset to find accounts that are first movers (buying a new token within the first hour of its launch), high-volume traders executing large swaps that appear on DEX aggregators, or wallets that consistently send tokens to many new recipients, acting as distribution hubs.

To identify these actors, you need to implement specific heuristics on your processed data. For example, you can query for the earliest Swap events for a specific token contract on Uniswap V3 to find initial buyers. For propagation pathways, trace all subsequent Transfer events from those early adopter wallets. A simple but powerful metric is the branching factor: how many unique recipient addresses received the token from a single source wallet within a defined time window. Wallets with a high branching factor are likely propagators. This analysis can be done using graph databases like Neo4j or with Python libraries such as NetworkX, where nodes are wallets and edges are token transfers.

Propagation pathways reveal the network topology of a meme's spread. You might observe a star topology where one influencer seeds dozens of new wallets, a chain topology with linear retransmission, or a hybrid model. Mapping these helps you understand the velocity and depth of the meme's adoption. For instance, if you see a token move from a "whale" wallet to 50 mid-sized wallets, and then from each of those to another 10, you've identified a powerful two-hop propagation wave. Tools like the Chainscore API can accelerate this by providing pre-computed wallet labels and transaction graph data, saving you from building this infrastructure from scratch.

Beyond simple transfers, you should correlate this on-chain activity with off-chain signals. Did a large buy occur minutes after a specific tweet from a known influencer? By timestamping blockchain transactions and social media posts, you can establish potential causality. This requires collecting data from sources like the Twitter API or decentralized social graphs (e.g., Farcaster, Lens Protocol). The goal is to build a multi-faceted view: Wallet 0xABC (influencer) buys 50 ETH of $TOKEN, tweets a chart 5 minutes later, and within the next hour, 15 of their followers' wallets appear as new buyers on-chain, creating a measurable propagation pathway.

Finally, visualize your findings. Use the processed graph data to create network diagrams, highlighting central nodes (influencers) and the thickness of edges (transfer volume). Time-series charts showing the cumulative number of unique holding wallets over time, annotated with key influencer actions, tell a clear story of propagation phases. This step transforms raw blockchain data into an actionable intelligence dashboard, showing not just what happened, but how it spread and who was responsible for its amplification.

DEVELOPER FAQ

Frequently Asked Questions

Common technical questions and troubleshooting for building a meme propagation tracker using on-chain data and social analytics.

A robust tracker requires multiple data streams. The primary source is on-chain data from block explorers and RPC nodes to detect token creation, liquidity pool activity, and wallet interactions. This is combined with social sentiment data from platforms like Twitter/X and Telegram, using APIs to monitor mentions, engagement, and community growth. Finally, DEX aggregator data (e.g., from 1inch, 0x API) provides real-time pricing and volume metrics. The key is correlating on-chain deployment events (like a Uniswap V2 pool creation) with spikes in social discussion to identify genuine propagation versus noise.

conclusion-next-steps
BUILDING ONCHAIN

Conclusion and Next Steps

You have built a system to track meme propagation by analyzing blockchain data from social protocols like Farcaster and Lens. This guide covered the core concepts and implementation steps.

The completed tracker provides a foundational on-chain analytics tool. You can now monitor the lifecycle of a meme—its origin, key amplifiers, and cross-platform spread—by querying events from smart contracts. This data is more verifiable and resistant to manipulation than traditional social media APIs. To enhance your application, consider implementing real-time alerts using a service like The Graph's streaming capabilities or Ponder for indexed data, and adding sentiment analysis on the associated text payloads to gauge community reception.

For production deployment, several critical steps remain. First, implement robust error handling and rate limiting for RPC providers like Alchemy or Infura. Second, add data persistence using a time-series database (e.g., TimescaleDB) to enable historical trend analysis. Finally, consider monetization or utility by creating a Snapshot-style governance plugin where meme propagation metrics influence DAO voting power, or by selling curated data feeds to trading firms analyzing narrative-driven market movements.

To extend your tracker's capabilities, explore integrating additional data sources. Pull financial context by cross-referencing wallet addresses with DeFi Llama's yield farming data or Arkham's intelligence platform. Analyze on-chain affiliation by checking if amplifying wallets hold specific NFTs or governance tokens. You can also track off-chain mentions by using the Lens API to find mirrors of on-chain posts or by setting up a crawl for platforms like Warpcast.

The code and concepts here are a starting point. The field of on-chain social analytics is rapidly evolving with new protocols like CyberConnect and Paragraph. Stay updated by following the documentation of these networks, experimenting in their testnet environments, and engaging with developer communities on Discord or GitHub. Your next project could be a comparative analysis tool or a dashboard for tracking the most influential wallets across different social finance (SocialFi) ecosystems.

How to Build a Meme Propagation Tracker with Blockchain Data | ChainScore Guides