Added

2026.06.22 - Release Tag Holdings Chart API and Support position_scope Param for Detail Pnl API

New updates for token holder analytics and wallet PnL breakdown APIs, including a new Solana holder tag chart endpoint and an additional position_scope parameter for wallet PnL details.

Features

Token - Tag Holdings Chart

GET /token/v1/chart/tag-holdings

  • Retrieve timestamped holder and holding data grouped by wallet tag type on Solana
  • Support filtering by one or many tag categories through tag_type
  • Support chart granularity and time-range queries
  • Return up to 100 chart points for each tag

Parameters

ParameterTypeRequiredDefaultDescription
x-chainstringNosolanaChain header. Only Solana is supported.
token_addressstringYes-Token mint address.
chart_typestringNo1dChart interval for the tag holdings series.
tag_typestring or string[]Noall supported tagsFilter by one or many holder tag types.
time_fromintegerNo-Start time as Unix timestamp in seconds.
time_tointegerNocurrent timeEnd time as Unix timestamp in seconds.

Wallet - PnL Details

POST /wallet/v2/pnl/details

  • Add position_scope to the request body for wallet PnL details
  • Support duration_only and cumulative calculation modes
  • Default position_scope to duration_only

Parameters

ParameterTypeRequiredDefaultDescription
position_scopestringNoduration_onlyPnL calculation mode. duration_only calculates PnL only for the selected duration. cumulative calculates realized PnL cumulatively from the start time, while unrealized PnL is based on the all-time open position.