Skip to content

Market & search

Market overview, token lists by category and search.

Discovery endpoints: aggregate Ethereum-ecosystem numbers, ranked token lists and search. Market lists are Ethereum mainnet data from CoinGecko, GeckoTerminal and DexScreener; Stargaze launches come from contract events on the requested chain.

GET /api/market/overview

GET/api/market/overview

Ethereum-ecosystem totals from CoinGecko plus Stargaze platform counters from contract events. Server cache: 60 s (mk:overview:{chainId}).

QueryTypeDefaultDescription
chainId1 or 11155111deployment defaultChain for the platform counters. ethereum is always mainnet.
hooks/useMarket.ts
type Overview = {  ethereum: {    marketCap: number | null;     // CoinGecko "ethereum-ecosystem" category    volume24h: number | null;    change24h: number | null;     // market-cap change, percent    tokensTracked: number | null; // unique addresses across the market lists  };  platform: {    configured: boolean;          // a factory or fair-launch address is set    chainId: number;    totalLaunches: number | null; // null when not configured    launchesToday: number | null; // last 24 h    activeLaunches: number | null; // fair sales not finalized and not ended  };};
200 OK
{  "data": {    "ethereum": { "marketCap": 512340000000, "volume24h": 21870000000, "change24h": -1.42, "tokensTracked": 731 },    "platform": { "configured": true, "chainId": 11155111, "totalLaunches": 12, "launchesToday": 1, "activeLaunches": 0 }  },  "updatedAt": 1731974400000,  "stale": false,  "source": "CoinGecko, GeckoTerminal, Stargaze events"}

GET /api/market/tokens

GET/api/market/tokens?category={category}

A ranked list of TokenRow objects. An unknown category returns 400 with "error": "Unknown category".

QueryTypeDefaultDescription
categorysee belowtrendingWhich list to return.
chainId1 or 11155111deployment defaultOnly used by launched.
categorySourceWhat it isServer TTL
trendingGeckoTerminalTrending Ethereum pools (page 1), one row per base token, quote assets (WETH, USDC, USDT, DAI) excluded.120 s
newGeckoTerminalNewest Ethereum pools (page 1).60 s
liquidityGeckoTerminalTop pools by 24h volume (2 pages), re-sorted by liquidity.180 s
volumeCoinGecko + DexScreenerEthereum-ecosystem ERC-20s by 24h volume (top 150) with DexScreener liquidity, txns, 1h change and pool.120 s
gainersCoinGecko + DexScreener24h volume ≥ $100k and a known 24h change, sorted by change descending (top 60).120 s
losersCoinGecko + DexScreenerSame filter, sorted ascending (top 60).120 s
launchedStargaze eventsThe 100 newest Stargaze launches on chainId; on mainnet merged with DexScreener market data.30 s (index)
graduated—Always []. The bonding curve is not enabled, so nothing can graduate.—

CoinGecko rows only include coins that have a verifiable Ethereum contract address; logos are upgraded from CoinGecko and the Uniswap token list by address, never by symbol.

200 OK
{  "data": [    {      "chainId": 1,      "address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",      "name": "Uniswap",      "symbol": "UNI",      "logo": "https://coin-images.coingecko.com/…",      "priceUsd": 7.41,      "change1h": 0.3,      "change24h": 4.8,      "marketCap": 4450000000,      "fdv": 7410000000,      "liquidity": 18200000,      "volume24h": 96000000,      "txns24h": 2140,      "createdAt": 1600106585000,      "poolAddress": "0x…",      "dex": "uniswap",      "listed": true,      "source": "coingecko"    }  ],  "updatedAt": 1731974400000,  "stale": false,  "source": "CoinGecko + DexScreener"}
GET/api/search?q={query}Ethereum mainnet only
QueryTypeDescription
qstringName, symbol or contract address. Trimmed and cut to 64 characters. Fewer than 2 characters returns { "data": [] }.
  • Local matches from the CoinGecko Ethereum market list: exact address, exact symbol (case-insensitive) or name substring.
  • Remote matches from DexScreener search: Ethereum pairs only, the highest-liquidity pair per base token.
  • Results are merged by address only and capped at 20 TokenRows.
  • If q is a valid address that neither source knows, one placeholder row is returned: name: "Unknown token", symbol: "?", source: "onchain", all metrics null.
  • Provider failures are swallowed per source; the response is { data, updatedAt } without stale / source. DexScreener search results are cached for 60 s per query.