DexScreener Top Traders Actor

Extract top trader PNL data and token holder distribution from DexScreener across 70+ blockchains.

Key Features

• Top Traders Analysis: Get detailed PNL (Profit & Loss), realized/unrealized gains, and trading volume for leading wallets.
• Holder Distribution: Analyze token holder concentration and balance percentages.
• Multi-Chain: Supports over 70 blockchains including Solana, Ethereum, BSC, Base, Arbitrum, Polygon, and many Layer 1, Layer 2, and other ecosystems.
• Real-time Data: Fetches fresh data directly from DexScreener.

How to Use

Provide a DexScreener token pair URL and configure the optional parameters to specify the data type and timeframe.

Input

Configure the actor using the following input parameters.

Required:
* wallet_url (string): The full DexScreener URL for the target token pair.
* Example: https://dexscreener.com/solana/AW526gmdn3wvhxa4D5FngY1HH3zAyYBpCSJnkYdXyqpx

Optional:
* days (integer): Analysis timeframe. Default: 30. Options: 1, 3, 7, 30.
* mode (string): Data to extract. Default: top_traders. Options:
* top_traders: Retrieve top trader PNL data.
* holders: Retrieve holder distribution data.
* max (integer): Maximum results to return. Default: 50. Min: 10 (enforced as 20 for top_traders mode). Max: 100.

Example Input:

{
  "wallet_url": "https://dexscreener.com/solana/AW526gmdn3wvhxa4D5FngY1HH3zAyYBpCSJnkYdXyqpx",
  "days": 30,
  "mode": "top_traders"
}

Output

The output format depends on the selected mode.

For mode: "top_traders":
Returns an array of objects, each containing: rank, pair_address, blockchain, wallet (address & explorer URL), bought (amount, USD, tx count), sold (amount, USD, tx count), pnl, unrealized_pnl, and balance.

For mode: "holders":
Returns an array of objects, each containing: id (wallet address), balance, and percentage of total supply.

Supported Blockchains

Works with 70+ networks. Major supported chains include:
* Layer 1: Solana, Ethereum, BSC, Polygon, Avalanche, Fantom, Cronos.
* Layer 2 / Ethereum: Arbitrum, Optimism, Base, zkSync, Linea, Scroll, Blast.
* Other: TON, Aptos, Sui, Starknet, Injective, Osmosis, PulseChain, opBNB, ZetaChain.

Use Cases

• Tracking whale wallet movements and smart money patterns.
• Analyzing holder concentration for token research.
• Feeding data into trading bots, algorithms, or investment dashboards.
• Monitoring token distribution metrics over time.