Market Overview
Read daily on-chain activity per chain and per launchpad, and the daily trench score.
The Market Overview endpoints serve daily market statistics: transactions, active wallets and DEX volume per chain, tokens launched and volume per launchpad, launchpad revenue, and a 0-100 trench score of overall memecoin activity. The data comes from tehcscreener.com and is credited as such in the app.
Every series is a list of YYYY-MM-DD days with values aligned by index. through is the latest day in a dataset; the app counts its 1d, 7d and 30d windows back from it. Chains and launchpads use the data provider's identifiers (solana, bnb, pumpfun, letsbonk, ...), not Proxima chain IDs.
In the web app these endpoints feed the Market Overview panel in the bottom bar.
List market chains
/market/chains Lists the chains covered by the market data.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The SDK returns the chains array. The app keeps only chains it supports, then fetches each chain's series.
Parameters
No parameters.
Returns 200 OK · application/json
-
chainsarray<object>Covered chains.Child attributes 3
-
chainstringProvider chain identifier, e.g.solana,bnb,ethereum,base. -
display_namestringHuman-readable chain name. -
throughstringLatest day with data (YYYY-MM-DD).
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getChains() src/lib/proxima/endpoints/market.ts
Retrieve chain activity
/market/chains/{chain} Returns daily transactions, active wallets and DEX volume for one chain.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
chainstring RequiredProvider chain identifier from List market chains.Examplesolana
Returns 200 OK · application/json
-
chainstringProvider chain identifier. -
throughstringLatest day with data. -
daysarray<string>Days of the series (YYYY-MM-DD). -
txnsarray<number>Transactions per day. -
active_walletsarray<number>Active wallets per day. -
dex_volume_usdarray<number>DEX volume in USD per day. -
dex_tradesarray<number>DEX trades per day.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain is empty, longer than 64 characters, or has characters other than letters, digits, ., - and _. Use a chain ID from List market chains. |
| 404 | not_found | The data provider has no data for this chain. Use a chain ID from List market chains. |
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getChain(chain) src/lib/proxima/endpoints/market.ts
List launchpad activity
/market/launchpads Returns daily volume and tokens launched for every covered launchpad.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
All series share the top-level days axis.
Parameters
No parameters.
Returns 200 OK · application/json
-
throughstringLatest day with data. -
daysarray<string>Days shared by every series (YYYY-MM-DD). -
seriesarray<object>One series per launchpad.Child attributes 4
-
chainstringProvider chain identifier. -
padstringProvider launchpad identifier, e.g.pumpfun,letsbonk,ponsfamily.com. -
volume_usdarray<number>Volume in USD per day. -
tokens_launchedarray<number>Tokens created per day.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getLaunchpads() src/lib/proxima/endpoints/market.ts
Retrieve launchpad activity
/market/launchpads/{chain}/{pad} Returns daily tokens launched, volume and trades for one launchpad.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Called when a launchpad is selected in the Market Overview panel.
Path parameters
-
chainstring RequiredProvider chain identifier.Examplesolana -
padstring RequiredProvider launchpad identifier. URL-encoded by the SDK.Examplepumpfun
Returns 200 OK · application/json
-
chainstringProvider chain identifier. -
padstringProvider launchpad identifier. -
dailyarray<object>One entry per day.Child attributes 4
-
daystringDay (YYYY-MM-DD). -
tokens_launchednumberTokens created that day. -
volume_usdnumberVolume in USD. -
trade_txnsnumberTrade transactions.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain or pad is empty, longer than 64 characters, or has characters other than letters, digits, ., - and _. Use an identifier from List market chains or List launchpad activity. |
| 404 | not_found | The data provider has no data for this launchpad. Use a launchpad from List launchpad activity. |
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getLaunchpad(chain, pad) src/lib/proxima/endpoints/market.ts
Retrieve launchpad revenue
/market/launchpads/{chain}/{pad}/revenue Returns daily protocol revenue, creator revenue and buybacks for one launchpad.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
chainstring RequiredProvider chain identifier.Examplesolana -
padstring RequiredProvider launchpad identifier. URL-encoded by the SDK.Examplepumpfun
Returns 200 OK · application/json
-
dailyarray<object>One entry per day. Empty when the launchpad has no revenue coverage.Child attributes 4
-
daystringDay (YYYY-MM-DD). -
protocol_revenue_usdnumberProtocol revenue in USD. -
creator_revenue_usdnumber | nullRevenue paid to token creators in USD, ornullwhen not tracked for this launchpad. -
buyback_usdnumber | nullBuybacks in USD, ornullwhen not tracked for this launchpad.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain or pad is empty, longer than 64 characters, or has characters other than letters, digits, ., - and _. Use an identifier from List market chains or List launchpad activity. |
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getLaunchpadRevenue(chain, pad) src/lib/proxima/endpoints/market.ts
Retrieve the trench score
/market/trench Returns today's trench score with its band, and the daily score history.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
The score runs from 0 to 100. The app labels its ends Ded and Euphoric and colors the bands ded, cold, active, hot and euphoric.
Parameters
No parameters.
Returns 200 OK · application/json
-
todayobject | nullLatest score, ornullwhen none is available.Child attributes 3
-
daystringDay of the score (YYYY-MM-DD). -
scorenumberScore from 0 to 100. -
bandstringBand label, e.g.cold,active,hot.
-
-
historyarray<object>Past daily scores.Child attributes 2
-
daystringDay (YYYY-MM-DD). -
scorenumberScore from 0 to 100.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 422 | upstream_failure | tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.market.getTrench() src/lib/proxima/endpoints/market.ts