Skip to main content
The Memecoins endpoint tracks grouped meme categories across aggregate, theme, chain, and launchpad views, with market cap, volume, historical time-series data, and a new-launch feed. Use it to monitor sector rotation across memecoin themes.

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

string
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.
string
Time window for historical snapshot data. One of 24h, 7d, 30d, or 1y. Returns regularized time-series of market cap and volume per narrative.
string
In narrative detail mode, set to 24h, 7d, 1m, or 1y to return top-coin price history for index charts.

Response fields

array
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%.
number
Authoritative all-memes market cap in USD. This is not the sum of overlapping narrative rows.
string
ISO 8601 timestamp of the last complete source cache. A degraded refresh that reuses prior data does not advance this timestamp.
string
Optional ISO 8601 timestamp of the latest sync attempt, including a degraded partial attempt.
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, and returnCoverageShare (per window, the share of return-eligible constituents with a return, 0 to 1) so stale or partial coverage is visible to API users.
  • totalMemeMcap uses the authoritative all-memes aggregate instead of summing overlapping category rows.
  • A narrative’s return1h … return1y are market-cap-weighted constituent price returns, as fractions (calculationMethod.returns is market_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 … medianReturn1y are the median return of the same constituents, one coin one vote (calculationMethod.medianReturns). A row cached before 2026-09-30 still says median_constituent_price_change_min_500k_mcap, carries medians in return* and has no medianReturn* until the next 6-hourly sync rewrites it.
  • Return fields preserve missing upstream values as null; a real 0 return is not the same as unavailable data.
  • momentumReturn is short_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=1y and coinHistory=1y return 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

array
The full list of narratives (same as the overview response).
number
Total memecoin market cap across all narratives in USD.
array
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
Array of market cap values representing the narrative’s market cap over time (from snapshot history).
string
ISO 8601 timestamp of the last complete source cache.
string
Optional ISO 8601 timestamp of the latest sync attempt.
Response
See error reference

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
Array of snapshot objects with narrative_id, market_cap, volume_24h, and snapshot_at (ISO 8601). Ordered by time ascending.
array
The full list of narratives (same as the overview response).
number
Current total memecoin market cap in USD.
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

string
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.
integer
Launch age window from 1 to 30 days. Defaults to 7.
integer
Number of rows to return from 1 to 200. Defaults to 80.
string
Screening profile: discovery, balanced, or strict. Defaults to balanced.

Response fields

array
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.
string
ISO 8601 timestamp for the scan.
object
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.