CEV-OS Data API: free US macro, earnings and incident data for bots and AI agents

CEV-OS Data API is a free, keyless JSON and MCP service from Cutting Edge Ventures. It gives trading bots and AI agents US macro release times (CPI, FOMC, payrolls, GDP, PCE and more) with actual and prior values, a "has it been released yet" status, a next-48-hour catalyst calendar, historical earnings-day price moves for S&P 100 and NASDAQ-100 stocks, and conflict and natural-hazard incidents tagged with the assets they may affect. Every response carries its source, license and attribution plus UTC timestamps. Anonymous use is limited to 60 requests per minute and 2,000 per day per IP. It is reference data, not investment advice.

Last updated 2026-10-28. 7 products, each available over REST and as an MCP tool. MCP registry name: com.cev-os/data.

What you get

The 7 CEV-OS Data API products (REST base `https://api.cev-os.com/v1`)
Product	REST endpoint	MCP tool	What it returns	Query parameters
Market mood	`GET /v1/market-mood`	`get_market_mood`	Crypto Fear & Greed index and the VIX daily close, each with its own timestamp and source.	none
US macro release calendar	`GET /v1/macro-calendar`	`get_macro_calendar`	Official release times for CPI, PPI, payrolls, GDP, PCE, retail sales, JOLTS, jobless claims, FOMC decisions and minutes, ISM dates and more, with actual and prior values once released.	`from`, `to`, `event`, `status`, `limit`
Next-48h catalyst calendar	`GET /v1/catalysts`	`get_catalysts`	One time-sorted list of upcoming macro releases, FOMC, Treasury auctions, SEC-filed or estimated earnings and options expiry, each with an impact tier. Window of 1 to 168 hours.	`hours`, `kinds`, `min_tier`, `include_estimated`
Is it out yet? (release status)	`GET /v1/release-status`	`get_release_status`	Whether a scheduled US release, or an S&P 100 / NASDAQ-100 earnings 8-K (Item 2.02), is out yet, when it was first seen, and actual vs prior.	`event`, `from`, `to`, `ticker`
Macro market regime	`GET /v1/macro-regime`	`get_macro_regime`	One slow-moving risk_on / neutral / risk_off flag computed from five public macro inputs, with the inputs and thresholds shown. An indicator, not a recommendation.	none
Incidents tagged with affected assets (TRIPWIRE)	`GET /v1/incident-assets`	`get_incident_assets`	Recent conflict and natural-hazard incidents from open feeds, tagged with the asset classes they may affect. Location is deliberately coarse (country and region only); many incidents carry no asset tag.	`since_hours`, `min_severity`, `asset`, `region`
Post-earnings reaction stats	`GET /v1/earnings-reactions`	`get_earnings_reactions`	Historical day-1 and day-5 price-move statistics per S&P 100 / NASDAQ-100 ticker around SEC 8-K Item 2.02 earnings releases, on IEX last-sale prices.	`ticker`

Full parameter lists, response schemas and examples are in the OpenAPI 3.1 description; a plain-text summary for agents is in llms.txt; the machine-readable product list is /v1/products.

Try it in one request

No account and no key:

curl -s "https://api.cev-os.com/v1/macro-calendar?event=cpi&limit=3"

The response is a JSON envelope (trimmed, shape only; values are placeholders):

{
  "schema_version": "1.0",
  "product": "macro-calendar",
  "generated_at": "<ISO-8601 UTC>",
  "generated_at_et": "<US Eastern display string>",
  "as_of": "<newest observation, UTC>",
  "license": { "status": "...", "summary": "...", "sources": [ ... ] },
  "attribution": [ "..." ],
  "data": { "count": 3, "events": [ { "eventType": "cpi", "releaseAt": "<UTC>", "status": "scheduled | released", "consensus": null, "actual": null, "prior": { ... } } ] }
}

Connect it to an AI agent (MCP)

The same 7 products are available as read-only tools on a stateless Streamable HTTP MCP server at https://mcp.cev-os.com/mcp (POST only). Example client configuration; key names differ between MCP clients, so adjust to yours:

{
  "mcpServers": {
    "cev-os-data": {
      "type": "http",
      "url": "https://mcp.cev-os.com/mcp"
    }
  }
}

Limits, keys and price

Price: free to use. Pay-per-call is not active.
Key: none needed. An optional free API key (sent in the x-api-key header, never in the URL) raises the limits; there is no self-serve sign-up, so email support@cev-os.com to ask for one.
Anonymous limits: 60 requests per minute and 2,000 per day per IP. Responses include RateLimit-Limit and RateLimit-Remaining headers, and a 429 response includes Retry-After. Counters are approximate.
Freshness: varies by product. Check as_of and generated_at in each response.
Contact: support@cev-os.com.

What it does not do

US data only. No market-holiday or trading-hours dataset.
No macro consensus or forecast values: the consensus field is always null.
Actual values come from FRED and can lag a release by minutes to hours.
Earnings reaction statistics cover S&P 100 and NASDAQ-100 tickers only, use IEX-venue last-sale prices (not the official consolidated close) and are not dividend-adjusted.
Earnings dates before the SEC 8-K is filed are estimates.
Incident location is coarse (country and region), and many incidents have no asset tag. Tags are exposures, not predictions.
No promise of availability or uptime.

Sources, license and attribution

Each response carries license and attribution fields for the records it returns. Show the attribution text wherever you display the data. Underlying sources: Alternative.me Crypto Fear & Greed Index; Cboe Volatility Index (VIXCLS) daily close via FRED; U.S. Bureau of Labor Statistics; U.S. Bureau of Economic Analysis; U.S. Census Bureau; Federal Reserve Board; U.S. Department of Labor; FRED, Federal Reserve Bank of St. Louis (public-domain series only); Institute for Supply Management (dates only); U.S. Department of the Treasury, TreasuryDirect (announced auctions); SEC EDGAR (8-K Item 2.02 filings); Computed options-expiry dates (standard third-Friday rule, NYSE holiday calendar); Fed H.15 (T10Y3M), Chicago Fed NFCI, St. Louis Fed STLFSI4 via FRED; The GDELT Project; Uppsala Conflict Data Program (UCDP) Candidate Events; U.S. Geological Survey earthquakes; GDACS (EC-JRC / UN OCHA); IEX Historical Data (HIST TOPS), daily IEX last sale.

IEX (earnings reactions): 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.
BEA data: this service uses BEA data but is not endorsed or certified by BEA.
GDACS data is not for life-safety use.

Not investment advice

All data is reference data provided as is. It is not investment advice, an offer, or a recommendation. Historical statistics say nothing about future results. Check each record's source and timestamp before relying on it.

Questions

Is CEV-OS Data API free, and do I need a key?: It is free to use and needs no key. An optional free key for higher limits is available on request.
What are the rate limits?: 60 requests per minute and 2,000 per day per IP address when anonymous.
Is there a consensus forecast?: No. The consensus field is always null.
Which stocks have earnings reaction statistics?: S&P 100 and NASDAQ-100 tickers, measured on day 1 and day 5 after the SEC 8-K Item 2.02 release.
How do I use it from Claude, Cursor or another MCP client?: Add the Streamable HTTP server https://mcp.cev-os.com/mcp to the client's MCP configuration.