# Omni Datastream

Omni Datastream is a primary-source, agent-native SEC data platform with REST, CLI, and hosted MCP surfaces.

## Best entry points

- API health: `/healthz`
- API docs content: `apps/docs/content/`
- MCP server: `/mcp`
- JS SDK: `packages/sdk-js/src/index.ts`
- Python SDK: `packages/sdk-py/omni_datastream_py/client.py`

## Core API workflows

- resolve entities: `GET /v1/entities/resolve`
- search filings: `GET /v1/filings`
- latest filing: `GET /v1/filings/latest`
- latest section: `GET /v1/filings/latest/sections/{sectionKey}`
- facts: `GET /v1/facts`
- statements: `GET /v1/statements/{statementKey}`
- 13F: `GET /v1/owners/13f`
- compensation: `GET /v1/compensation`
- artifacts: `POST /v1/artifacts`
- usage: `GET /v1/usage`
- limits: `GET /v1/limits`
- events: `GET /v1/events`

## MCP workflows

- tools: `entities.resolve`, `filings.search`, `filings.latest`, `sections.get`, `facts.get`, `statements.get`, `owners.get_13f`, `owners.compare_13f`, `insiders.list`, `comp.list`, `comp.compare`, `artifacts.bundle`
- resources: `sec://entities/{ticker_or_cik}`, `sec://filings/latest/{ticker_or_cik}/{form}`, `sec://sections/latest/{ticker_or_cik}/{form}/{section_key}`, `sec://statements/{ticker_or_cik}/{statement_key}/{period}`, `sec://13f/{cik}`

## API conventions

- request correlation: `Request-Id` header
- metering classification: `Omni-Meter-Class` header
- auth: `x-api-key` today, WorkOS OAuth discovery later
- errors: structured JSON with `object=error`, `code`, `type`, `message`, `requestId`