CEV-OS Data API

Use this when you need a quick risk-sentiment read before acting: Crypto Fear & Greed (alternative.me) and the cev-os Stock Sentiment Gauge (0-100, from IEX ETF closes + US Treasury yields), each with its own timestamp and source. Free. License: cleared_with_attribution. Attribution required: Data: alternative.me Stock Sentiment Gauge: computed by cev-os. Data provided for free by IEX. By accessing or using IEX Historical Data, you agree to the IEX Historical Data Terms of Use. IEX Historical Data Terms of Use: https://www.iex.io/legal/hist-data-terms 10-year yield: U.S. Department of the Treasury, Daily Treasury Par Yield Curve Rates.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need a 0-100 US stock-market fear/greed reading with its eight component percentiles and recent daily history (cev-os's own index; IEX ETF closes + US Treasury yields). Free. License: cleared_with_attribution. Attribution required: Data provided for free by IEX. By accessing or using IEX Historical Data, you agree to the IEX Historical Data Terms of Use. IEX Historical Data Terms of Use: https://www.iex.io/legal/hist-data-terms 10-year yield: U.S. Department of the Treasury, Daily Treasury Par Yield Curve Rates. Index: CEV-OS Stock Sentiment Gauge (cev-os).

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Days of history to return (1-60, default 30).",
      "type": "integer",
      "minimum": 1,
      "maximum": 60
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need official US release times (CPI, PPI, payrolls, GDP, PCE, retail sales, JOLTS, trade balance, productivity, claims, FOMC, ISM dates) with actual and prior values once released. Free. License: cleared. Attribution required: Sources: U.S. Bureau of Labor Statistics (incl. BLS Public Data API), U.S. Bureau of Economic Analysis, U.S. Census Bureau, U.S. Department of Labor, Federal Reserve Board. This service uses BEA data but is not endorsed or certified by BEA. BLS.gov cannot vouch for the data or analyses derived from these data after the data have been retrieved from BLS.gov.

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Start date (ET), YYYY-MM-DD. Default: today minus 30 days.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date (ET), YYYY-MM-DD. Default: today plus 60 days.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "event": {
      "description": "Comma-separated event types: cpi, ppi, employment_situation, jolts, eci, gdp, pce, retail_sales, jobless_claims, fomc_decision, fomc_minutes, ism_manufacturing, ism_services, trade_balance, productivity",
      "type": "string"
    },
    "status": {
      "description": "released or scheduled",
      "type": "string",
      "enum": [
        "released",
        "scheduled"
      ]
    },
    "limit": {
      "description": "Max events (1-1000, default 500).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need to know whether the next hours contain a market-moving event: US macro releases, FOMC, Treasury auctions, SEC-filed or estimated earnings, and options expiry, each with an impact tier. Free. License: cleared. Attribution required: Sources: BLS, BEA, U.S. Census Bureau, DOL, Federal Reserve Board, U.S. Treasury (TreasuryDirect), SEC EDGAR. This service uses BEA data but is not endorsed or certified by BEA.

{
  "type": "object",
  "properties": {
    "hours": {
      "description": "Look-ahead window in hours (1-168, default 48).",
      "type": "integer",
      "minimum": 1,
      "maximum": 168
    },
    "kinds": {
      "description": "Comma-separated filter: macro, fed, treasury_auction, earnings, options_expiry.",
      "type": "string"
    },
    "min_tier": {
      "description": "Lowest impact tier to include.",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high"
      ]
    },
    "include_estimated": {
      "description": "Include estimated (not yet SEC-confirmed) earnings dates (default true).",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need to know whether a scheduled US release (CPI, PPI, payrolls, JOLTS, GDP, PCE, FOMC, retail sales, claims) or an S&P 100/NASDAQ-100 earnings 8-K is out, when it was first seen, and actual vs prior vs revision. Free. License: cleared. Attribution required: Sources: BLS, BEA, U.S. Census Bureau, DOL, Federal Reserve Board, SEC EDGAR. Detection timestamps measured by cev-os. This service uses BEA data but is not endorsed or certified by BEA.

{
  "type": "object",
  "properties": {
    "event": {
      "description": "Comma-separated event types: cpi, ppi, employment_situation, jolts, eci, gdp, pce, retail_sales, jobless_claims, fomc_decision, fomc_minutes, ism_manufacturing, ism_services, trade_balance, productivity",
      "type": "string"
    },
    "from": {
      "description": "Start date (ET) YYYY-MM-DD, default 7 days ago.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "description": "End date (ET) YYYY-MM-DD, default 2 days ahead.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "ticker": {
      "description": "S&P 100 / NASDAQ-100 ticker: adds its latest 8-K Item 2.02 (earnings) acceptance time.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you want one slow-moving macro regime flag (risk_on / neutral / risk_off) with its transparent inputs: yield curve, financial conditions, financial stress, unemployment trigger and jobless-claims trend. Free. License: cleared_with_attribution. Attribution required: Federal Reserve Board (H.15), Federal Reserve Bank of Chicago (NFCI), Federal Reserve Bank of St. Louis (STLFSI4), U.S. Bureau of Labor Statistics (UNRATE), U.S. Department of Labor (ICSA); retrieved from FRED, Federal Reserve Bank of St. Louis.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when you need recent geopolitical, conflict and natural-hazard incidents mapped to the asset classes and liquid proxies they can move (oil, grains, gas, semis, gold, Treasuries, country ETFs). Free. License: cleared_with_attribution. Attribution required: The GDELT Project (https://www.gdeltproject.org/); Uppsala Conflict Data Program (UCDP), CC BY 4.0; U.S. Geological Survey; GDACS (EC-JRC / UN OCHA), not for life-safety use. Asset tagging by cev-os TRIPWIRE.

{
  "type": "object",
  "properties": {
    "since_hours": {
      "description": "Incidents updated in the last N hours (1-168, default 24).",
      "type": "integer",
      "minimum": 1,
      "maximum": 168
    },
    "min_severity": {
      "description": "Minimum severity 1-5.",
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "asset": {
      "description": "Case-insensitive substring filter on asset tags, e.g. oil, semiconductors, gold.",
      "type": "string"
    },
    "region": {
      "description": "Region filter.",
      "type": "string",
      "enum": [
        "Middle East",
        "Europe",
        "East Asia",
        "South & Southeast Asia",
        "Africa",
        "Americas",
        "Oceania",
        "Other"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Use this when sizing an earnings trade: historical day-1 / day-5 move distribution per ticker around SEC 8-K Item 2.02 earnings releases. Free. License: cleared_with_attribution. Attribution required: Data provided for free by IEX. By accessing or using IEX Historical Data, you agree to the IEX Historical Data Terms of Use. IEX Historical Data Terms of Use: https://www.iex.io/legal/hist-data-terms Release times: SEC EDGAR. Statistics: PrintLine (cev-os).

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "S&P 100 / NASDAQ-100 ticker (required).",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}