> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sharpe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Memecoins API

> Retrieve memecoin narrative data including market caps, volumes, historical snapshots, and per-narrative coin breakdowns.

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

**narrative** `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.

**historical** `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.

**coinHistory** `string`

In narrative detail mode, set to `24h`, `7d`, `1m`, or `1y` to return top-coin price history for index charts.

### Response fields

**narratives** `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%.

**totalMemeMcap** `number`

Authoritative all-memes market cap in USD. This is not the sum of overlapping narrative rows.

**updatedAt** `string`

ISO 8601 timestamp of the last complete source cache. A degraded refresh that reuses prior data does not advance this timestamp.

**lastAttemptedAt** `string`

Optional ISO 8601 timestamp of the latest sync attempt, including a degraded partial attempt.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here"
```

```ts TypeScript theme={null}
const res = await fetch('https://www.sharpe.ai/api/v1/memecoins/data', {
  headers: { Authorization: 'Bearer sk_live_your_key_here' },
})
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/memecoins/data",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "data": {
    "narratives": [
      {
        "id": "dog-themed-coins",
        "name": "Dog Coins",
        "emoji": "🐶",
        "slug": "dog-coins",
        "marketCap": 28500000000,
        "volume24h": 1240000000,
        "return1h": 0.0085,
        "return24h": 0.0342,
        "return7d": -0.0128,
        "return30d": 0.152,
        "return200d": 0.421,
        "return1y": 0.953,
        "marketShare": 0.459,
        "topCoin": {
          "symbol": "DOGE",
          "image": "https://...",
          "price": 0.164,
          "return24h": 0.0421
        },
        "coinCount": 38,
        "momentumReturn": 0.018
      }
    ],
    "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 `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

**narratives** `array`

The full list of narratives (same as the overview response).

**totalMemeMcap** `number`

Total memecoin market cap across all narratives in USD.

**coins** `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.

**sparkline** `array`

Array of market cap values representing the narrative's market cap over time (from snapshot history).

**updatedAt** `string`

ISO 8601 timestamp of the last complete source cache.

**lastAttemptedAt** `string`

Optional ISO 8601 timestamp of the latest sync attempt.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d narrative=dog-coins
```

```ts TypeScript theme={null}
const res = await fetch(
  'https://www.sharpe.ai/api/v1/memecoins/data?narrative=dog-coins',
  {
    headers: { Authorization: 'Bearer sk_live_your_key_here' },
  },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/memecoins/data",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    params={"narrative": "dog-coins"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "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,
        "return1h": 0.0052,
        "return24h": 0.0421,
        "return7d": -0.011,
        "return30d": 0.184,
        "return200d": 0.352,
        "return1y": 0.805,
        "marketCap": 22000000000,
        "fdv": 22000000000,
        "volume24h": 890000000,
        "sparkline": [0.155, 0.158, 0.160, 0.164],
        "athPrice": 0.7376,
        "fromAth": -0.7777,
        "atlPrice": 0.0000869,
        "fromAtl": 1886,
        "circSupply": 148000000000,
        "maxSupply": null,
        "circulatingShare": 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](https://docs.sharpe.ai/errors.md)

***

## 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

**snapshots** `array`

Array of snapshot objects with `narrative_id`, `market_cap`, `volume_24h`, and `snapshot_at` (ISO 8601). Ordered by time ascending.

**narratives** `array`

The full list of narratives (same as the overview response).

**totalMemeMcap** `number`

Current total memecoin market cap in USD.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/memecoins/data \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d historical=24h
```

```ts TypeScript theme={null}
const res = await fetch(
  'https://www.sharpe.ai/api/v1/memecoins/data?historical=24h',
  {
    headers: { Authorization: 'Bearer sk_live_your_key_here' },
  },
)
const { data } = await res.json()
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://www.sharpe.ai/api/v1/memecoins/data",
    headers={"Authorization": "Bearer sk_live_your_key_here"},
    params={"historical": "24h"},
)
data = resp.json()["data"]
```

```json Response theme={null}
{
  "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
  }
}
```

***

## 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

**chains** `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.

**days** `integer`

Launch age window from 1 to 30 days. Defaults to `7`.

**limit** `integer`

Number of rows to return from 1 to 200. Defaults to `80`.

**profile** `string`

Screening profile: `discovery`, `balanced`, or `strict`. Defaults to `balanced`.

### Response fields

**rows** `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.

**scannedAt** `string`

ISO 8601 timestamp for the scan.

**coverage** `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.

```bash cURL theme={null}
curl -G https://www.sharpe.ai/api/v1/memecoins/launches \
  -H "Authorization: Bearer sk_live_your_key_here" \
  -d chains=solana,bsc \
  -d profile=balanced
```

```ts TypeScript theme={null}
const res = await fetch('https://www.sharpe.ai/api/v1/memecoins/launches', {
  headers: { Authorization: 'Bearer sk_live_your_key_here' },
})
const { data } = await res.json()
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.