Token - Holder Profile

Retrieve holder profile summary for a specified token, including token market data, holder summary, and breakdown by holder tags (bundler, sniper, insider, dev, smart_trader, kol, whales). Supported chains: Solana and Robinhood. On Robinhood, only the bundler, sniper, smart_trader and kol tags are computed and returned, and token amounts are always raw (no scaled UI).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Cohort-level holder summary for labeled wallets.

  • Supported holder tags are bundler, sniper, insider, dev, and smart_trader.
  • holder_summary aggregates all labeled holders returned by the profile.
  • tags breaks the token down by holder label, with holder count, held amount, supply share, buy/sell volume, average buy price, and PnL.
  • top10_holder summarizes the token's top 10 holders separately from labeled cohorts.
  • include_zero_balance=true includes wallets that traded the token but no longer hold it.
Compute Unit ⚙️
  • This endpoint consumes 25 CU per request.
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 n blocks of the token, counted from the token's first swap. On Solana, n = 5; a buy qualifies when its slot is within first_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 💡
  • Compress token-holder intelligence into one executive snapshot: market context, top-holder concentration, labeled-holder exposure, and cohort-level PnL.
  • Score token quality by comparing how much supply is controlled by bundlers, snipers, insiders, developers, and smart traders.
  • Build risk panels that highlight whether suspicious cohorts dominate supply or whether higher-quality smart-money wallets are participating.
  • Track cohort conviction through hold amount, percent of supply, buy/sell volume, average buy price, and unrealized PnL.
  • Use as the top-level overview before drilling into Holder Positions for the exact wallets behind each label.
How to Use 🛠️
  • Provide a Solana token_address.
  • Use interval=1h for the volume fields returned in the profile.
  • Set ui_amount_mode=raw for raw token amounts or ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when the token supports scaled UI amount extension.
  • Set include_zero_balance=false when you only want wallets that still hold the token.
  • Read token, holder_summary, and tags together to connect market context with cohort behavior.
Best Practices ✅
  • Use holder-profile as the first stop for token-holder risk review, then drill into holder-positions for wallet-level evidence.
  • Compare percent_of_supply across labels before trusting volume alone; small active cohorts can still control meaningful supply.
  • Watch for a high share of bundler, sniper, insider, or dev holdings when evaluating launch quality.
  • Treat smart-trader participation as one signal among several; validate it against liquidity, price action, and current holdings.
Limitations ⚠️
  • Solana only.
  • interval currently supports 1h.
  • Holder labels depend on available indexing and classification coverage.
  • Cohort summaries are not wallet-level evidence; use holder-positions when you need exact wallets.

Query Params
string
required

Token address: the mint address on Solana, the EVM contract address on Robinhood

string
enum
Defaults to 1h

Time interval for volume data. Default: 1h

Allowed:
string
enum
Defaults to raw

Display mode for token amounts. scaled applies only to Solana scaled UI tokens; Robinhood amounts are always raw. Default: raw

Allowed:
boolean
Defaults to true

Include wallets that have traded the token but no longer hold it (zero balance). Default: true

Headers
string
enum
Defaults to solana

Solana or Robinhood. On Robinhood, token_address is an EVM contract address and only the bundler, sniper, smart_trader and kol tags are computed.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json