Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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

Bearer JWT
GET /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

  • chains array<object>
    Covered chains.
    Child attributes 3
    • chain string
      Provider chain identifier, e.g. solana, bnb, ethereum, base.
    • display_name string
      Human-readable chain name.
    • through string
      Latest day with data (YYYY-MM-DD).

Errors

StatusCodeWhen 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

GET /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

Returns 200 OK · application/json

  • chain string
    Provider chain identifier.
  • through string
    Latest day with data.
  • days array<string>
    Days of the series (YYYY-MM-DD).
  • txns array<number>
    Transactions per day.
  • active_wallets array<number>
    Active wallets per day.
  • dex_volume_usd array<number>
    DEX volume in USD per day.
  • dex_trades array<number>
    DEX trades per day.

Errors

StatusCodeWhen 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

GET /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

  • through string
    Latest day with data.
  • days array<string>
    Days shared by every series (YYYY-MM-DD).
  • series array<object>
    One series per launchpad.
    Child attributes 4
    • chain string
      Provider chain identifier.
    • pad string
      Provider launchpad identifier, e.g. pumpfun, letsbonk, ponsfamily.com.
    • volume_usd array<number>
      Volume in USD per day.
    • tokens_launched array<number>
      Tokens created per day.

Errors

StatusCodeWhen 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

GET /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

  • chain string Required
    Provider chain identifier.
    Examplesolana
  • pad string Required
    Provider launchpad identifier. URL-encoded by the SDK.
    Examplepumpfun

Returns 200 OK · application/json

  • chain string
    Provider chain identifier.
  • pad string
    Provider launchpad identifier.
  • daily array<object>
    One entry per day.
    Child attributes 4
    • day string
      Day (YYYY-MM-DD).
    • tokens_launched number
      Tokens created that day.
    • volume_usd number
      Volume in USD.
    • trade_txns number
      Trade transactions.

Errors

StatusCodeWhen 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

GET /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

  • chain string Required
    Provider chain identifier.
    Examplesolana
  • pad string Required
    Provider launchpad identifier. URL-encoded by the SDK.
    Examplepumpfun

Returns 200 OK · application/json

  • daily array<object>
    One entry per day. Empty when the launchpad has no revenue coverage.
    Child attributes 4
    • day string
      Day (YYYY-MM-DD).
    • protocol_revenue_usd number
      Protocol revenue in USD.
    • creator_revenue_usd number | null
      Revenue paid to token creators in USD, or null when not tracked for this launchpad.
    • buyback_usd number | null
      Buybacks in USD, or null when not tracked for this launchpad.

Errors

StatusCodeWhen 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

GET /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

  • today object | null
    Latest score, or null when none is available.
    Child attributes 3
    • day string
      Day of the score (YYYY-MM-DD).
    • score number
      Score from 0 to 100.
    • band string
      Band label, e.g. cold, active, hot.
  • history array<object>
    Past daily scores.
    Child attributes 2
    • day string
      Day (YYYY-MM-DD).
    • score number
      Score from 0 to 100.

Errors

StatusCodeWhen 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