Retrieve a paginated list of wallet positions for a specified token, filtered by holder tags. Returns per-wallet trading data including PnL, volumes, and associated labels.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Wallet-level positions behind holder labels.
- Use
labelsto filter wallets bybundler,sniper,insider,dev, andsmart_trader. - If
labelsis omitted, the default label isbundler. - Each row includes wallet address, held amount, supply share, buy/sell volume, average buy price, PnL, trade counts, first trade time, and labels.
include_zero_balance=trueincludes wallets that traded the token but no longer hold it.sort_by=amountranks wallets by held amount;order_typecontrols ascending or descending order.
- Standard
- 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 💡
- Move from cohort summary to wallet-level evidence: inspect exactly which labeled wallets hold supply, how they traded, and where their PnL stands.
- Build investigative tables for bundlers, snipers, insiders, developers, and smart traders behind a token.
- Rank tagged wallets by holding size to find the highest-impact actors still exposed to the token.
- Combine buy/sell volume, average buy price, first trade time, and PnL to separate conviction from extraction.
- Power moderation, listing review, and risk workflows that need wallet-level proof behind holder-profile signals.
How to Use 🛠️
- Provide a Solana
token_address. - Use
labels=bundler,sniper,insider,dev,smart_traderto choose the wallet cohorts you want to inspect. - Set
sort_by=amount&order_type=descto see the largest labeled holders first. - Use
offsetandlimitto page through the result set. - Set
ui_amount_mode=rawfor raw token amounts orui_amount_mode=scaledfor Solana Token-2022 scaled UI amounts when the token supports scaled UI amount extension.
Best Practices ✅
- Start from holder-profile to identify suspicious or important cohorts, then use holder-positions to inspect the exact wallets.
- Sort by amount descending when reviewing supply risk, then inspect PnL and buy/sell volume to understand behavior.
- Include zero-balance wallets when investigating extraction, exits, or early washout behavior.
- Combine first trade time with current holdings to distinguish early conviction from late accumulation.
Limitations ⚠️
- Solana only.
sort_bycurrently supportsamount.- Supported
order_typevalues areascanddesc. - Results are paginated with offset up to 10,000 and limit up to 50.
- Holder labels depend on available indexing and classification coverage.