tehcscreener

public api

powered byAllium
base urlhttps://tehcscreener.com/api/v1

endpoints

GET/api/v1/launchpads

Every listed launchpad with its totals over the window, highest volume first.

query params

paramdefaultaccepted
window7d1d | 7d | 30d | all

response

fieldtypedescription
windowstringthe window used
throughdatelatest day in the launchpad data
padsarrayone object per (chain, pad)
pads[].chainstringchain the pad runs on
pads[].padstringpad id, as used in /launchpads/{chain}/{pad}
pads[].logo_pathstring | nullsite-relative logo path
pads[].tokens_launchedinttokens launched in the window
pads[].volume_usdnumbertrading volume in the window
pads[].trade_txnsinttrade transactions in the window
pads[].tokens_tradedintsum of the per-day count of tokens traded

example

curl "https://tehcscreener.com/api/v1/launchpads?window=30d"

GET/api/v1/launchpads/series

Daily volume, launches and protocol revenue per listed launchpad: one series per (chain, pad), highest total volume first.

query params

paramdefaultaccepted
window30d1d | 7d | 30d | all

response

fieldtypedescription
windowstringthe window used
throughdatelatest day in the launchpad data
daysdate[]every day with data in the window, ascending
seriesarrayone object per (chain, pad)
series[].chainstringchain
series[].padstringpad id
series[].colorstring | nullthe pad's chart color on the site
series[].logo_pathstring | nullsite-relative logo path
series[].volume_usdnumber[]volume per day, aligned to days (0 when none)
series[].tokens_launchedint[]launches per day, aligned to days
series[].revenue_usd(number | null)[] | nullprotocol revenue per day, aligned to days; null on a day without revenue data. The whole field is null for a pad without revenue data

example

curl "https://tehcscreener.com/api/v1/launchpads/series?window=7d"

GET/api/v1/launchpads/{chain}/{pad}

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.

query params

paramdefaultaccepted
window30d1d | 7d | 30d | all
tokenstradedtraded (any token traded on the pad) | launched (only tokens launched on it within the window)

response

fieldtypedescription
chain, pad, windowstringecho of the request
tokens_modestringthe tokens param used
profileobject | nullname, 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
dailyarray{day, tokens_launched, volume_usd, trade_txns} per day, ascending
top_tokensarrayup 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[].namestring | nullthe token's ticker and name where the launchpad's own launch data provides them (e.g. rise.rich); null otherwise
top_tokens[].onchain_mcap_usdnumber | nullclosed-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_1dnumber | nullclosed-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

example

curl "https://tehcscreener.com/api/v1/launchpads/solana/pumpfun?window=7d&tokens=launched"

GET/api/v1/launchpads/{chain}/{project}/revenue

One launchpad's daily revenue in USD, full history. Use the chain and pad from /launchpads. Pads without revenue data return 404.

query params

none

response

fieldtypedescription
chain, projectstringecho of the request
dailyarrayone object per day with revenue data, full history, ascending
daily[].daydatethe day
daily[].protocol_revenue_usdnumberfees kept by the protocol
daily[].creator_revenue_usdnumber | nullcreator/cashback fees; null on historical rows predating per-trade measurement (Oct 2026)
daily[].sourcestringdata lineage, e.g. allium_events
daily[].buyback_usdnumber | nullUSD spent buying back the launchpad's own token that day; null where buybacks aren't tracked

example

curl "https://tehcscreener.com/api/v1/launchpads/solana/pumpfun/revenue"

GET/api/v1/bots

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.)

query params

paramdefaultaccepted
window30d1d | 7d | 30d | all
chainallall, or one chain from the response's chains list
groupbotbot (a series per bot) | chain (a series per chain)

response

fieldtypedescription
window, chain, groupstringecho of the request
chainsstring[]every chain with data from a bot in this list
throughdatelatest day in the bot data
daysdate[]every day with data in the window, ascending
seriesarrayone object per bot (or chain)
series[].namestringbot id (or chain), as used in /bots/{bot}
series[].display_namestringdisplay name; falls back to name
series[].colorstring | nullchart color on the site
series[].logo_pathstring | nullsite-relative logo path
series[].volume_usdnumber[]volume per day, aligned to days; rounded to cents
series[].txnsint[]transactions per day
series[].fees_usdnumber[]fees per day; rounded to cents

example

curl "https://tehcscreener.com/api/v1/bots?window=7d&group=bot"

GET/api/v1/bots/{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.

query params

paramdefaultaccepted
windowall1d | 7d | 30d | all

response

fieldtypedescription
botstringbot id, lowercased
display_namestringdisplay name; falls back to bot
color, logo_path, website_url, x_url, descriptionstring | nullprofile fields
windowstringthe window used
throughdatelatest day in the bot data
first_daydatethe bot's first day with data
totalsobject{volume_usd, fees_usd, txns}, lifetime (ignores window)
daysdate[]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
seriesarrayone object per chain, highest volume first
series[].namestringchain
series[].display_name, series[].colorstringchain display name (falls back to name) and color
series[].volume_usd / txns / fees_usd / walletsnumber[]per day, aligned to days
tokens_sincedate | nullfirst day of per-token data for this bot
token_windowsstring[]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_tokensarrayup 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

example

curl "https://tehcscreener.com/api/v1/bots/axiom?window=30d"

GET/api/v1/bots/{bot}/perps

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}.

response

fieldtypedescription
botstringbot id, lowercased
first_daydate | nullthe bot's first day with perps data; null when days is empty
throughdate | nullthe bot's latest day with perps data; null when days is empty
totalsobject{volume_usd, fees_usd, txns}, lifetime sums of the fields below
daysdate[]every day with perps activity, ascending
volume_usdnumber[]perps notional volume in USD
fees_usdnumber[]the project's builder fees in USD
txnsint[]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

example

curl https://tehcscreener.com/api/v1/bots/fomo/perps

example response (trimmed to the last 3 days)

{
  "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"
}

GET/api/v1/chains

Every chain with chain-wide stats, with its latest day, highest latest dex volume first. This is the list of chains /chains/{chain} covers.

query params

none

response

fieldtypedescription
chainsarrayone object per covered chain
chains[].chainstringchain id, as used in /chains/{chain}
chains[].display_namestringdisplay name; falls back to chain
chains[].color, chains[].logo_pathstring | nullprofile fields
chains[].secondary_colorstring | nullsecond profile colour (used for line charts on the site); null when unset
chains[].throughdatelatest day for this chain
chains[].latestobjectthat day's {txns, active_wallets, dex_volume_usd, dex_trades}

example

curl https://tehcscreener.com/api/v1/chains

GET/api/v1/chains/{chain}

Chain-wide daily stats. Covered chains are the ones /chains lists; any other chain returns 404.

query params

paramdefaultaccepted
windowall1d | 7d | 30d | all (counted back from this chain's latest day)

response

fieldtypedescription
chainstringchain id, lowercased
display_namestringdisplay name; falls back to chain
color, logo_pathstring | nullprofile fields
secondary_colorstring | nullsecond profile colour (used for line charts on the site); null when unset
website_url, x_urlstring | nullthe chain's website and X links; null when unset
token_addressstring | nullthe chain's own token contract address; null when unset
windowstringthe window used
throughdatelatest day for this chain
daysdate[]days in the window, ascending
txnsint[]transactions per day
active_walletsint[]active wallets per day
dex_volume_usdnumber[]DEX volume per day
dex_tradesint[]DEX trades per day

example

curl "https://tehcscreener.com/api/v1/chains/robinhood?window=30d"

GET/api/v1/rwa

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.

query params

paramdefaultaccepted
chainallone chain, e.g. robinhood; a chain with no data returns empty rows
fromfirst dayYYYY-MM-DD, inclusive; anything else returns 400
tolatest dayYYYY-MM-DD, inclusive; anything else, or a date before from, returns 400

response

fieldtypedescription
throughdate | nulllatest day in the data for chain, whatever from and to say; null when there is none
rowsarrayone object per day and chain, days ascending
rows[].daydateUTC day
rows[].chainstringthe chain
rows[].volume_usdnumberpool volume that day; 0 on a day with value and no trading
rows[].value_usdnumber | nulltotal value at the end of that day; null when the chain has no value that day
rows[].swapsintswaps that day, per pool
rows[].assets_tradedintdistinct tokenized assets with volume that day
rows[].assets_valuedinttokenized assets priced in value_usd that day

example

curl "https://tehcscreener.com/api/v1/rwa?chain=robinhood&from=2026-10-01&to=2026-10-31"

GET/api/v1/trench

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.

query params

none

response

fieldtypedescription
todayobject | nulllatest scored day; null when there is not enough history yet
today.daydatethe scored day
today.scoreint0–100
today.bandstringded | cold | active | hot | euphoric
today.componentsobjectkeyed 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
historyarray{day, score} for every scored day, oldest first
trackedobject{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_daysintshort trailing window length (90)
method.window_days_longintlong trailing window length (365)
method.blendobject{short, long}: how the two windows' percentiles combine (sums to 1)
method.cooldownfloatscore drops decay by this factor per day; rises apply same-day
method.weightsobjectcomponent → 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.bandsobjectband → score range; omitted when today is null

example

curl https://tehcscreener.com/api/v1/trench

GET/api/v1/status

The most recent data sync.

query params

none

response

fieldtypedescription
synced_atstringwhen the last sync landed (timestamp)
sourcestringwhere the sync came from
rows_grainintper-token rows loaded by that sync
rows_padintper-pad rows loaded by that sync
notestring | nullfree-text note; before any sync the body is just {"note": "no syncs yet"}

example

curl https://tehcscreener.com/api/v1/status

DEXs

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.

GET/api/v1/dexes

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).

query params

paramdefaultaccepted
window7d1d | 7d | 30d | all
chain(all)a chain id, e.g. elysium

response

fieldtypedescription
windowstringthe window used
dexesarrayone object per (chain, dex)
dexes[].chainstringchain the DEX runs on
dexes[].dexstringDEX id, as used in /dexes/{chain}/{dex}
dexes[].namestring | nulldisplay name; null without a profile
dexes[].throughdatelast day of this DEX's window (its chain's latest complete day)
dexes[].volume_usdnumber | nulltrading volume in the window; null for a DEX whose stats aren't tracked
dexes[].tradesint | nulltrades in the window; null for a DEX whose stats aren't tracked
dexes[].poolsint | nullpools 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[].tradersint | nulldistinct traders that day; 1d only, as pools; null where the DEX's trader counts aren't tracked
dexes[].revenue_usdnumber | nullprotocol revenue in the window; null for a DEX whose revenue isn't tracked

example

curl "https://tehcscreener.com/api/v1/dexes?window=30d"

GET/api/v1/dexes/series

Daily volume and protocol revenue per DEX: one series per (chain, dex), highest total volume first, then by revenue.

query params

paramdefaultaccepted
window30d1d | 7d | 30d | all

response

fieldtypedescription
windowstringthe window used
throughdate | nulllatest complete day in the DEX data
daysdate[]every day with data in the window, ascending
seriesarrayone object per (chain, dex)
series[].chainstringchain
series[].dexstringDEX id
series[].namestring | nulldisplay name; null without a profile
series[].volume_usd(number | null)[] | nullvolume 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)[] | nullprotocol 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

example

curl "https://tehcscreener.com/api/v1/dexes/series?window=7d"

GET/api/v1/dexes/{chain}/{dex}

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.

query params

none

response

fieldtypedescription
chain, dexstringecho of the request
namestring | nulldisplay name; null without a profile
first_daydatefirst day in daily
throughdatelast day in daily
dailyarrayone object per day with stats or revenue, ascending
daily[].daydatethe day
daily[].volume_usdnumber | nulltrading volume that day; null where the DEX's stats aren't tracked
daily[].tradesint | nulltrades that day; null where the DEX's stats aren't tracked
daily[].poolsint | nullpools 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[].tradersint | nulldistinct traders that day (exact for the day); null where the DEX's stats or trader counts aren't tracked
daily[].protocol_revenue_usdnumber | nullthat day's protocol revenue; null where the DEX's revenue isn't tracked

example

curl "https://tehcscreener.com/api/v1/dexes/elysium/uniswap"

GET/api/v1/dexes/{chain}/{dex}/revenue

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.

query params

none

response

fieldtypedescription
chain, dexstringecho of the request
dailyarrayone object per day with revenue data, full history, ascending
daily[].daydatethe day
daily[].protocol_revenue_usdnumber | nullfees 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[].sourcestring | nulldata lineage, e.g. allium_events

example

curl "https://tehcscreener.com/api/v1/dexes/solana/pumpswap/revenue"

terms

The API is free to use. If you publish statistics or charts, credit tehcscreener.com as the source.

tip jar

solana DVgCkNymLjmi1mpg8atNRrqbQjtkJf5nAmimuk3pVUPQ

claim your tip

Paste your transaction signature to claim the tip and leave a comment. Please claim right after sending. $1 minimum. Tips in SOL or USDC show your name.

recent tips

feedback

Bugs and requests: @adam_tehc on X.