cryptodataapi-com Geopolitical / Policy Shock Regime API

openapi: 3.2.0
info:
  title: Crypto Data Geopolitical / Policy Shock 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: Geopolitical / Policy Shock Regime
  description: Policy and geopolitical shock regime with driving headlines.
paths:
  /api/v1/policy/regime:
    get:
      tags:
      - Geopolitical / Policy Shock Regime
      summary: Get Policy Regime
      description: 'Policy Risk score + signed tilt + upcoming rate catalysts.


        The main Geopolitical / Policy Shock payload: the market-wide Policy Risk

        composite, the signed ``policy_tilt`` (pro-crypto vs restrictive), and the

        scheduled rate decisions within ``window_days``. Use `/policy/regime/score`

        for the full sub-score breakdown and `/policy/headlines` for the live

        US-regulatory headline feed.


        **Partly backfillable** — the gdelt / cross-asset / rate subscores replay from

        GDELT''s dated series, the archived macro block, and the rate schedule; the

        ``policy_headlines`` sidecar is live-only (null on backfill).'
      operationId: get_policy_regime_api_v1_policy_regime_get
      security:
      - APIKeyHeader: []
      parameters:
      - name: window_days
        in: query
        required: false
        schema:
          type: integer
          maximum: 45
          minimum: 1
          description: Forward horizon for rate catalysts
          default: 45
          title: Window Days
        description: Forward horizon for rate catalysts
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyRegimeResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      x-timeout-seconds: 20
  /api/v1/policy/regime/score:
    get:
      tags:
      - Geopolitical / Policy Shock Regime
      summary: Get Policy Regime Score
      description: 'Market-wide Policy Risk composite (0-100) + sub-scores + tilt + sidecars.


        Baseline 0 (policy shock is absence-by-default). Bands: dormant (<10), quiet

        (10-29), elevated (30-54), heavy (55-79), critical (≥80). Composite =

        0.40·gdelt + 0.35·cross_asset + 0.25·rate, re-normalized over available feeds.

        ``policy_tilt`` (signed) comes from GDELT coverage tone. The

        ``policy_headlines`` (Federal Register / SEC / CFTC) sidecar is live-only

        and excluded from the composite.'
      operationId: get_policy_regime_score_api_v1_policy_regime_score_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyRegimeScoreResponse'
      security:
      - APIKeyHeader: []
  /api/v1/policy/headlines:
    get:
      tags:
      - Geopolitical / Policy Shock Regime
      summary: Get Policy Headlines
      description: 'Live classified US-regulatory headlines (Federal Register / SEC / CFTC).


        The breaking-news sidecar: recent policy headlines classified pro-crypto vs

        restrictive, with an aggregate ``regulatory_pressure`` magnitude and a signed

        ``headline_tilt``. Live-only — not part of any backfillable composite.'
      operationId: get_policy_headlines_api_v1_policy_headlines_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyHeadlinesResponse'
      security:
      - APIKeyHeader: []
  /api/v1/policy/regime/refresh:
    post:
      tags:
      - Geopolitical / Policy Shock Regime
      summary: Refresh Policy Regime
      description: Force recompute the Geopolitical / Policy Shock regime cache (Pro+).
      operationId: refresh_policy_regime_api_v1_policy_regime_refresh_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PolicyRegimeRefreshResponse'
      security:
      - APIKeyHeader: []
components:
  schemas:
    PolicyRegimeScoreResponse:
      properties:
        as_of:
          type: string
          title: As Of
        policy_risk_score:
          type: number
          title: Policy Risk Score
          description: 0-100; baseline 0 (absence = no policy shock)
        band:
          type: string
          enum:
          - dormant
          - quiet
          - elevated
          - heavy
          - critical
          title: Band
        policy_tilt:
          type: number
          title: Policy Tilt
          default: 0.0
        tilt_label:
          type: string
          enum:
          - pro_crypto
          - restrictive
          - neutral
          title: Tilt Label
          default: neutral
        gdelt_subscore:
          type: number
          title: Gdelt Subscore
          default: 0.0
        cross_asset_subscore:
          type: number
          title: Cross Asset Subscore
          default: 0.0
        rate_subscore:
          type: number
          title: Rate Subscore
          default: 0.0
        gdelt_volume_z:
          title: Gdelt Volume Z
          type:
          - number
          - 'null'
        gdelt_tone:
          title: Gdelt Tone
          type:
          - number
          - 'null'
        cross_asset_z:
          additionalProperties: true
          type: object
          title: Cross Asset Z
        next_rate_days:
          title: Next Rate Days
          type:
          - integer
          - 'null'
        events_count:
          type: integer
          title: Events Count
          default: 0
        partial:
          type: boolean
          title: Partial
          default: false
        inputs_available:
          items:
            type: string
          type: array
          title: Inputs Available
          default: []
        policy_headlines:
          title: Policy Headlines
          description: Live-only classified US-regulatory headlines; null on backfill
          additionalProperties: true
          type:
          - object
          - 'null'
      type: object
      required:
      - as_of
      - policy_risk_score
      - band
      title: PolicyRegimeScoreResponse
      description: Market-wide Policy Risk composite + sub-scores + tilt + live-only sidecars.
    PolicyRegimeResponse:
      properties:
        items:
          items:
            $ref: '#/components/schemas/PolicyEventModel'
          type: array
          title: Items
        count:
          type: integer
          title: Count
        window_days:
          type: integer
          title: Window Days
        policy_risk_score:
          type: number
          title: Policy Risk Score
        band:
          type: string
          enum:
          - dormant
          - quiet
          - elevated
          - heavy
          - critical
          title: Band
        policy_tilt:
          type: number
          title: Policy Tilt
          description: -1 restrictive/risk-off … +1 pro-crypto/risk-on
        tilt_label:
          type: string
          enum:
          - pro_crypto
          - restrictive
          - neutral
          title: Tilt Label
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
      - items
      - count
      - window_days
      - policy_risk_score
      - band
      - policy_tilt
      - tilt_label
      - timestamp
      title: PolicyRegimeResponse
      description: Upcoming rate catalysts + market-wide policy risk — the main payload.
    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
    PolicyHeadlinesResponse:
      properties:
        regulatory_pressure:
          type: number
          title: Regulatory Pressure
          default: 0.0
        headline_tilt:
          type: number
          title: Headline Tilt
          default: 0.0
        headline_count:
          type: integer
          title: Headline Count
          default: 0
        top_headlines:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Top Headlines
          default: []
        sources_ok:
          additionalProperties: true
          type: object
          title: Sources Ok
          default: {}
        as_of:
          type: string
          title: As Of
      type: object
      required:
      - as_of
      title: PolicyHeadlinesResponse
      description: Live classified US-regulatory headlines (Federal Register / SEC / CFTC).
    PolicyEventModel:
      properties:
        event_type:
          type: string
          title: Event Type
        title:
          type: string
          title: Title
        date:
          type: string
          title: Date
        days_until:
          type: integer
          title: Days Until
        macro_class:
          title: Macro Class
          type:
          - string
          - 'null'
        bias:
          type: string
          title: Bias
        magnitude:
          title: Magnitude
          type:
          - number
          - 'null'
        source:
          type: string
          title: Source
          default: ''
      type: object
      required:
      - event_type
      - title
      - date
      - days_until
      - bias
      title: PolicyEventModel
    PolicyRegimeRefreshResponse:
      properties:
        refreshed:
          type: boolean
          title: Refreshed
        events:
          type: integer
          title: Events
        policy_risk_score:
          type: number
          title: Policy Risk Score
        policy_tilt:
          type: number
          title: Policy Tilt
        timestamp:
          type: string
          title: Timestamp
      type: object
      required:
      - refreshed
      - events
      - policy_risk_score
      - policy_tilt
      - timestamp
      title: PolicyRegimeRefreshResponse
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key