Memecoins

The Memecoins endpoint provides narrative intelligence for the memecoin sector — tracking 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.

GET/v1/memecoins/data

List narratives

Returns all memecoin narratives with their current market caps and 24h volumes. Omit all query parameters to get the overview.

Query parameters

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

Response fields

Name
narratives
Type
array
Description
Array of narrative objects. Each includes: id, name, emoji, slug, group, marketCap, volume24h, marketSharePct, nullable return fields, topCoin, coinCount, trackedCoinCount, coverageLimit, dominance, momentum, momentumKind, calculationMethod, returnCoverage, and freshness.
Name
totalMemeMcap
Type
number
Description
Authoritative all-memes market cap in USD. This is not the sum of overlapping narrative rows.
Name
updatedAt
Type
string
Description
ISO 8601 timestamp of the last data refresh.

Request

GET

/v1/memecoins/data

curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here"

Response

{
  "data": {
    "narratives": [
      {
        "id": "dog-themed-coins",
        "name": "Dog Coins",
        "emoji": "🐶",
        "slug": "dog-coins",
        "marketCap": 28500000000,
        "volume24h": 1240000000,
        "change1h": 0.85,
        "change24h": 3.42,
        "change7d": -1.28,
        "change30d": 15.20,
        "change200d": 42.10,
        "change1y": 95.30,
        "topCoin": {
          "symbol": "DOGE",
          "image": "https://...",
          "price": 0.164,
          "change24h": 4.21
        },
        "coinCount": 38,
        "dominance": 45.9,
        "momentum": 1.82
      }
    ],
    "totalMemeMcap": 62000000000,
    "updatedAt": "2026-03-28T12:00:00Z"
  },
  "meta": {
    "request_id": "req_abc123def456ghij",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

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 returnCoverage so stale or partial coverage is visible to API users.
totalMemeMcap uses the authoritative all-memes aggregate instead of summing overlapping category rows.
Return fields preserve missing upstream values as null; a real 0.00% return is not the same as unavailable data.
momentum is short_term_price_momentum, computed from weighted 1h/24h/7d constituent price movement. 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.

GET/v1/memecoins/data?narrative=dog-coins

Narrative detail

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

Name
narratives
Type
array
Description
The full list of narratives (same as the overview response).
Name
totalMemeMcap
Type
number
Description
Total memecoin market cap across all narratives in USD.
Name
coins
Type
array
Description
Top coins in the requested narrative. Each coin includes id, name, symbol, image, price, change1h, change24h, change7d, change30d, change200d, change1y, marketCap, fdv, volume24h, sparkline, athPrice, athPercent, atlPrice, atlPercent, circSupply, maxSupply, supplyRatio, volMcap.
Name
sparkline
Type
array
Description
Array of market cap values representing the narrative's market cap over time (from snapshot history).
Name
updatedAt
Type
string
Description
ISO 8601 timestamp of the last data refresh.

Request

GET

/v1/memecoins/data?narrative=dog-coins

curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d narrative=dog-coins

Response

{
  "data": {
    "narratives": ["...same as list mode..."],
    "totalMemeMcap": 62000000000,
    "updatedAt": "2026-03-28T12:00:00Z",
    "coins": [
      {
        "id": "dogecoin",
        "name": "Dogecoin",
        "symbol": "DOGE",
        "image": "https://...",
        "price": 0.164,
        "change1h": 0.52,
        "change24h": 4.21,
        "change7d": -1.10,
        "change30d": 18.40,
        "change200d": 35.20,
        "change1y": 80.50,
        "marketCap": 22000000000,
        "fdv": 22000000000,
        "volume24h": 890000000,
        "sparkline": [0.155, 0.158, 0.160, 0.164],
        "athPrice": 0.7376,
        "athPercent": -77.77,
        "atlPrice": 0.0000869,
        "atlPercent": 188600.0,
        "circSupply": 148000000000,
        "maxSupply": null,
        "supplyRatio": null,
        "volMcap": 0.0405
      }
    ],
    "sparkline": [28300000000, 28500000000, 28100000000]
  },
  "meta": {
    "request_id": "req_def456ghi789jklm",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

See error reference

GET/v1/memecoins/data?historical=24h

Historical snapshots

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

Name
snapshots
Type
array
Description
Array of snapshot objects with narrative_id, market_cap, volume_24h, and snapshot_at (ISO 8601). Ordered by time ascending.
Name
narratives
Type
array
Description
The full list of narratives (same as the overview response).
Name
totalMemeMcap
Type
number
Description
Current total memecoin market cap in USD.

Request

GET

/v1/memecoins/data?historical=24h

curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d historical=24h

Response

{
  "data": {
    "narratives": [ "..." ],
    "totalMemeMcap": 62000000000,
    "updatedAt": "2026-03-28T12:00:00Z",
    "snapshots": [
      {
        "narrative_id": "dog-themed-coins",
        "market_cap": 28100000000,
        "volume_24h": 1180000000,
        "snapshot_at": "2026-03-27T12:00:00Z"
      },
      {
        "narrative_id": "dog-themed-coins",
        "market_cap": 28500000000,
        "volume_24h": 1240000000,
        "snapshot_at": "2026-03-28T12:00:00Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_ghi789jkl012mnop",
    "timestamp": "2026-03-28T12:00:05Z",
    "elapsed_ms": 12
  }
}

GET/v1/memecoins/launches

New launches

Returns recently launched memecoin pairs screened by age, liquidity, volume, and transaction count. This feed is a discovery list, not a full contract-security verdict.

Query parameters

Name
chains
Type
string
Description
Comma-separated chain ids. Defaults to solana,base,bsc,ethereum.
Name
days
Type
integer
Description
Launch age window from 1 to 30 days. Defaults to 7.
Name
limit
Type
integer
Description
Number of rows to return from 1 to 200. Defaults to 80.
Name
profile
Type
string
Description
Screening profile: discovery, balanced, or strict. Defaults to balanced.

Response fields

Name
rows
Type
array
Description
Launch rows with chain, symbol, token address, pair address, price, 1h/24h change, 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.
Name
scannedAt
Type
string
Description
ISO 8601 timestamp for the scan.

Request

GET

/v1/memecoins/launches

curl -G https://www.sharpe.ai/api/v1/memecoins/launches \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d chains=solana,base,bsc,ethereum \
  -d profile=balanced