Skip to main content

Advanced quickstarts

Use these once the basic issuer-resolution and filing-fetch flows are already working.

API: compare 13F positions

curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  https://api.secapi.ai/v1/owners/13f/compare \
  -d '{"cik":"0001067983","limit":25}'

API: executive compensation comparison

curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  https://api.secapi.ai/v1/compensation/compare \
  -d '{"ticker":"NVDA","limit":10}'

CLI: onboarding a webhook and polling a stream

omni-sec webhooks create \
  --destination-url https://example.com/omni-datastream \
  --event-types artifact.created,stream_subscription.created

omni-sec streams create \
  --description ops-audit \
  --event-types artifact.created,webhook_endpoint.created

API: create billing and portal sessions

curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  https://api.secapi.ai/v1/billing/checkout \
  -d '{"planKey":"builder","successUrl":"https://secapi.ai/onboarding?checkout=success","cancelUrl":"https://secapi.ai/onboarding?checkout=cancel"}'

curl -X POST \
  -H "content-type: application/json" \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  https://api.secapi.ai/v1/billing/portal \
  -d '{"returnUrl":"https://secapi.ai/onboarding"}'

MCP: first structured tool chain

  1. call tools/list
  2. call entities.resolve for a ticker or CIK
  3. call filings.latest
  4. call statements.get
  5. call artifacts.bundle if the plan enables artifact generation

Operations: export a support bundle

bun run ops:support-bundle -- --org-id org_omni_datastream --request-id req_example

Billing: posture audit

bun run ops:stripe-audit