List narratives
GET /v1/memecoins/data
Returns all memecoin narratives with their current market caps and 24h volumes. Omit all query parameters to get the overview.
Query parameters
A narrative identifier or slug (for example
dog-themed-coins or dog-coins). When provided, returns detailed coin-level data for that narrative including a sparkline and top coins.Time window for historical snapshot data. One of
24h, 7d, 30d, or 1y. Returns regularized time-series of market cap and volume per narrative.In narrative detail mode, set to
24h, 7d, 1m, or 1y to return top-coin price history for index charts.Response fields
Array of narrative objects. Each includes:
id, name, emoji, slug, group, marketCap, volume24h, marketShare (the category’s share of the All Memes market cap, 0 to 1; null when that market cap is unavailable), the nullable returns return1h … return1y and medianReturn1h … medianReturn1y, topCoin, coinCount, trackedCoinCount, coverageLimit, momentumReturn, momentumKind, calculationMethod, returnCoverageShare, and freshness. Returns and shares are fractions: 0.0342 is 3.42%.ISO 8601 timestamp of the last complete source cache. A degraded refresh that reuses prior data does not advance this timestamp.
Response
Freshness, coverage, and limitations
- Current narrative data is sourced from CoinGecko category market data and cached by Sharpe. Each narrative row exposes
freshness,trackedCoinCount,coverageLimit,calculationMethod, andreturnCoverageShare(per window, the share of return-eligible constituents with a return, 0 to 1) so stale or partial coverage is visible to API users. totalMemeMcapuses the authoritative all-memes aggregate instead of summing overlapping category rows.- A narrative’s
return1h…return1yare market-cap-weighted constituent price returns, as fractions (calculationMethod.returnsismarket_cap_weighted_constituent_price_change_min_500k_mcap): Σ(market cap × return) / Σ(market cap) over constituents with at least $500K market cap and a price updated in the last 48 hours.medianReturn1h…medianReturn1yare the median return of the same constituents, one coin one vote (calculationMethod.medianReturns). A row cached before 2026-09-30 still saysmedian_constituent_price_change_min_500k_mcap, carries medians inreturn*and has nomedianReturn*until the next 6-hourly sync rewrites it. - Return fields preserve missing upstream values as
null; a real0return is not the same as unavailable data. momentumReturnisshort_term_price_momentum: 0.40 ×return1h+ 0.35 ×return24h+ 0.25 ×return7d(calculationMethod.momentum), the weights renormalised over the windows present, a fraction clamped to ±1. It is not a macro capital-flow metric.- The launch feed is discovery-first and can surface tokens before category membership exists. Canonical tracker inclusion still requires category membership or minimum liquidity, volume, age, and activity thresholds.
historical=1yandcoinHistory=1yreturn data only where retained snapshots exist; newer coins can have insufficient history.
Narrative detail
GET /v1/memecoins/data?narrative=dog-coins
When you pass a narrative identifier, the response includes the base narrative overview plus coin-level breakdowns and a sparkline for that narrative.
Response fields
Top coins in the requested narrative. Each coin includes
id, name, symbol, image, price, return1h, return24h, return7d, return30d, return200d, return1y, marketCap, fdv, volume24h, sparkline, athPrice, fromAth, atlPrice, fromAtl, circSupply, maxSupply, circulatingShare, volMcap. The returns, fromAth and fromAtl (the price against the ATH and ATL) and circulatingShare (circulating over max supply, 0 to 1) are fractions: -0.7777 is 77.77% below the ATH.Array of market cap values representing the narrative’s market cap over time (from snapshot history).
Response
Historical snapshots
GET /v1/memecoins/data?historical=24h
Pass historical=24h, historical=7d, historical=30d, or historical=1y to get time-series snapshots of market cap and volume per narrative. Data is regularized and despiked for clean charting.
Response fields
Array of snapshot objects with
narrative_id, market_cap, volume_24h, and snapshot_at (ISO 8601). Ordered by time ascending.Response
New launches
GET /v1/memecoins/launches
Returns recently launched tokens from recognized memecoin launchpads,
screened by age, liquidity, volume, and transaction count. Generic new DEX
pairs are excluded because recency alone is not evidence that a token is a
memecoin. This remains a discovery list, not a contract-security verdict.
Query parameters
Comma-separated chain ids. Defaults to
solana,bsc, the chains with a recognised meme launchpad (Pump.fun; Four.meme and Flap). Other chains return no rows.Response fields
Launch rows with chain, symbol, token address, pair address, price, 1h/24h return (
return1h, return24h, fractions: 0.125 is +12.5%), 24h volume, liquidity, market cap/FDV where available, transaction counts, age, inferred launchpad, migration state, holder/security signal source, screening status, risk flags, and canonical tracker ingestion eligibility.status is complete or partial; successfulChains and
failedChains identify scan coverage. classificationMethod is
recognized_meme_launchpad. The endpoint returns 503 when every
requested chain scanner fails.
