Skip to main content
GET
Token - Overview

Full market-intelligence snapshot for one token.

  • Returns identity, metadata links, market cap, FDV, supply, holder count, liquidity, price, last trade time, price changes, unique wallets, trade counts, buy/sell counts, and buy/sell volume across multiple frames.
  • Use frames to request specific timeframes. If omitted, the endpoint returns the default timeframe set.
  • ui_amount_mode=scaled applies Solana Token-2022 scaled UI amount when the token supports scaled UI amount extension.
  • On Solana only, pass includes=money_flow to include token money flow metrics for the requested frames. The field is omitted unless explicitly requested, and using this include adds 3 CU to the request cost.
  • On Solana, the overview also includes unique buyer and seller counts by interval, with matching history and change-percent fields when available.
  • Frames selection is only supported on solana, base, bsc, ethereum, robinhood
  • User can optionally select one or multiple timeframes using the frames parameter.
  • If frames are not specified, the API will return data for default timeframes: 1m 5m 30m 1h 2h 4h 8h 24h.
  • If frames include both supported and unsupported intervals, only supported intervals will be returned.
  • Custom supported timeframes are time intervals separated by comma (,). Users can pass up to 8 intervals. Rules:
  • Supported chains: solana, base, bsc, ethereum, robinhood
  • Hours intervals: only support 1h 2h 4h 8h 24h
  • Minute intervals: must be from 1m up to 1440m (e.g. 1m,15m,16m,17m,89m,90m,92m,1440m …).
  • Second intervals: must be multiples of 5s, from 5s up to 3600s (e.g. 5s,10s,15s,90s,3600s.

Reading the numbers. Price-change fields compare the current price with the historical price for that frame. uniqueWallet*, trade*, buy*, sell*, and v* fields describe activity inside each timeframe and its change versus the previous matching window.

  • This endpoint consumes 18 CU per request.
  • Turn a token address into a complete market-intelligence snapshot with identity, valuation, liquidity, holder, price-action, and trading-activity signals in one response.
  • Build rich token profile pages that blend fundamentals (marketCap, fdv, supply) with real-time market behavior.
  • Power alpha screens that compare price momentum, wallet growth, buy/sell pressure, trade count, and volume shifts across timeframes.
  • Feed bots, alerts, portfolio dashboards, and risk engines before deciding whether to trade, watch, rank, or filter a token.
  • Use includes=money_flow to add buy and sell flow context to token profiles, smart-money dashboards, and flow-based alerts without making a separate request.
  • Provide address as the token address and set x-chain for the target network.
  • Use frames=1m,5m,1h style requests when you only need specific activity windows.
  • Set ui_amount_mode=raw for raw decimal-adjusted amounts, or ui_amount_mode=scaled for Solana Token-2022 scaled UI amounts when supported.
  • Use this endpoint when you need the broadest token picture; use focused V3 stats endpoints when you only need metadata, market data, or trade data.
  • Use Token Overview as the top-level token profile payload, then drill into specialized endpoints when users open detailed panels.
  • Compare price change with volume, unique-wallet, and buy/sell activity together; price alone rarely explains market quality.
  • Cache metadata-like fields separately from fast-moving market fields when building high-refresh dashboards.
  • Keep timeframe selection consistent across watchlists so ranking and alerts compare tokens fairly.

Authorizations

​
X-API-KEY
string
header
required

API key for authentication

Headers

​
x-chain
enum<string>
default:solana

A chain name listed in supported networks.

Available options:
solana,
ethereum,
bsc,
base,
robinhood,
arc,
sui,
mantle,
hyperevm,
arbitrum,
avalanche,
optimism,
polygon,
zksync,
monad,
aptos,
fogo,
megaeth

Query Parameters

​
address
string
required

The address of the token contract.

​
frames
string

A list of custom time intervals separated by comma (,). Users can pass up to 8 intervals. Rules:

  • Minute intervals: from 1m up to 1440m (e.g. 1m,15m,16m,17m,89m,90m,92m,1440m ...).
  • Second intervals: must be multiples of 5s, from 5s up to 3600s (e.g. 5s,10s,15s,90s,3600s ...).
  • Hours intervals: only support (1h 2h 4h 8h 24h)
​
includes
enum<string>

Specify additional information to include in the response. money_flow is supported only on Solana. Use includes=money_flow to include money flow data.

Available options:
money_flow
​
ui_amount_mode
enum<string>
default:scaled

Indicate whether to use the scaled amount for scaled ui amount tokens. Only support solana

Available options:
raw,
scaled

Response

JSON object containing overview information of a token

​
success
boolean
required

Whether the request completed successfully.

​
data
object
required

Comprehensive token overview. Returned shape depends on whether the request is on a core chain or another supported chain.