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/overviewEthereum-ecosystem totals from CoinGecko plus Stargaze platform counters from contract events. Server cache: 60 s (mk:overview:{chainId}).
| Query | Type | Default | Description |
|---|---|---|---|
chainId | 1 or 11155111 | deployment default | Chain for the platform counters. ethereum is always mainnet. |
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 };};{ "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".
| Query | Type | Default | Description |
|---|---|---|---|
category | see below | trending | Which list to return. |
chainId | 1 or 11155111 | deployment default | Only used by launched. |
| category | Source | What it is | Server TTL |
|---|---|---|---|
trending | GeckoTerminal | Trending Ethereum pools (page 1), one row per base token, quote assets (WETH, USDC, USDT, DAI) excluded. | 120 s |
new | GeckoTerminal | Newest Ethereum pools (page 1). | 60 s |
liquidity | GeckoTerminal | Top pools by 24h volume (2 pages), re-sorted by liquidity. | 180 s |
volume | CoinGecko + DexScreener | Ethereum-ecosystem ERC-20s by 24h volume (top 150) with DexScreener liquidity, txns, 1h change and pool. | 120 s |
gainers | CoinGecko + DexScreener | 24h volume ≥ $100k and a known 24h change, sorted by change descending (top 60). | 120 s |
losers | CoinGecko + DexScreener | Same filter, sorted ascending (top 60). | 120 s |
launched | Stargaze events | The 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.
{ "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
GET
/api/search?q={query}Ethereum mainnet only| Query | Type | Description |
|---|---|---|
q | string | Name, 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
qis a valid address that neither source knows, one placeholder row is returned:name: "Unknown token",symbol: "?",source: "onchain", all metricsnull. - Provider failures are swallowed per source; the response is
{ data, updatedAt }withoutstale/source. DexScreener search results are cached for 60 s per query.
