YYYY-MM-DD strings; amounts are USD. Data updates
once a day. Every response carries a top-level
"source": "tehcscreener.com" (on /status,
source is the sync source).window accepts 1d,
7d, 30d or all, counted back from the
latest day in the data (the response's through), not from the
current date. Other values return 400.days array.{"detail": "..."}.days for a bot without perps data (e.g. fomo has it).Retry-After and X-RateLimit-* headers.Every listed launchpad with its totals over the window, highest volume first.
| param | default | accepted |
|---|---|---|
| window | 7d | 1d | 7d | 30d | all |
| field | type | description |
|---|---|---|
| window | string | the window used |
| through | date | latest day in the launchpad data |
| pads | array | one object per (chain, pad) |
| pads[].chain | string | chain the pad runs on |
| pads[].pad | string | pad id, as used in /launchpads/{chain}/{pad} |
| pads[].logo_path | string | null | site-relative logo path |
| pads[].tokens_launched | int | tokens launched in the window |
| pads[].volume_usd | number | trading volume in the window |
| pads[].trade_txns | int | trade transactions in the window |
| pads[].tokens_traded | int | sum of the per-day count of tokens traded |
curl "https://tehcscreener.com/api/v1/launchpads?window=30d"
Daily volume, launches and protocol revenue per listed launchpad: one series per (chain, pad), highest total volume first.
| param | default | accepted |
|---|---|---|
| window | 30d | 1d | 7d | 30d | all |
| field | type | description |
|---|---|---|
| window | string | the window used |
| through | date | latest day in the launchpad data |
| days | date[] | every day with data in the window, ascending |
| series | array | one object per (chain, pad) |
| series[].chain | string | chain |
| series[].pad | string | pad id |
| series[].color | string | null | the pad's chart color on the site |
| series[].logo_path | string | null | site-relative logo path |
| series[].volume_usd | number[] | volume per day, aligned to days (0 when none) |
| series[].tokens_launched | int[] | launches per day, aligned to days |
| series[].revenue_usd | (number | null)[] | null | protocol revenue per day, aligned to days; null on a day without revenue data. The whole field is null for a pad without revenue data |
curl "https://tehcscreener.com/api/v1/launchpads/series?window=7d"
One launchpad: profile, daily totals and its top 50 tokens
by volume. chain and pad are the values from
/launchpads. Unknown or unlisted pads return 404.
| param | default | accepted |
|---|---|---|
| window | 30d | 1d | 7d | 30d | all |
| tokens | traded | traded (any token traded on the pad) | launched (only tokens launched on it within the window) |
| field | type | description |
|---|---|---|
| chain, pad, window | string | echo of the request |
| tokens_mode | string | the tokens param used |
| profile | object | null | name, description, website_url, x_url, logo_path, banner_path, color, pad_token (the pad's own token, if any); null when no profile is set |
| daily | array | {day, tokens_launched, volume_usd, trade_txns} per day, ascending |
| top_tokens | array | up to 50, highest volume first: {token, volume_usd, trade_txns, first_day}; token is the token address, first_day its first day with activity in the window |
| top_tokens[].symbol, top_tokens[].name | string | null | the token's ticker and name where the launchpad's own launch data provides them (e.g. rise.rich); null otherwise |
| top_tokens[].onchain_mcap_usd | number | null | closed-curve launchpads only (the pad's own protocol is the only market for its tokens, e.g. solana/rise.rich): market cap from the protocol's own onchain price × emitted supply, latest day in the last 14; null when none. Absent for every other launchpad |
| top_tokens[].onchain_change_1d | number | null | closed-curve launchpads only: day-over-day price change over the last two full days, as a fraction (0.05 = +5%), from the protocol's own onchain price; null when the token did not trade on both days. Absent for every other launchpad |
curl "https://tehcscreener.com/api/v1/launchpads/solana/pumpfun?window=7d&tokens=launched"
One launchpad's daily revenue in USD, full history. Use the
chain and pad from /launchpads.
Pads without revenue data return 404.
none
| field | type | description |
|---|---|---|
| chain, project | string | echo of the request |
| daily | array | one object per day with revenue data, full history, ascending |
| daily[].day | date | the day |
| daily[].protocol_revenue_usd | number | fees kept by the protocol |
| daily[].creator_revenue_usd | number | null | creator/cashback fees; null on historical rows predating per-trade measurement (Oct 2026) |
| daily[].source | string | data lineage, e.g. allium_events |
| daily[].buyback_usd | number | null | USD spent buying back the launchpad's own token that day; null where buybacks aren't tracked |
curl "https://tehcscreener.com/api/v1/launchpads/solana/pumpfun/revenue"
Daily volume, transactions and fees for trading bots
(terminals), one series per bot or per chain, highest total volume first.
Lists the bots shown in comparisons on the site; a few published bots
stand alone (their own page only) and are left out here, but still
answer on /bots/{bot}. (Not in v1: the site's own
/api/bots also carries a standalone directory
of those bots for site search; v1 omits it.)
| param | default | accepted |
|---|---|---|
| window | 30d | 1d | 7d | 30d | all |
| chain | all | all, or one chain from the response's chains list |
| group | bot | bot (a series per bot) | chain (a series per chain) |
| field | type | description |
|---|---|---|
| window, chain, group | string | echo of the request |
| chains | string[] | every chain with data from a bot in this list |
| through | date | latest day in the bot data |
| days | date[] | every day with data in the window, ascending |
| series | array | one object per bot (or chain) |
| series[].name | string | bot id (or chain), as used in /bots/{bot} |
| series[].display_name | string | display name; falls back to name |
| series[].color | string | null | chart color on the site |
| series[].logo_path | string | null | site-relative logo path |
| series[].volume_usd | number[] | volume per day, aligned to days; rounded to cents |
| series[].txns | int[] | transactions per day |
| series[].fees_usd | number[] | fees per day; rounded to cents |
curl "https://tehcscreener.com/api/v1/bots?window=7d&group=bot"
One trading bot: profile, lifetime totals, per-chain daily
series and its top 50 tokens. bot is a name from
/bots (case-insensitive), or a standalone published bot that
/bots leaves out. Unknown or unlisted bots return 404.
| param | default | accepted |
|---|---|---|
| window | all | 1d | 7d | 30d | all |
| field | type | description |
|---|---|---|
| bot | string | bot id, lowercased |
| display_name | string | display name; falls back to bot |
| color, logo_path, website_url, x_url, description | string | null | profile fields |
| window | string | the window used |
| through | date | latest day in the bot data |
| first_day | date | the bot's first day with data |
| totals | object | {volume_usd, fees_usd, txns}, lifetime (ignores window) |
| days | date[] | days with data in the window, ascending |
| wallets_dedup | (int | null)[] | per day, aligned to days: deduplicated wallet count where the source provides one, else null |
| series | array | one object per chain, highest volume first |
| series[].name | string | chain |
| series[].display_name, series[].color | string | chain display name (falls back to name) and color |
| series[].volume_usd / txns / fees_usd / wallets | number[] | per day, aligned to days |
| tokens_since | date | null | first day of per-token data for this bot |
| token_windows | string[] | the window values this bot's token data covers for top_tokens: always 1d and 7d; 30d when token data spans the last 30 days of the volume series; all when it starts with the volume series (3 days of tolerance) |
| top_tokens | array | up to 50, highest volume first: {chain, token, volume_usd, txns, peak_wallets, first_day, last_day}; peak_wallets is the highest single-day wallet count; tokens only: quote-to-quote swaps (no attributable token) are left out of the ranking but stay in every total. Per-token data covers only tokens that reached 25 or more wallets on some day on some terminal, from 30 days before the first such day on; a token that never did is absent from every window, however high its volume, and for all a token's days before that start are left out, so its volume_usd and txns can read low and first_day late |
curl "https://tehcscreener.com/api/v1/bots/axiom?window=30d"
Daily Hyperliquid perps volume, fees, trades and traders
for a project, from its Hyperliquid builder codes. bot is a
name from /bots. Perps volume is notional and is
not included in /bots or /bots/{bot}.
| field | type | description |
|---|---|---|
| bot | string | bot id, lowercased |
| first_day | date | null | the bot's first day with perps data; null when days is empty |
| through | date | null | the bot's latest day with perps data; null when days is empty |
| totals | object | {volume_usd, fees_usd, txns}, lifetime sums of the fields below |
| days | date[] | every day with perps activity, ascending |
| volume_usd | number[] | perps notional volume in USD |
| fees_usd | number[] | the project's builder fees in USD |
| txns | int[] | fills |
| wallets | (int | null)[] | unique Hyperliquid accounts trading through the project's builder codes, the same number as daily active perps traders on the bot page |
curl https://tehcscreener.com/api/v1/bots/fomo/perps
{
"bot": "fomo",
"first_day": "2025-08-01",
"through": "2026-10-24",
"totals": {"volume_usd": 7479345261.73911, "fees_usd": 3353442.030159, "txns": 3624807},
"days": ["2026-10-22", "2026-10-23", "2026-10-24"],
"volume_usd": [185850123.51, 99320003.24, 125070258.38],
"fees_usd": [80055.28, 42641.85, 51908.98],
"txns": [51915, 39676, 36448],
"wallets": [3155, 2153, 2320],
"source": "tehcscreener.com"
}
Every chain with chain-wide stats, with its latest day,
highest latest dex volume first. This is the list of chains
/chains/{chain} covers.
none
| field | type | description |
|---|---|---|
| chains | array | one object per covered chain |
| chains[].chain | string | chain id, as used in /chains/{chain} |
| chains[].display_name | string | display name; falls back to chain |
| chains[].color, chains[].logo_path | string | null | profile fields |
| chains[].secondary_color | string | null | second profile colour (used for line charts on the site); null when unset |
| chains[].through | date | latest day for this chain |
| chains[].latest | object | that day's {txns, active_wallets, dex_volume_usd, dex_trades} |
curl https://tehcscreener.com/api/v1/chains
Chain-wide daily stats. Covered chains are the ones
/chains lists; any other chain returns 404.
| param | default | accepted |
|---|---|---|
| window | all | 1d | 7d | 30d | all (counted back from this chain's latest day) |
| field | type | description |
|---|---|---|
| chain | string | chain id, lowercased |
| display_name | string | display name; falls back to chain |
| color, logo_path | string | null | profile fields |
| secondary_color | string | null | second profile colour (used for line charts on the site); null when unset |
| website_url, x_url | string | null | the chain's website and X links; null when unset |
| token_address | string | null | the chain's own token contract address; null when unset |
| window | string | the window used |
| through | date | latest day for this chain |
| days | date[] | days in the window, ascending |
| txns | int[] | transactions per day |
| active_wallets | int[] | active wallets per day |
| dex_volume_usd | number[] | DEX volume per day |
| dex_trades | int[] | DEX trades per day |
curl "https://tehcscreener.com/api/v1/chains/robinhood?window=30d"
Tokenized real-world assets per chain, one row per day and chain.
volume_usd: daily volume of every pool that holds a
tokenized asset. Routed swaps count in each pool they pass through. Pools of two
tokenized assets are excluded.
value_usd: end-of-day supply times closing price, summed
over the chain's tokenized assets. Wrapped tokens are excluded, since their
underlying is already counted. A token without a price uses its last price for up
to 7 days, then is excluded until priced again.
| param | default | accepted |
|---|---|---|
| chain | all | one chain, e.g. robinhood; a chain with no data returns empty rows |
| from | first day | YYYY-MM-DD, inclusive; anything else returns 400 |
| to | latest day | YYYY-MM-DD, inclusive; anything else, or a date before from, returns 400 |
| field | type | description |
|---|---|---|
| through | date | null | latest day in the data for chain, whatever from and to say; null when there is none |
| rows | array | one object per day and chain, days ascending |
| rows[].day | date | UTC day |
| rows[].chain | string | the chain |
| rows[].volume_usd | number | pool volume that day; 0 on a day with value and no trading |
| rows[].value_usd | number | null | total value at the end of that day; null when the chain has no value that day |
| rows[].swaps | int | swaps that day, per pool |
| rows[].assets_traded | int | distinct tokenized assets with volume that day |
| rows[].assets_valued | int | tokenized assets priced in value_usd that day |
curl "https://tehcscreener.com/api/v1/rwa?chain=robinhood&from=2026-10-01&to=2026-10-31"
Composite 0–100 activity score for launchpads and trading terminals, percentile-ranked against a trailing 90-day window and blended by weight. Only days with launchpad, launchpad revenue and terminal data all present count; a day is scored once 30 such days of history exist.
Weights: launchpad volume 20%, new launches 10%, launchpad revenue 15%, terminal volume 30%, terminal fees 25%.
Nov 12, 2026: launchpad revenue added; weights changed from 35/20/25/20; history recomputed with the new formula.
none
| field | type | description |
|---|---|---|
| today | object | null | latest scored day; null when there is not enough history yet |
| today.day | date | the scored day |
| today.score | int | 0–100 |
| today.band | string | ded | cold | active | hot | euphoric |
| today.components | object | keyed pad_volume, tokens_launched, pad_revenue, bot_volume, bot_fees; each {value, percentile}: the day's raw total and its 0–100 blended percentile (see method.blend). pad_revenue is the day's protocol revenue in USD across tracked launchpads (from revenue_daily); bot_volume / bot_fees are trading-terminal volume and fees |
| history | array | {day, score} for every scored day, oldest first |
| tracked | object | {launchpads, terminals}: how many launchpads the launchpad war lists (one per chain and launchpad, the same set as /launchpads/series?window=all) and how many listed trading bots are covered |
| method.window_days | int | short trailing window length (90) |
| method.window_days_long | int | long trailing window length (365) |
| method.blend | object | {short, long}: how the two windows' percentiles combine (sums to 1) |
| method.cooldown | float | score drops decay by this factor per day; rises apply same-day |
| method.weights | object | component → weight (sums to 1): pad_volume 0.20, tokens_launched 0.10, pad_revenue 0.15, bot_volume 0.30, bot_fees 0.25 |
| method.bands | object | band → score range; omitted when today is null |
curl https://tehcscreener.com/api/v1/trench
The most recent data sync.
none
| field | type | description |
|---|---|---|
| synced_at | string | when the last sync landed (timestamp) |
| source | string | where the sync came from |
| rows_grain | int | per-token rows loaded by that sync |
| rows_pad | int | per-pad rows loaded by that sync |
| note | string | null | free-text note; before any sync the body is just {"note": "no syncs yet"} |
curl https://tehcscreener.com/api/v1/status
Per-DEX daily stats and protocol revenue. A DEX is keyed
by chain and dex (one id across all its
versions, e.g. uniswap). A DEX can have stats without
revenue, or revenue without stats: whatever isn't tracked is
null, never 0. Revenue is protocol revenue, the fees the DEX
itself keeps. DEX revenue never enters launchpad numbers: a launchpad's
own AMM (e.g. pump.fun's PumpSwap) is reported here, never in
/launchpads. Complete UTC days only. DEXs appear once they
are listed on the site; others are left out of the lists and return 404.
Every listed DEX with stats or revenue in the window, highest
volume first; DEXs without volume follow, by revenue. Each chain's
window ends at its own latest complete day (through).
| param | default | accepted |
|---|---|---|
| window | 7d | 1d | 7d | 30d | all |
| chain | (all) | a chain id, e.g. elysium |
| field | type | description |
|---|---|---|
| window | string | the window used |
| dexes | array | one object per (chain, dex) |
| dexes[].chain | string | chain the DEX runs on |
| dexes[].dex | string | DEX id, as used in /dexes/{chain}/{dex} |
| dexes[].name | string | null | display name; null without a profile |
| dexes[].through | date | last day of this DEX's window (its chain's latest complete day) |
| dexes[].volume_usd | number | null | trading volume in the window; null for a DEX whose stats aren't tracked |
| dexes[].trades | int | null | trades in the window; null for a DEX whose stats aren't tracked |
| dexes[].pools | int | null | pools traded that day; 1d only (null for wider windows: distinct counts don't sum). Outside elysium it counts pool addresses, so a singleton-pool DEX (e.g. uniswap v4) reads about 1 however many pairs trade |
| dexes[].traders | int | null | distinct traders that day; 1d only, as pools; null where the DEX's trader counts aren't tracked |
| dexes[].revenue_usd | number | null | protocol revenue in the window; null for a DEX whose revenue isn't tracked |
curl "https://tehcscreener.com/api/v1/dexes?window=30d"
Daily volume and protocol revenue per DEX: one series per (chain, dex), highest total volume first, then by revenue.
| param | default | accepted |
|---|---|---|
| window | 30d | 1d | 7d | 30d | all |
| field | type | description |
|---|---|---|
| window | string | the window used |
| through | date | null | latest complete day in the DEX data |
| days | date[] | every day with data in the window, ascending |
| series | array | one object per (chain, dex) |
| series[].chain | string | chain |
| series[].dex | string | DEX id |
| series[].name | string | null | display name; null without a profile |
| series[].volume_usd | (number | null)[] | null | volume per day, aligned to days; null on a day without a row. The whole field is null for a DEX whose stats aren't tracked |
| series[].revenue_usd | (number | null)[] | null | protocol revenue per day, aligned to days; null on a day without a row. The whole field is null for a DEX whose revenue isn't tracked |
curl "https://tehcscreener.com/api/v1/dexes/series?window=7d"
One DEX's daily stats and protocol revenue, full history.
Use the chain and dex from /dexes.
A DEX not listed on the site, or with neither stats nor revenue,
returns 404.
none
| field | type | description |
|---|---|---|
| chain, dex | string | echo of the request |
| name | string | null | display name; null without a profile |
| first_day | date | first day in daily |
| through | date | last day in daily |
| daily | array | one object per day with stats or revenue, ascending |
| daily[].day | date | the day |
| daily[].volume_usd | number | null | trading volume that day; null where the DEX's stats aren't tracked |
| daily[].trades | int | null | trades that day; null where the DEX's stats aren't tracked |
| daily[].pools | int | null | pools traded that day; null where the DEX's stats aren't tracked. Outside elysium it counts pool addresses, so a singleton-pool DEX (e.g. uniswap v4) reads about 1 |
| daily[].traders | int | null | distinct traders that day (exact for the day); null where the DEX's stats or trader counts aren't tracked |
| daily[].protocol_revenue_usd | number | null | that day's protocol revenue; null where the DEX's revenue isn't tracked |
curl "https://tehcscreener.com/api/v1/dexes/elysium/uniswap"
One DEX's daily protocol revenue in USD, full history. A DEX not listed on the site, or whose revenue isn't tracked, returns 404.
none
| field | type | description |
|---|---|---|
| chain, dex | string | echo of the request |
| daily | array | one object per day with revenue data, full history, ascending |
| daily[].day | date | the day |
| daily[].protocol_revenue_usd | number | null | fees kept by the DEX's protocol that day, in USD. How fees are valued depends on the DEX: e.g. PumpSwap's are valued only where the quote token has a non-DEX price feed, so pools quoting a self-minted token count as zero |
| daily[].source | string | null | data lineage, e.g. allium_events |
curl "https://tehcscreener.com/api/v1/dexes/solana/pumpswap/revenue"
The API is free to use. If you publish statistics or charts, credit tehcscreener.com as the source.
DVgCkNymLjmi1mpg8atNRrqbQjtkJf5nAmimuk3pVUPQ
Bugs and requests: @adam_tehc on X.