api.tonscan.com

Search

Search for a TON address, transaction hash, jetton name, NFT collection, or .ton domain. Returns up to 25 matching results with type, address, and name. Accepts friendly addresses (48-char base64), raw addresses (0:hex), tx hashes, or plain text names.

Get Address Information

Get balance, state (active/inactive/frozen), and metadata for a TON wallet or contract address. Returns balance in nanoTON, friendly name, validator/nominator/staking flags, and code hash.

Get Whale Accounts

Get the top TON whale accounts ranked by transaction volume in the latest snapshot. Each entry includes: account address, friendly name, txn_volume (nanoTON), num_txns, volume_delta vs previous snapshot, z_score anomaly signal (stddevs from 24h baseline), also_hedging (simultaneously active in USDT flows), also_vesting (Believers Fund participant), is_locker (the Believers Fund locker contract itself).

Get Whale Anomalies

Get TON whale accounts with unusually high activity — deviating >= threshold standard deviations from their 24-hour rolling baseline. Sorted by also_hedging then z_score. Accounts with also_hedging=true are simultaneously active in USDT flows — highest conviction signal. threshold: float between 0.5 and 10.0 (default 2.0).

Get Whale Trends

Get daily TON transaction volume per whale account over the last N days (1–30). Returns the top 50 accounts by total volume, each with a list of daily {day, volume, txns}. Useful for spotting accumulation trends, spikes, or sustained activity.

Get Jetton Netflow

Get per-account net jetton flow for the latest snapshot. net_volume = receive_volume - send_volume: positive = net buyer / accumulator, negative = net seller / distributor. Sorted by abs(net_volume) descending so biggest movers appear first. jetton_master: master contract address (defaults to USDT). Amounts in the jetton's native units (USDT = micro-USDT, divide by 1e6).

Get Jetton Anomalies

Get jetton flow accounts deviating >= threshold standard deviations from their 24h baseline. Sorted by z_score descending. Useful for spotting unusual accumulation or distribution. jetton_master: master contract address (defaults to USDT). threshold: float between 0.5 and 10.0 (default 2.0).

Get Usdt Pool Liquidity

Get latest USDT pool liquidity across all TON DEXes (StonFi, DeDust, TonCo, Coffee). Only large pools (>= 50k USDT). Includes diff vs previous snapshot, 24h baseline, and z_score. reserve_usdt in micro-USDT (divide by 1e6 for USDT).

Get All Pool Liquidity

Get latest liquidity for all tracked pools (USDT and pTON/jetton pairs) across all DEXes. Returns top 100 pools by USD value. Includes reserve_usd (float, pre-calculated), 24h sparkline, z_score anomaly signal, dex name, pool_type, and jetton names.

Get Jetton Pool Liquidity

Get pool liquidity snapshots for a specific jetton across all DEXes. Covers both pTON and USDT pairs. Includes delta vs previous snapshot and 24h z_score. jetton_master: the jetton master contract address.

Get Unstake Events

Get recent unstaking events on TON. hours: lookback window 1–168 (default 24). event_type: 'elector' (validator withdrawing from Elector, >1000 TON) or 'liquid_staking' (Hipo/Tonstakers LST burn). Omit for both types. Returns: detected_at, event_type, account, amount (nanoTON), friendly_name, tx_hash.

Get Transaction Summary

Get an AI-generated plain-English summary of a TON transaction. tx_hash: base64 or hex transaction hash. Returns a human-readable description of what the transaction did.