Memecoins

The Memecoins endpoint provides narrative intelligence for the memecoin sector — tracking 17 curated narratives (Dog, Cat, Frog, AI, Political, Solana, Base, Bitcoin, BNB, Chinese, TikTok, Parody, Country, Celebrity, IP, and an "all memes" aggregate) with market cap, volume, and historical time-series data. Use it to monitor sector rotation across memecoin themes.

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 or 7d. Returns regularized time-series of market cap and volume per narrative.

Response fields

Name
narratives
Type
array
Description
Array of narrative objects. Each includes: id, name, emoji, slug, marketCap, volume24h, change1h, change24h, change7d, change30d, change200d, change1y, topCoin (object with symbol, image, price, change24h), coinCount, dominance, momentum.
Name
totalMemeMcap
Type
number
Description
Total memecoin market cap across all narratives in USD.
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"

{
  "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"
  }
}

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

{
  "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"
  }
}

See error reference

Historical snapshots

Pass historical=24h or historical=7d 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

{
  "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"
  }
}