Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Getting Started

​
The shortest useful path

Get one issuer, one filing, and one structured statement working first. Do that before you chase a broader integration. If you are starting as an external coding agent or operator, begin at https://secapi.ai/agents first. That page is the public discovery surface for the sponsored bootstrap flow and the hosted MCP posture.

​
Before you make a request

  1. Export OMNI_DATASTREAM_API_KEY
  2. Verify health at https://api.secapi.ai/healthz
  3. Verify readiness at https://api.secapi.ai/readyz
  4. Decide whether you are starting with REST, SDK, CLI, or MCP
  5. Pick one identifier you already trust such as ticker, CIK, FIGI, ISIN, or CUSIP

​
REST 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/all?ticker=AAPL&period=annual&limit=1"

​
JavaScript quickstart

npm install @omni-datastream/sdk-js

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

const client = new OmniDatastreamClient({
  apiKey: process.env.OMNI_DATASTREAM_API_KEY!,
})

const issuer = await client.resolveEntity({ ticker: "AAPL" })
const filing = await client.latestFiling({ ticker: "AAPL", form: "10-K" })
const statements = await client.allStatements({ ticker: "AAPL", period: "annual", limit: 1 })

​
Python quickstart

from omni_datastream_py import OmniDatastreamClient

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

issuer = client.resolve_entity(ticker="AAPL")
filing = client.latest_filing(ticker="AAPL", form="10-K")
statements = client.all_statements(ticker="AAPL", period="annual", limit=1)

​
CLI quickstart

Install the CLI via Homebrew or npm: 
# Homebrew
brew install autonomous-computer/omni-datastream/omni-sec

# or npm
npm install -g @omni-datastream/cli
Then run your first queries: 
omni-sec entities resolve --ticker AAPL --json
omni-sec filings latest --ticker AAPL --form 10-K --json
omni-sec statements get --ticker AAPL --statement all --period annual --json

​
Trace hydration quickstart

When a filing-derived response includes trace references, hydrate them by trace id. 
curl -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  "https://api.secapi.ai/v1/traces/<trace_id>"

const trace = await client.getTrace("<trace_id>")

​
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
  • Sponsored bootstrap: POST https://api.secapi.ai/v1/agent/bootstrap_tokens then POST https://api.secapi.ai/v1/agent/bootstrap

​
First MCP tools to call

  • entities.resolve
  • filings.latest
  • statements.get

​
What to keep from your first success

  • the Request-Id
  • the exact endpoint or tool you called
  • the provenance, freshness, and trace metadata from the response

​
Next pages