cryptodataapi-com Market-Moving News API

openapi: 3.2.0
info:
  title: Crypto Data Market-Moving News 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: Market-Moving News
paths:
  /api/v1/news/market-moving:
    get:
      tags:
      - Market-Moving News
      summary: Get Market Moving News
      description: 'The filtered catalyst tape — only events that cleared the impact threshold.


        Free: BTC / ETH / MARKET, last 24h, top 10. Pro: every HL perp, 7 days.

        Pro Plus: full retained history plus the `impact_score` components

        (`severity`, `confidence`, `match_mode`, `sources`) and the measured

        `market_response` at +15m / +1h / +4h.


        `bias` is signed: negative is risk-off. `corroboration` counts how many

        independent sources carried the same `(symbol, category)` inside the window —

        the strongest single indicator that a story is real rather than syndicated.'
      operationId: get_market_moving_news_api_v1_news_market_moving_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: query
        required: false
        schema:
          description: Filter to one Hyperliquid perp, or MARKET
          title: Symbol
          type:
          - string
          - 'null'
        description: Filter to one Hyperliquid perp, or MARKET
      - name: hours
        in: query
        required: false
        schema:
          type: number
          maximum: 336
          minimum: 1
          description: Lookback window in hours
          default: 24.0
          title: Hours
        description: Lookback window in hours
      - name: min_impact
        in: query
        required: false
        schema:
          type: number
          maximum: 1.0
          minimum: 0.0
          description: Minimum impact_score. Cannot go below the pipeline threshold.
          default: 0.45
          title: Min Impact
        description: Minimum impact_score. Cannot go below the pipeline threshold.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 500
          minimum: 1
          default: 50
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsEventsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/news/pulse:
    get:
      tags:
      - Market-Moving News
      summary: Get News Pulse
      description: 'Per-coin news feature series — `news_pressure` and signed `news_tilt`.


        The endpoint built for trading strategies: one row per Hyperliquid perp,

        cross-sectionally ranked, joinable straight onto price.


        - `news_pressure` (0..1) — recency-weighted sum of impact scores, saturating.

        - `news_tilt` (-1..+1) — impact-weighted direction. Negative is risk-off.

        - `event_count` / `top_impact` — how much of the pressure is one big story

        versus a steady drip.


        - `headlines` — raw coverage: how many stories in the current feed window

        name this coin at high confidence, whether or not any of them qualified as

        a catalyst. This is attention, not an event. The catalyst funnel discards

        ~95% of what it reads, so most coins sit at `news_pressure: 0` while

        `headlines` keeps counting; a coin high on headlines with no pressure is

        being talked about without anything happening.


        **Every active perp gets a row.** A coin with no news is `news_pressure: 0`,

        not a missing row — a cross-sectional ranking needs the zeros, and a silently

        absent symbol is indistinguishable from a pipeline failure. Rows are ranked

        by pressure first, then by `headlines`. Free tier gets the top 10 rows; Pro

        and above get the full universe.'
      operationId: get_news_pulse_api_v1_news_pulse_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: hours
        in: query
        required: false
        schema:
          type: number
          maximum: 168
          minimum: 1
          description: Lookback window in hours
          default: 24.0
          title: Hours
        description: Lookback window in hours
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsPulseResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/news/coin/{symbol}:
    get:
      tags:
      - Market-Moving News
      summary: Get Coin News
      description: 'Qualified events and news feature values for one Hyperliquid perp.


        Free tier is limited to BTC and ETH; Pro and above may query any perp. Pro

        Plus additionally receives the score components and the measured

        `market_response` per window.'
      operationId: get_coin_news_api_v1_news_coin__symbol__get
      security:
      - APIKeyHeader: []
      parameters:
      - name: symbol
        in: path
        required: true
        schema:
          type: string
          title: Symbol
        example: BTC
      - name: hours
        in: query
        required: false
        schema:
          type: number
          maximum: 336
          minimum: 1
          default: 72.0
          title: Hours
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsCoinResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/news/sources:
    get:
      tags:
      - Market-Moving News
      summary: Get News Sources
      description: 'Per-feed health, the funnel counts, and the published coverage gap.


        `sources[].not_modified` distinguishes "answered 304, nothing new" from

        "dead" — both look like zero fresh items otherwise, which is how a silently

        broken feed hides.


        `funnel_24h` is hourly counts only (`ingested`, `dropped_noise`,

        `dropped_no_catalyst`, `dropped_no_entity`, `dropped_below_threshold`,

        `qualified`) with no titles or URLs. It exists so the filter can be seen over-tightening and swallowing

        real catalysts, without keeping a news archive to check against.


        `unresolvable` lists active perps whose ticker is a common English word and

        which have no safe project name — they can only ever be matched by a cashtag.

        Published as a field rather than left as a silent blind spot.'
      operationId: get_news_sources_api_v1_news_sources_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NewsSourcesResponse'
      security:
      - APIKeyHeader: []
components:
  schemas:
    NewsSourcesResponse:
      properties:
        sources:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Sources
        universe_size:
          type: integer
          title: Universe Size
        project_feed_symbols:
          items:
            type: string
          type: array
          title: Project Feed Symbols
        unresolvable:
          items:
            type: string
          type: array
          title: Unresolvable
        missing_names:
          items:
            type: string
          type: array
          title: Missing Names
        impact_threshold:
          type: number
          title: Impact Threshold
        funnel_24h:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Funnel 24H
        store:
          additionalProperties: true
          type: object
          title: Store
        last_refresh:
          title: Last Refresh
          type:
          - string
          - 'null'
      type: object
      required:
      - sources
      - universe_size
      - project_feed_symbols
      - unresolvable
      - missing_names
      - impact_threshold
      - funnel_24h
      - store
      title: NewsSourcesResponse
      description: 'Feed health plus the published coverage gap.


        ``unresolvable`` lists active perps with no safe project name and an

        ambiguous ticker — nothing short of a cashtag can match them. It is a field

        rather than a silent blind spot on purpose.'
    NewsCoinResponse:
      properties:
        symbol:
          type: string
          title: Symbol
        news_pressure:
          type: number
          title: News Pressure
        news_tilt:
          type: number
          title: News Tilt
        events:
          items:
            $ref: '#/components/schemas/NewsEvent'
          type: array
          title: Events
        count:
          type: integer
          title: Count
        window_hours:
          type: number
          title: Window Hours
        as_of:
          type: string
          title: As Of
      type: object
      required:
      - symbol
      - news_pressure
      - news_tilt
      - events
      - count
      - window_hours
      - as_of
      title: NewsCoinResponse
      description: Events for a single Hyperliquid perp.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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
    NewsPulseResponse:
      properties:
        rows:
          items:
            $ref: '#/components/schemas/NewsPulseRow'
          type: array
          title: Rows
        count:
          type: integer
          title: Count
        universe_size:
          type: integer
          title: Universe Size
        window_hours:
          type: number
          title: Window Hours
        tier_scope:
          type: string
          title: Tier Scope
        as_of:
          type: string
          title: As Of
      type: object
      required:
      - rows
      - count
      - universe_size
      - window_hours
      - tier_scope
      - as_of
      title: NewsPulseResponse
      description: Per-coin news feature series — the strategy input.
    NewsPulseRow:
      properties:
        symbol:
          type: string
          title: Symbol
        news_pressure:
          type: number
          title: News Pressure
        news_tilt:
          type: number
          title: News Tilt
        event_count:
          type: integer
          title: Event Count
        top_impact:
          type: number
          title: Top Impact
        headlines:
          type: integer
          title: Headlines
          default: 0
        rank:
          type: integer
          title: Rank
      type: object
      required:
      - symbol
      - news_pressure
      - news_tilt
      - event_count
      - top_impact
      - rank
      title: NewsPulseRow
      description: 'One perp''s news feature values.


        Every active perp gets a row: a quiet coin is ``news_pressure: 0``, not a

        missing row, so a cross-sectional ranking has the zeros it needs.'
    NewsEvent:
      properties:
        event_id:
          type: string
          title: Event Id
        symbol:
          type: string
          title: Symbol
        title:
          type: string
          title: Title
        url:
          type: string
          title: Url
        source:
          type: string
          title: Source
        published:
          title: Published
          type:
          - string
          - 'null'
        category:
          type: string
          title: Category
        impact_score:
          type: number
          title: Impact Score
        bias:
          type: number
          title: Bias
        corroboration:
          type: integer
          title: Corroboration
        severity:
          title: Severity
          type:
          - number
          - 'null'
        confidence:
          title: Confidence
          type:
          - number
          - 'null'
        match_mode:
          title: Match Mode
          type:
          - string
          - 'null'
        sources:
          title: Sources
          items:
            type: string
          type:
          - array
          - 'null'
        market_response:
          title: Market Response
          additionalProperties: true
          type:
          - object
          - 'null'
      type: object
      required:
      - event_id
      - symbol
      - title
      - url
      - source
      - category
      - impact_score
      - bias
      - corroboration
      title: NewsEvent
      description: 'One qualified, market-moving news event bound to a Hyperliquid perp.


        Only events clearing the impact threshold are ever returned — there is no

        raw-feed surface at any tier. ``symbol`` is the HL perp symbol, or

        ``MARKET`` for a story that moves everything.'
    NewsEventsResponse:
      properties:
        events:
          items:
            $ref: '#/components/schemas/NewsEvent'
          type: array
          title: Events
        count:
          type: integer
          title: Count
        window_hours:
          type: number
          title: Window Hours
        impact_threshold:
          type: number
          title: Impact Threshold
        tier_scope:
          type: string
          title: Tier Scope
        as_of:
          type: string
          title: As Of
      type: object
      required:
      - events
      - count
      - window_hours
      - impact_threshold
      - tier_scope
      - as_of
      title: NewsEventsResponse
      description: Filtered catalyst tape.
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key