Track how tagged wallets trade a token over time. Returns buy/sell volume, distinct wallet counts, and transaction counts bucketed by interval, so you can see when developers took profit, whether snipers exited or held, and how smart money timed entries relative to price.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Three groupings under groups. They overlap each other — never sum one block into another.
tags— one series per tag. Overlapping: a dev+sniper wallet appears in both series, so summing these keys double-counts it.tag_combinations— one series per exact tag set (dev,dev_sniper,dev_sniper_smart_trader, …). Disjoint: every wallet lands in exactly one key, so these are the only keys safe to sum for a total. Needsinclude_tag_combinations=true.top_10_holder— a single series for the top 10 holders. An independent dimension that overlaps both tag blocks. Needstop_10_holder=true.
Reading the numbers. unix_time is the bucket open time. Volumes are gross and leg-based — a transaction that both buys and sells counts on both sides, with no netting. wallet_buy_count counts distinct wallets; tx_buy_count counts (wallet, transaction) pairs, so a bundle touching N wallets counts N times. Buckets with no activity are omitted from the series.
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Wallet Tag Definitions 🏷️
-
dev — The wallet that created the token: the mint creator from the initialize-mint transaction.
-
sniper — A wallet that bought within the first
nblocks of the token, counted from the token's first swap. On Solana,n = 5; a buy qualifies when its slot is withinfirst_trade_slot + 5. -
bundler — Coordinated buying detected in either level:
- Level 1: at least 4 buy transactions in the same slot.
- Level 2: at least 3 distinct wallets buying across adjacent slots, where max slot gap is 1.
-
insider — A wallet that received the token directly from the Chef wallet via token transfer, not via a swap.
-
smart_trader — A non-bot wallet ranked in Top Realized PnL over the last 90 days with realized PnL > $10,000. Wallets identified as bots are excluded before ranking and never receive this tag.
Use Cases 💡
- Follow the wallets that matter most — developers, snipers, smart traders, and the token's top holders — across every phase of a launch.
- Build a launch-forensics timeline that reveals when insiders accumulated, when snipers rotated out, and when smart money started leaning in.
- Separate signal from noise by comparing buy volume, sell volume, distinct wallet counts, and transaction intensity bucket by bucket.
- Power monitoring dashboards, alerts, and post-launch research reports that show whether tagged wallets are holding conviction, taking profit, or exiting into liquidity.
How to Use 🛠️
- Provide a
token_addressand a requiredfrom_timeunix timestamp in seconds. Omitto_timeto track activity up to now.- Pick
intervalby the question you're asking:1s–30sfor launch forensics,1m–30mfor intraday rotation,1h–1Mfor trend. - Use
tags=dev,sniper,smart_traderto narrow the cohorts returned, or omittagsto return all supported tag series. - Set
top_10_holder=trueto add the top-holder series, andinclude_tag_combinations=trueto add the disjoint cohorts. - While
has_moreis true, passnext_from_timeback asfrom_timeto page forward.
- Pick
Best Practices ✅
- Start with a coarse interval to understand the overall story, then zoom into minute or second buckets around the suspicious launch, pump, or exit.
- Score wallets from
tag_combinations, nottags— any model that sums thetagskeys will over-weight multi-tagged wallets. - Compare buy-side and sell-side wallet counts against USD volume to distinguish broad participation from a few large actors.
- Pair this endpoint with price, volume, first-buyers, and holder-profile data to explain not just what happened, but who drove it.
- Score wallets from
Limitations ⚠️
- Solana only. Supported tags are
dev,sniper, andsmart_trader.- Supported tags are
dev,sniper, andsmart_trader. - Maximum range per interval — seconds: 30 days, minutes: 60 days, hours: 90 days,
1D/1W/1M: 365 days. Exceeding it returns 400. - Some highly held or high-cost tokens (wSOL, USDC, USDT, BONK) are not supported for this endpoint.
- Supported tags are