For the complete documentation index, see llms.txt. Markdown versions of the documentation pages are available from that index.

Introducing Build with AI: Connect your agents to reliable onchain data with more than 50+ tools cover all tokens to wallets on Solana via MCP, CLI, and Skills. Learn How

solscan logo
Register NowRegister Now

token statistic

New
get

https://pro-api.solscan.io/v2.0/token/statistic

Get detailed trading statistics, holder concentration metrics, and market data for a specific token

QUERY PARAMS

address

string

required

Token address

RESPONSES

200

OK

Response Body (application/json)

success

boolean

Request status

token_address

string

Token Address

volume_1m

number

The trading volume in the last minute (in USD)

volume_1m_change_pct

number

The trading volume change percentage in the last minute

volume_5m

number

The trading volume in the last 5 minutes (in USD)

volume_5m_change_pct

number

The trading volume change percentage in the last 5 minutes

volume_30m

number

The trading volume in the last 30 minutes (in USD)

volume_30m_change_pct

number

The trading volume change percentage in the last 30 minutes

volume_1h

number

The trading volume in the last hour (in USD)

volume_1h_change_pct

number

The trading volume change percentage in the last hour

volume_4h

number

The trading volume in the last 4 hours (in USD)

volume_4h_change_pct

number

The trading volume change percentage in the last 4 hours

volume_8h

number

The trading volume in the last 8 hours (in USD)

volume_8h_change_pct

number

The trading volume change percentage in the last 8 hours

volume_24h

number

The trading volume in the last 24 hours (in USD)

volume_24h_change_pct

number

The trading volume change percentage in the last 24 hours

volume_7d

number

The trading volume in the last 7 days (in USD)

volume_7d_change_pct

number

The trading volume change percentage in the last 7 days

volume_30d

number

The trading volume in the last 30 days (in USD)

volume_30d_change_pct

number

The trading volume change percentage in the last 30 days

buy_volume_1m

number

The buy volume in the last minute (in USD)

buy_volume_1m_change_pct

number

The buy volume change percentage in the last minute

buy_volume_5m

number

The buy volume in the last 5 minutes (in USD)

buy_volume_5m_change_pct

number

The buy volume change percentage in the last 5 minutes

buy_volume_30m

number

The buy volume in the last 30 minutes (in USD)

buy_volume_30m_change_pct

number

The buy volume change percentage in the last 30 minutes

buy_volume_1h

number

The buy volume in the last hour (in USD)

buy_volume_1h_change_pct

number

The buy volume change percentage in the last hour

buy_volume_4h

number

The buy volume in the last 4 hours (in USD)

buy_volume_4h_change_pct

number

The buy volume change percentage in the last 4 hours

buy_volume_8h

number

The buy volume in the last 8 hours (in USD)

buy_volume_8h_change_pct

number

The buy volume change percentage in the last 8 hours

buy_volume_24h

number

The buy volume in the last 24 hours (in USD)

buy_volume_24h_change_pct

number

The buy volume change percentage in the last 24 hours

buy_volume_7d

number

The buy volume in the last 7 days (in USD)

buy_volume_7d_change_pct

number

The buy volume change percentage in the last 7 days

buy_volume_30d

number

The buy volume in the last 30 days (in USD)

buy_volume_30d_change_pct

number

The buy volume change percentage in the last 30 days

sell_volume_1m

number

The sell volume in the last minute (in USD)

sell_volume_1m_change_pct

number

The sell volume change percentage in the last minute

sell_volume_5m

number

The sell volume in the last 5 minutes (in USD)

sell_volume_5m_change_pct

number

The sell volume change percentage in the last 5 minutes

sell_volume_30m

number

The sell volume in the last 30 minutes (in USD)

sell_volume_30m_change_pct

number

The sell volume change percentage in the last 30 minutes

sell_volume_1h

number

The sell volume in the last hour (in USD)

sell_volume_1h_change_pct

number

The sell volume change percentage in the last hour

sell_volume_4h

number

The sell volume in the last 4 hours (in USD)

sell_volume_4h_change_pct

number

The sell volume change percentage in the last 4 hours

sell_volume_8h

number

The sell volume in the last 8 hours (in USD)

sell_volume_8h_change_pct

number

The sell volume change percentage in the last 8 hours

sell_volume_24h

number

The sell volume in the last 24 hours (in USD)

sell_volume_24h_change_pct

number

The sell volume change percentage in the last 24 hours

sell_volume_7d

number

The sell volume in the last 7 days (in USD)

sell_volume_7d_change_pct

number

The sell volume change percentage in the last 7 days

sell_volume_30d

number

The sell volume in the last 30 days (in USD)

sell_volume_30d_change_pct

number

The sell volume change percentage in the last 30 days

num_trade_1m

number

The number of trades in the last minute

num_trade_1m_change_pct

number

The number of trades change percentage in the last minute

num_trade_5m

number

The number of trades in the last 5 minutes

num_trade_5m_change_pct

number

The number of trades change percentage in the last 5 minutes

num_trade_30m

number

The number of trades in the last 30 minutes

num_trade_30m_change_pct

number

The number of trades change percentage in the last 30 minutes

num_trade_1h

number

The number of trades in the last hour

num_trade_1h_change_pct

number

The number of trades change percentage in the last hour

num_trade_4h

number

The number of trades in the last 4 hours

num_trade_4h_change_pct

number

The number of trades change percentage in the last 4 hours

num_trade_8h

number

The number of trades in the last 8 hours

num_trade_8h_change_pct

number

The number of trades change percentage in the last 8 hours

num_trade_24h

number

The number of trades in the last 24 hours

num_trade_24h_change_pct

number

The number of trades change percentage in the last 24 hours

num_trade_7d

number

The number of trades in the last 7 days

num_trade_7d_change_pct

number

The number of trades change percentage in the last 7 days

num_trade_30d

number

The number of trades in the last 30 days

num_trade_30d_change_pct

number

The number of trades change percentage in the last 30 days

num_buy_trade_1m

number

The number of buy trades in the last minute

num_buy_trade_1m_change_pct

number

The number of buy trades change percentage in the last minute

num_buy_trade_5m

number

The number of buy trades in the last 5 minutes

num_buy_trade_5m_change_pct

number

The number of buy trades change percentage in the last 5 minutes

num_buy_trade_30m

number

The number of buy trades in the last 30 minutes

num_buy_trade_30m_change_pct

number

The number of buy trades change percentage in the last 30 minutes

num_buy_trade_1h

number

The number of buy trades in the last hour

num_buy_trade_1h_change_pct

number

The number of buy trades change percentage in the last hour

num_buy_trade_4h

number

The number of buy trades in the last 4 hours

num_buy_trade_4h_change_pct

number

The number of buy trades change percentage in the last 4 hours

num_buy_trade_8h

number

The number of buy trades in the last 8 hours

num_buy_trade_8h_change_pct

number

The number of buy trades change percentage in the last 8 hours

num_buy_trade_24h

number

The number of buy trades in the last 24 hours

num_buy_trade_24h_change_pct

number

The number of buy trades change percentage in the last 24 hours

num_buy_trade_7d

number

The number of buy trades in the last 7 days

num_buy_trade_7d_change_pct

number

The number of buy trades change percentage in the last 7 days

num_buy_trade_30d

number

The number of buy trades in the last 30 days

num_buy_trade_30d_change_pct

number

The number of buy trades change percentage in the last 30 days

num_sell_trade_1m

number

The number of sell trades in the last minute

num_sell_trade_1m_change_pct

number

The number of sell trades change percentage in the last minute

num_sell_trade_5m

number

The number of sell trades in the last 5 minutes

num_sell_trade_5m_change_pct

number

The number of sell trades change percentage in the last 5 minutes

num_sell_trade_30m

number

The number of sell trades in the last 30 minutes

num_sell_trade_30m_change_pct

number

The number of sell trades change percentage in the last 30 minutes

num_sell_trade_1h

number

The number of sell trades in the last hour

num_sell_trade_1h_change_pct

number

The number of sell trades change percentage in the last hour

num_sell_trade_4h

number

The number of sell trades in the last 4 hours

num_sell_trade_4h_change_pct

number

The number of sell trades change percentage in the last 4 hours

num_sell_trade_8h

number

The number of sell trades in the last 8 hours

num_sell_trade_8h_change_pct

number

The number of sell trades change percentage in the last 8 hours

num_sell_trade_24h

number

The number of sell trades in the last 24 hours

num_sell_trade_24h_change_pct

number

The number of sell trades change percentage in the last 24 hours

num_sell_trade_7d

number

The number of sell trades in the last 7 days

num_sell_trade_7d_change_pct

number

The number of sell trades change percentage in the last 7 days

num_sell_trade_30d

number

The number of sell trades in the last 30 days

num_sell_trade_30d_change_pct

number

The number of sell trades change percentage in the last 30 days

num_trader_1m

number

The number of traders in the last minute

num_trader_1m_change_pct

number

The number of traders change percentage in the last minute

num_trader_5m

number

The number of traders in the last 5 minutes

num_trader_5m_change_pct

number

The number of traders change percentage in the last 5 minutes

num_trader_30m

number

The number of traders in the last 30 minutes

num_trader_30m_change_pct

number

The number of traders change percentage in the last 30 minutes

num_trader_1h

number

The number of traders in the last hour

num_trader_1h_change_pct

number

The number of traders change percentage in the last hour

num_trader_4h

number

The number of traders in the last 4 hours

num_trader_4h_change_pct

number

The number of traders change percentage in the last 4 hours

num_trader_8h

number

The number of traders in the last 8 hours

num_trader_8h_change_pct

number

The number of traders change percentage in the last 8 hours

num_trader_24h

number

The number of traders in the last 24 hours

num_trader_24h_change_pct

number

The number of traders change percentage in the last 24 hours

num_trader_7d

number

The number of traders in the last 7 days

num_trader_7d_change_pct

number

The number of traders change percentage in the last 7 days

num_trader_30d

number

The number of traders in the last 30 days

num_trader_30d_change_pct

number

The number of traders change percentage in the last 30 days

num_buyer_1m

number

The number of buyers in the last minute

num_buyer_1m_change_pct

number

The number of buyers change percentage in the last minute

num_buyer_5m

number

The number of buyers in the last 5 minutes

num_buyer_5m_change_pct

number

The number of buyers change percentage in the last 5 minutes

num_buyer_30m

number

The number of buyers in the last 30 minutes

num_buyer_30m_change_pct

number

The number of buyers change percentage in the last 30 minutes

num_buyer_1h

number

The number of buyers in the last hour

num_buyer_1h_change_pct

number

The number of buyers change percentage in the last hour

num_buyer_4h

number

The number of buyers in the last 4 hours

num_buyer_4h_change_pct

number

The number of buyers change percentage in the last 4 hours

num_buyer_8h

number

The number of buyers in the last 8 hours

num_buyer_8h_change_pct

number

The number of buyers change percentage in the last 8 hours

num_buyer_24h

number

The number of buyers in the last 24 hours

num_buyer_24h_change_pct

number

The number of buyers change percentage in the last 24 hours

num_buyer_7d

number

The number of buyers in the last 7 days

num_buyer_7d_change_pct

number

The number of buyers change percentage in the last 7 days

num_buyer_30d

number

The number of buyers in the last 30 days

num_buyer_30d_change_pct

number

The number of buyers change percentage in the last 30 days

num_seller_1m

number

The number of sellers in the last minute

num_seller_1m_change_pct

number

The number of sellers change percentage in the last minute

num_seller_5m

number

The number of sellers in the last 5 minutes

num_seller_5m_change_pct

number

The number of sellers change percentage in the last 5 minutes

num_seller_30m

number

The number of sellers in the last 30 minutes

num_seller_30m_change_pct

number

The number of sellers change percentage in the last 30 minutes

num_seller_1h

number

The number of sellers in the last hour

num_seller_1h_change_pct

number

The number of sellers change percentage in the last hour

num_seller_4h

number

The number of sellers in the last 4 hours

num_seller_4h_change_pct

number

The number of sellers change percentage in the last 4 hours

num_seller_8h

number

The number of sellers in the last 8 hours

num_seller_8h_change_pct

number

The number of sellers change percentage in the last 8 hours

num_seller_24h

number

The number of sellers in the last 24 hours

num_seller_24h_change_pct

number

The number of sellers change percentage in the last 24 hours

num_seller_7d

number

The number of sellers in the last 7 days

num_seller_7d_change_pct

number

The number of sellers change percentage in the last 7 days

num_seller_30d

number

The number of sellers in the last 30 days

num_seller_30d_change_pct

number

The number of sellers change percentage in the last 30 days

price_1m_change_pct

number

The price change percentage in the last minute. Price is in USD

price_5m_change_pct

number

The price change percentage in the last 5 minutes. Price is in USD

price_30m_change_pct

number

The price change percentage in the last 30 minutes. Price is in USD

price_1h_change_pct

number

The price change percentage in the last hour. Price is in USD

price_4h_change_pct

number

The price change percentage in the last 4 hours. Price is in USD

price_8h_change_pct

number

The price change percentage in the last 8 hours. Price is in USD

price_24h_change_pct

number

The price change percentage in the last 24 hours. Price is in USD

price_7d_change_pct

number

The price change percentage in the last 7 days. Price is in USD

price_30d_change_pct

number

The price change percentage in the last 30 days. Price is in USD

market_cap

number

The market capitalization (in USD)

total_supply

number

The total supply

liquidity

number

The total liquidity (in USD). Sum all liquidity of all pools of this token

num_pool

number

The number of pools

num_holder

number

The number of holders

fdv

number

The fully diluted valuation (in USD)

circulating_supply

number

The circulating supply

first_listing_time

number

The first listing time of the token (Unix timestamp in seconds)

platform

array of string

The platforms associated with the token. Platforms are categorized as: DEX (jupiter, lifinity, meteora, orca, raydium, phoenix, sanctum, kamino, openbook, stabble, solfi, zerofi), DEX Aggregator/DCA (jupiterdca, jupiter_limit_order, apepro), Launchpad (pumpfun, letsbonkfun_launchpad, raydium_launchlab, believe_launchpad, moonshot_launchpad, jup_studio_launchpad, bags_launchpad)

trader_hhi_24h

number

The Trader HHI (Herfindahl-Hirschman Index) over the last 24 hours. This metric measures trader concentration and liquidity distribution for the token over a 24-hour window. A value closer to 0 indicates a highly diversified trader base with many participants contributing equally to trading volume, while a value closer to 1 indicates that trading activity is dominated by a small number of traders. Ranges from 0 to 1.

trader_top_1_volume_pct_24h

number

The percentage of total 24-hour trading volume contributed by the single largest trader. A high value indicates that a single wallet dominates trading activity, which may signal wash trading or thin liquidity. Expressed as a percentage (0-100).

trader_top_5_volume_pct_24h

number

The cumulative percentage of total 24-hour trading volume contributed by the top 5 traders. A high value suggests concentrated trading activity among a small group of wallets. Expressed as a percentage (0-100).

trader_top_20_volume_pct_24h

number

The cumulative percentage of total 24-hour trading volume contributed by the top 20 traders. Helps assess whether trading volume is broadly distributed or concentrated. Expressed as a percentage (0-100).

trader_top_100_volume_pct_24h

number

The cumulative percentage of total 24-hour trading volume contributed by the top 100 traders. Values near 100% indicate that almost all trading activity is confined to the top 100 wallets. Expressed as a percentage (0-100).

holder_gini

number

The Gini coefficient measuring how equally or unequally the token supply is distributed across holder wallet addresses. A value of 0 represents perfect equality (all holders own the same amount), while a value of 1 represents absolute concentration (one holder owns everything). Higher values indicate greater inequality in token distribution. Ranges from 0 to 1.

holder_hhi

number

The Holder HHI (Herfindahl-Hirschman Index) measures how concentrated or decentralized token ownership is among holders. A value closer to 0 indicates a highly decentralized ownership structure with many holders each controlling a small share, while a value closer to 1 indicates that ownership is concentrated in a few large wallets. Useful for assessing counterparty risk and whale exposure. Ranges from 0 to 1.

holder_top_1_balance_pct

number

The percentage of total token supply held by the single largest holder. A high value may indicate centralized control or potential sell-pressure risk from a single wallet. Expressed as a percentage (0-100).

holder_top_5_balance_pct

number

The cumulative percentage of total token supply held by the top 5 holders. Helps evaluate how concentrated ownership is among the largest wallets. Expressed as a percentage (0-100).

holder_top_20_balance_pct

number

The cumulative percentage of total token supply held by the top 20 holders. A high value indicates that a relatively small group controls a significant portion of the supply. Expressed as a percentage (0-100).

holder_top_100_balance_pct

number

The cumulative percentage of total token supply held by the top 100 holders. Values near 100% indicate that nearly all circulating supply is concentrated among the top 100 wallets. Expressed as a percentage (0-100).

400

Bad Request

Response Body (application/json)

401

Authentication failed

Response Body (application/json)

429

Too Many Requests

Response Body (application/json)

500

Internal Server Error

Response Body (application/json)

icon

Javascript

icon

Python

icon

Shell

icon

Go

icon

C#

Authorization

Response

Click Try It! to start a request and see the response here!

Response Examples