cryptodataapi-com Meme Regime API

openapi: 3.2.0
info:
  title: Crypto Data Meme Regime API
  description: 'Real-time crypto market intelligence API. Built for AI agents: gasless USDC payments via x402 protocol, one-call onboarding, and 180+ endpoints for prices, derivatives, funding, and sentiment.'
  version: '2026-10-28'
servers:
- url: https://cryptodataapi.com
tags:
- name: Meme Regime
  description: Meme/speculative lifecycle regimes and the market-wide hype score.
paths:
  /api/v1/meme/regime:
    get:
      tags:
      - Meme Regime
      summary: Get Meme Regime
      description: '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).'
      operationId: get_meme_regime_api_v1_meme_regime_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: source
        in: query
        required: false
        schema:
          title: Source
          enum:
          - binance_spot
          - hyperliquid_perp
          - null
          type:
          - string
          - 'null'
      - name: regime
        in: query
        required: false
        schema:
          description: Filter by meme regime
          title: Regime
          enum:
          - euphoric
          - distribution
          - ignition
          - bleeding
          - dormant
          - null
          type:
          - string
          - 'null'
        description: Filter by meme regime
      - name: sort
        in: query
        required: false
        schema:
          enum:
          - symbol
          - ret_7d
          - ret_30d
          - vol_spike
          - vol_pctile_30
          - sma20_extension_pct
          - funding_rate
          - oi_usd
          type: string
          default: ret_7d
          title: Sort
      - name: order
        in: query
        required: false
        schema:
          enum:
          - asc
          - desc
          type: string
          default: desc
          title: Order
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 250
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemeRegimeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/meme/regime/score:
    get:
      tags:
      - Meme Regime
      summary: Get Meme Regime Score
      description: 'Market-wide meme-hype composite (0-100) + sentiment + regime mix.


        Higher score = frothier / more speculative heat. Sentiment bands: euphoric

        (≥70), heating (55-69), neutral (45-54), cooling (30-44), dormant (<30).

        Carries the cross-meme co-movement correlation and a ``meme_season`` flag

        (broad heating + correlated pack move). Trimmed companion to ``/meme/regime``

        — no per-coin list.'
      operationId: get_meme_regime_score_api_v1_meme_regime_score_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemeRegimeScoreResponse'
      security:
      - APIKeyHeader: []
  /api/v1/meme/regime/{symbol}:
    get:
      tags:
      - Meme Regime
      summary: Get Meme Regime Symbol
      description: 'Per-asset Meme regime detail with 60d daily history (Pro+).


        `history` contains compact daily bars (close, 30d Garman-Klass vol) suitable

        for sparkline rendering.


        Hyperliquid thousand-unit tickers (``kBONK``, ``kPEPE``, ``kSHIB``) are

        accepted as aliases of the plain symbol.'
      operationId: get_meme_regime_symbol_api_v1_meme_regime__symbol__get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: path
        required: true
        schema:
          type: string
          title: Symbol
        example: DOGE
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemeRegimeDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/meme/regime/refresh:
    post:
      tags:
      - Meme Regime
      summary: Refresh Meme Regime
      description: Force recompute the Meme regime cache (Pro+).
      operationId: refresh_meme_regime_api_v1_meme_regime_refresh_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MemeRegimeRefreshResponse'
      security:
      - APIKeyHeader: []
components:
  schemas:
    MemeRegimeDetailResponse:
      properties:
        symbol:
          type: string
          title: Symbol
        source:
          type: string
          enum:
          - binance_spot
          - hyperliquid_perp
          title: Source
        price:
          type: number
          title: Price
        regime:
          type: string
          enum:
          - euphoric
          - distribution
          - ignition
          - bleeding
          - dormant
          title: Regime
        hl_symbol:
          title: Hl Symbol
          type:
          - string
          - 'null'
        meme:
          $ref: '#/components/schemas/MemeMetricsModel'
        history:
          items:
            $ref: '#/components/schemas/MemeHistoryEntry'
          type: array
          title: History
          default: []
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
      - symbol
      - source
      - price
      - regime
      - meme
      - timestamp
      title: MemeRegimeDetailResponse
    MemeRegimeRefreshResponse:
      properties:
        refreshed:
          type: boolean
          title: Refreshed
        count:
          type: integer
          title: Count
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
      - refreshed
      - count
      - timestamp
      title: MemeRegimeRefreshResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    MemeRegimeItem:
      properties:
        symbol:
          type: string
          title: Symbol
        source:
          type: string
          enum:
          - binance_spot
          - hyperliquid_perp
          title: Source
        price:
          type: number
          title: Price
        regime:
          type: string
          enum:
          - euphoric
          - distribution
          - ignition
          - bleeding
          - dormant
          title: Regime
        hl_symbol:
          title: Hl Symbol
          type:
          - string
          - 'null'
        meme:
          $ref: '#/components/schemas/MemeMetricsModel'
      type: object
      required:
      - symbol
      - source
      - price
      - regime
      - meme
      title: MemeRegimeItem
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    MemeRegimeResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/MemeRegimeItem'
          type: array
          title: Items
        count:
          type: integer
          title: Count
        universe_size:
          type: integer
          title: Universe Size
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
      - items
      - count
      - universe_size
      - timestamp
      title: MemeRegimeResponse
    MemeMetricsModel:
      properties:
        ret_1d:
          title: Ret 1D
          type:
          - number
          - 'null'
        ret_7d:
          title: Ret 7D
          type:
          - number
          - 'null'
        ret_30d:
          title: Ret 30D
          type:
          - number
          - 'null'
        ret_90d:
          title: Ret 90D
          type:
          - number
          - 'null'
        vol_spike:
          title: Vol Spike
          type:
          - number
          - 'null'
        rv_gk_30:
          title: Rv Gk 30
          type:
          - number
          - 'null'
        vol_pctile_30:
          title: Vol Pctile 30
          type:
          - number
          - 'null'
        sma20_extension_pct:
          title: Sma20 Extension Pct
          type:
          - number
          - 'null'
        funding_rate:
          title: Funding Rate
          type:
          - number
          - 'null'
        funding_extreme:
          type: boolean
          title: Funding Extreme
          default: false
        oi_usd:
          title: Oi Usd
          type:
          - number
          - 'null'
        days_in_regime:
          type: integer
          title: Days In Regime
          default: 0
        prev_regime:
          title: Prev Regime
          type:
          - string
          - 'null'
          enum:
          - euphoric
          - distribution
          - ignition
          - bleeding
          - dormant
          - null
        regime_changed:
          type: boolean
          title: Regime Changed
          default: false
      type: object
      title: MemeMetricsModel
    MemeRegimeScoreResponse:
      properties:
        as_of:
          type: string
          title: As Of
        composite_score:
          type: number
          title: Composite Score
        sentiment:
          type: string
          title: Sentiment
        breadth_heating_pct:
          type: number
          title: Breadth Heating Pct
          default: 0.0
        mean_pairwise_correlation:
          title: Mean Pairwise Correlation
          type:
          - number
          - 'null'
        meme_season:
          type: boolean
          title: Meme Season
          default: false
        median_funding_rate:
          title: Median Funding Rate
          type:
          - number
          - 'null'
        fresh_issuance:
          title: Fresh Issuance
          description: 'Live-only fresh-issuance froth gauge (DEX-promotion breadth/spend + GoPlus rug density): froth_score, promoted_count, total_promotion_spend, rug_sampled, rug_high_risk_pct, avg_security_score. Null if unavailable.'
          additionalProperties: true
          type:
          - object
          - 'null'
        aggregate:
          additionalProperties: true
          type: object
          title: Aggregate
          description: Regime counts + pct shares across the tracked meme universe
      type: object
      required:
      - as_of
      - composite_score
      - sentiment
      title: MemeRegimeScoreResponse
      description: Trimmed composite-only companion to /meme/regime.
    MemeHistoryEntry:
      properties:
        date:
          type: string
          title: Date
        close:
          type: number
          title: Close
        rv_gk_30:
          title: Rv Gk 30
          type:
          - number
          - 'null'
      type: object
      required:
      - date
      - close
      title: MemeHistoryEntry
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key