---
title: "Get Meme Regime"
method: GET
path: "/api/v1/meme/regime"
tags: ["Meme Regime"]
---

# Get Meme Regime

`GET /api/v1/meme/regime`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/meme/regime`
- Auth: API key in header `X-API-Key`

Per-asset Meme / Speculative regime across the curated meme universe.

Each asset is classified into one of ``euphoric``, ``distribution``,
``ignition``, ``bleeding``, or ``dormant`` from trailing returns, a
volume-spike ratio, 30d realized-vol percentile, SMA-20 extension, and live
Hyperliquid funding. Aimed at systematic perps trading: the label implies a
holding duration, leverage level, and funding-cost tolerance.

**Partly backfillable** — price/volume/vol features replay from daily klines;
the ``meme.funding_rate`` / ``meme.oi_usd`` fields are live-only and land
null on historically backfilled days (so ``distribution`` only appears live).

Example screens: `?regime=ignition&sort=vol_spike` (early movers),
`?regime=euphoric&sort=ret_7d` (hottest blow-offs), `?regime=bleeding`
(unwinds to avoid).

## Query parameters

- `source` 'binance_spot' | 'hyperliquid_perp', nullable
- `regime` 'euphoric' | 'distribution' | 'ignition' | 'bleeding' | 'dormant', nullable: Filter by meme regime
- `sort` 'symbol' | 'ret_7d' | 'ret_30d' | 'vol_spike' | 'vol_pctile_30' | 'sma20_extension_pct' | 'funding_rate' | 'oi_usd'
- `order` 'asc' | 'desc'
- `limit` integer

## Response `200`

Successful Response

- MemeRegimeResponse
  - `items` MemeRegimeItem[], required
    - `symbol` string, required
    - `source` 'binance_spot' | 'hyperliquid_perp', required
    - `price` number, required
    - `regime` 'euphoric' | 'distribution' | 'ignition' | 'bleeding' | 'dormant', required
    - `hl_symbol` string, nullable
    - `meme` MemeMetricsModel, required
      - `ret_1d` number, nullable
      - `ret_7d` number, nullable
      - `ret_30d` number, nullable
      - `ret_90d` number, nullable
      - `vol_spike` number, nullable
      - `rv_gk_30` number, nullable
      - `vol_pctile_30` number, nullable
      - `sma20_extension_pct` number, nullable
      - `funding_rate` number, nullable
      - `funding_extreme` boolean
      - `oi_usd` number, nullable
      - `days_in_regime` integer
      - `prev_regime` 'euphoric' | 'distribution' | 'ignition' | 'bleeding' | 'dormant', nullable
      - `regime_changed` boolean
  - `count` integer, required
  - `universe_size` integer, required
  - `timestamp` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)