Getting Started

Omni Datastream exposes the same SEC workflows over REST, CLI, JS, Python, and hosted MCP.

First production checks

1. Verify API health:

curl https://api.secapi.ai/healthz
curl https://api.secapi.ai/readyz

1. Export your API key as `OMNI_DATASTREAM_API_KEY`
2. Make one issuer-resolution request, one filing request, and one statement request
3. Record the `Request-Id` header from the first successful response so support can trace the session if needed

API quickstart

curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/entities/resolve?ticker=AAPL"

curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/filings/latest?ticker=AAPL&form=10-K"

curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/statements/balance_sheet?ticker=AAPL&period=annual&limit=1"

JavaScript quickstart

import { OmniDatastreamClient } from "@omni-datastream/sdk-js"

const client = new OmniDatastreamClient({
  apiKey: process.env.OMNI_DATASTREAM_API_KEY!,
  baseUrl: "https://api.secapi.ai",
})

const filing = await client.latestFiling({ ticker: "AAPL", form: "10-K" })
console.log(filing.id, filing.provenance.accessionNumber)

Python quickstart

from omni_datastream_py import OmniDatastreamClient

client = OmniDatastreamClient(
    api_key="YOUR_API_KEY",
    base_url="https://api.secapi.ai",
)

filing = client.latest_filing(ticker="AAPL", form="10-K")
print(filing["id"], filing["provenance"]["accessionNumber"])

CLI quickstart

omni-sec me --json
omni-sec filings latest --ticker AAPL --form 10-K --json
omni-sec statements get --ticker AAPL --statement income-statement --period annual --json

MCP quickstart

• MCP server: `https://api.secapi.ai/mcp`
• Protected resource metadata: `https://api.secapi.ai/.well-known/oauth-protected-resource`
• Authorization server metadata: `https://api.secapi.ai/.well-known/oauth-authorization-server`

First tools to call

• `entities.resolve`
• `filings.search`
• `filings.latest`
• `sections.get`
• `facts.get`
• `statements.get`

Next docs to read

• `/docs/give-this-prompt-to-your-agent`
• `/docs/first-request-flows`
• `/docs/advanced-quickstarts`
• `/docs/auth-and-pricing`
• `/docs/troubleshooting`
• `/docs/enterprise-commercial`
• `/docs/design-partner-support-packet`
• `/docs/support-admin`