# EVIO API

> MCP-native financial data primitives for AI agents. Reasoned,
> decision-shaped outputs with citations and confidence scores.
> Public-co regulated; Colorado-incorporated; HQ Henderson, NV.
> OTC: EVIO. Closed alpha. Mock JSON in final response shape;
> live data integration targeted Q3 2026 as a transparent
> provider swap.

## Quick start

- MCP server: https://api.evioinc.com/mcp
- REST base: https://api.evioinc.com/v1
- Auth: Bearer API key (get one at https://app.evioinc.com/sign-up?invite=alpha)
- Docs: https://evioinc.com/api/docs
- Capabilities manifest: https://api.evioinc.com/agent-capabilities  (alias of /.well-known/agent-capabilities)
- OpenAPI 3.1: https://api.evioinc.com/openapi.json
- Schemas (open source): https://github.com/JpDeSilva17/evio-schemas

## Tools (8)

- evio_options_unusual    — Top N tickers with statistically unusual options activity, with reasoning trace and confidence
- evio_factor_score       — Multi-factor decomposition for a basket of tickers; factor exposures + composite score
- evio_backtest_run       — Submit a strategy spec; equity curve + Sharpe + drawdown. Sync, streaming, and async modes
- evio_equity_research    — Composite equity research package (rating, target, key drivers, comparable set)
- evio_regime_classify    — Macro regime classification (risk-on / risk-off / late-cycle) with confidence and history
- evio_news_sentiment     — Tone-vs-baseline news sentiment for a ticker over a window
- evio_sec_filing         — SEC filing structured summary with diff against prior filing of same form type
- evio_portfolio_risk     — VaR, expected shortfall, factor exposure for a submitted portfolio

## Response envelope

Every response includes:
- _meta:        request_id, latency_ms, data_freshness (mock|shadow|live), tokens_estimated, version
- _reasoning:   ordered atomic reasoning steps (one sentence each)
- _citations:   each citation links a reasoning step to its data source
- _confidence:  score (0..1), label, factors[]
- _links:       canonical IDs surfaced + EVIO endpoints that accept them

Optional opt-in via `include=` query param: _alternatives, _counterfactual, _suggestions.

## Conventions

- Tickers: ISO 10383 MIC + symbol, e.g. XNAS:AAPL
- Filings: SEC accession numbers
- Pagination: cursor-based (?cursor=...&limit=50)
- Field selection: ?fields=a,b,c (default slim shape; ?verbose=true returns full)
- Idempotency: optional Idempotency-Key UUIDv4 header on POST
- Errors: structured envelope with code, recoverable, hints[], docs_url

## Pricing

- Indie:      $99/mo,    50,000 calls,   $0.002/call overage
- Studio:     $499/mo,   500,000 calls,  $0.0015/call overage
- Pro:        $1,999/mo, 5,000,000 calls,$0.001/call overage
- Enterprise: custom + SLA

Closed alpha: $0 across all tiers until general availability.

## Status

Closed alpha (May 2026). Eight endpoints live with mock data behind real auth and metering.
Live market data: Q3 2026.

## Compliance

EVIO Inc. is publicly traded on the OTC Current tier (OTC: EVIO). Colorado corporation, headquartered in Henderson, Nevada. Note: EVIO files annual and quarterly disclosures and audited financials through OTC Markets' alternative reporting standard. EVIO is NOT an SEC-registered issuer.
This page contains forward-looking statements within the meaning of Section 27A of the Securities Act of 1933 and Section 21E of the Securities Exchange Act of 1934.

## Optional

- [Full reference (single file for LLM ingestion)](https://evioinc.com/llms-full.txt)
- [API landing page](https://evioinc.com/api/)
- [Endpoints catalog](https://evioinc.com/api/endpoints.html)
- [Pricing](https://evioinc.com/api/pricing.html)
- [Security & compliance](https://evioinc.com/api/security.html)
- [Changelog](https://evioinc.com/api/changelog.html)