Skip to main content
GET
Token - Tag Holdings Chart

Holder and holding trends grouped by wallet tag.

  • tag_type supports bundler and sniper. Omit it to return all supported tag series.
  • chart_type controls the time interval and supports 1d, 1h, and 1m.
  • time_from and time_to are unix timestamps in seconds. time_to defaults to now.
  • Each tag series contains timestamped points with total_holder, total_holding, and time.

Reading the numbers. total_holder is the number of wallets with the tag that hold the token at that point. total_holding is the token amount held by that tagged cohort.

  • This endpoint consumes 20 CU per request.
  • 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.
  • Turn holder labels into a living time series: watch bundler and sniper cohorts expand, shrink, accumulate, or distribute over time.
  • Build launch-quality charts that show whether suspicious early cohorts are still holding meaningful supply after trading begins.
  • Detect changing risk posture when tagged holder count falls while tagged holding remains high, or when holding drops sharply across a short window.
  • Pair tag holdings with price and volume charts to understand whether labeled wallets are supporting momentum or selling into demand.
  • Create narrative research panels that show how token ownership evolves from launch concentration toward broader or riskier distribution.
  • Provide a Solana token_address.
  • Choose chart_type=1m, 1h, or 1d based on the granularity you need.
  • Use tag_type=bundler, tag_type=sniper, or omit tag_type to return all supported tags.
  • Use time_from and time_to to focus on a launch window, volatility event, or post-launch period.
  • Plot total_holder and total_holding together to see both cohort size and token exposure.
  • Compare holder count and holding amount together; a small holder count with high holding can signal concentrated tagged exposure.
  • Align tag-holding changes with price and volume candles to see whether tagged cohorts accumulated before momentum or distributed into demand.
  • Use this endpoint for time-series cohort behavior, then use holder-positions when you need the exact wallets.
  • Keep the chart window focused; shorter windows make launch and exit patterns easier to interpret.
  • Solana only.
  • Supported tag_type values are bundler and sniper.
  • Supported chart_type values are 1d, 1h, and 1m.
  • Each tag returns up to 100 chart points.
  • This endpoint returns tagged cohort trends, not individual wallet-level positions.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-chain
enum<string>
default:solana

Solana network only.

Available options:
solana

Query Parameters

token_address
string
required

Token contract address.

chart_type
enum<string>
default:1d

Chart interval: 1d, 1h, 1m.

Available options:
1d,
1h,
1m
tag_type
enum<string>[]

Comma-separated holder tag types. Omit to return all supported tag types.

Available options:
bundler,
sniper
Example:
time_from
integer

Start time using unix timestamp in seconds. Defaults to 3 months before the current time.

Required range: 1 <= x <= 10000000000
time_to
integer

End time using unix timestamp in seconds. Defaults to the current time.

Required range: 1 <= x <= 10000000000

Response

JSON object containing holder chart data grouped by tag type

success
boolean
required

Whether the request succeeded.

data
object
required

Holder time series grouped by holder tag type. Each key is a tag type and maps to its time series. Supported tag types: bundler, sniper. Only the tag types requested via the tag_type parameter are returned.