# CEV-OS Data API

> Free, machine-first US macro, market-mood and event data from Cutting Edge Ventures (https://cev-os.com). JSON envelopes with source, license, attribution, ISO-8601 UTC timestamps plus ET display strings. No paywall; no API key needed.

- REST base: https://api.cev-os.com/v1
- Docs (HTML): https://cev-os.com/data-api
- OpenAPI 3.1: https://api.cev-os.com/openapi.json
- MCP (Streamable HTTP, stateless): https://mcp.cev-os.com/mcp
- Product registry (JSON): https://api.cev-os.com/v1/products
- Limits: 60 requests/min and 2,000/day per IP anonymously; optional free API key via the x-api-key header for more.
- Contact: support@cev-os.com

## Products
- [Market mood](https://api.cev-os.com/v1/market-mood): Use this when you need a quick risk-sentiment read before acting: Crypto Fear & Greed (alternative.me) and the VIX daily close (FRED), each with its own timestamp and source. MCP tool: `get_market_mood`. Price: free. License: citation_required (alternative.me requires attribution next to the data; VIXCLS is Cboe-copyrighted and FRED requires the citation included in each record.)
- [US macro release calendar](https://api.cev-os.com/v1/macro-calendar): 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. MCP tool: `get_macro_calendar`. Price: free. License: cleared (US Government works (public domain) plus ISM release dates. Cite the agencies; BEA non-endorsement notice applies.)
- [Next-48h catalyst calendar](https://api.cev-os.com/v1/catalysts): 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. MCP tool: `get_catalysts`. Price: free. License: cleared (US Government works (BLS, BEA, Census, Fed, DOL, Treasury, SEC) plus computed expiry dates and ISM release dates.)
- [Is it out yet? (release status)](https://api.cev-os.com/v1/release-status): 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. MCP tool: `get_release_status`. Price: free. License: cleared (US Government works (BLS, BEA, Census, Fed, DOL, SEC); timing measurements are cev-os's own.)
- [Macro market regime](https://api.cev-os.com/v1/macro-regime): 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. MCP tool: `get_macro_regime`. Price: free. License: cleared_with_attribution (Fed/BLS/DOL series with no copyright notice on FRED; cite each source and FRED (citations in each input).) Informational macro indicator. Not investment advice.
- [TRIPWIRE incidents tagged with affected assets](https://api.cev-os.com/v1/incident-assets): 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). MCP tool: `get_incident_assets`. Price: free. License: cleared_with_attribution (Only incidents whose every source is commercially usable (GDELT with citation, UCDP CC BY 4.0, USGS public domain, GDACS with attribution). Tags are cev-os's own.)
- [Post-earnings reaction stats](https://api.cev-os.com/v1/earnings-reactions): 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. MCP tool: `get_earnings_reactions`. Price: free. License: cleared_with_attribution (Release times are SEC EDGAR (public domain). Moves are computed from IEX Historical Data, which IEX permits to be redistributed and resold with its attribution text and a link to its terms.) Historical statistics on IEX-venue last-sale prices, for reference only. Not investment advice.

## Internal preview (not public: licensing pending)
- TradeBot paper-signal ledger (preview) (/v1/preview/signal-ledger): Bot signals and outcomes are computed from Yahoo/yfinance (and Coinbase crypto) prices whose terms bar redistribution, including derived data. Internal preview until licensed prices replace them.
- Trend-bot regime component (preview) (/v1/preview/regime-trend): Derived from bot state computed on Yahoo/yfinance and Coinbase prices; Yahoo terms bar redistribution including derived data.

## Notes
- Not investment advice. Data is provided as-is; check each record's source and timestamp.
- IEX: Data provided for free by IEX. By accessing or using IEX Historical Data, you agree to the IEX Historical Data Terms of Use. Terms: https://www.iex.io/legal/hist-data-terms (IEX last-sale prices are IEX-venue only and a reference point, not the official close.)
- Excluded by policy: CNN Fear & Greed (terms bar redistribution), any personal or location data.