API docs

Public read surfaces for source-linked SEC 8-K event intelligence. These endpoints are intended for retrieval, monitoring, RSS readers, and lightweight research tools.

OpenAPI

/openapi.json

Crawler policy

/robots.txt

Machine surface map

HTML-native index of every public retrieval surface — JSON feeds, RSS, per-filing alternates, hub pages, and grounding endpoints. Use these when text/plain, RSS, XML, or Markdown surfaces are not rendered reliably by a browsing client.

GET /machine — HTML twin of /llms.txt; semantic anchors for browsing-tool LLMs.
GET /llms.txt — proposed-standard text/plain index of canonical surfaces.
GET /debug/eval-fixtures.json — static manifest of canonical surfaces with expected status, content-type, and sample body for retrieval-eval rigs and synthetic monitors.

Rate limits

Public read surfaces emit rate-limit headers. The first rollout is shadow mode: over-limit clients receive normal responses plus X-RateLimit-Would-Limit: true; enforcement can later return 429 with Retry-After. GET and HEAD use separate method buckets, and missing/error responses do not consume quota.

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 119
X-RateLimit-Reset: 1779549000

Filing event

Returns one source-linked structured summary for a ready SEC Form 8-K filing.

GET /filing/{accession}.json
GET /filing/{accession}.md
GET /filing/{accession}.txt
GET /filing/{accession}

Recent filings feed

Cursor-paginated JSON optimized for LLM and machine ingestion.

GET /api/llm-feed.json?limit=50

Fields include:
accession, ticker, company_name, filed_at, event_type,
headline, bullets, materiality_score, calibrated_materiality_score,
json_url, markdown_url, summary_text_url, source URLs, alternate URLs.

Ticker and event feeds

GET /api/filings?ticker=AAPL
GET /ticker/AAPL
GET /feed/ticker/AAPL.xml
GET /events/earnings/recent
GET /events/earnings/recent.json
GET /feed/event/earnings.xml

Daily digest

/daily/latest redirects to the latest substantive final digest; empty weekend or holiday shells remain available at their dated URLs.

GET /daily/latest
GET /daily/{YYYY-MM-DD}

Executive changes

GET /executive-changes
GET /api/executive-changes.json
GET /feed/executive-changes.xml

Source filings are SEC EDGAR documents. secwatch summaries are AI-assisted reading aids and should be verified against the linked source filing.