SEC EDGAR API: Financials, Ratios & Red Flags

SEC EDGAR Financial Data & Filings API — Company Financials by Ticker Get SEC company financials, 10-K / 10-Q / 8-K filings, and financial ratios as clean JSON — from a single ticker or company name. Built for AI agents and MCP, due-diligence workflows, and investment research. Type AAPL (or Apple) and get back company metadata, recent SEC filings with direct document links, the latest key financials, deterministically computed ratios (profit margin, revenue growth, debt-to-equity), and rule-based financial red flags — in one fast call. What this actor does Get SEC financial data by ticker or company name — resolves to the official SEC CIK, no manual EDGAR lookups. Extract 10-K, 10-Q and 8-K filings as JSON — form type, filing date, and a direct link to each document. Pull key financials from XBRL — revenue, net income, operating income, assets, liabilities, equity, cash, EPS. Compute financial ratios automatically — profit margin, year-over-year revenue growth, debt-to-equity, each with the fiscal years it used. Detect financial red flags — net loss, revenue decline, negative equity, high leverage, operating loss. Why use this instead of a raw data feed Most financial APIs hand an AI agent raw numbers and let the model compute ratios itself — which is exactly where one-shot LLM calls hallucinate. This actor does the opposite: Every figure is computed deterministically from official XBRL filings. No LLM estimates any number. Red flags are rule-based with explicit, configurable thresholds — explainable and reproducible, not a guess. Decision-shaped output — a verdict-ready snapshot, not a 50 KB dump to summarize. Official, stable source (data.sec.gov) — no anti-bot fragility, minimal maintenance. Use cases AI agent financial research — an MCP tool an agent calls to fetch a company snapshot mid-task. Investment due diligence — screen a US public company's financial health in one call. Company financial health check by ticker — margins, growth, leverage, and warning signs at a glance. Automated SEC filing monitoring — pull the latest 10-K / 10-Q / 8-K for a watchlist. Feeding financial data into LLM apps — structured, trustworthy figures instead of scraped HTML. Input Field Type Description query string (required) Stock ticker (AAPL) or company name (Apple). contactEmail string Your email — the SEC requires a contact in the request User-Agent. filingTypes array Form types to include. Default: 10-K, 10-Q, 8-K. maxFilings integer Max recent filings. Default: 10. maxDebtToEquity integer Threshold for the HIGH_LEVERAGE flag. Default: 2. Output (shape)

{
  "found": true,
  "company": { "name": "Apple Inc.", "cik": "0000320193", "ticker": "AAPL", "exchange": "Nasdaq", "sicDescription": "Electronic Computers" },
  "recentFilings": [ { "form": "10-K", "filingDate": "2025-11-01", "documentUrl": "https://www.sec.gov/Archives/edgar/data/320193/.../aapl.htm" } ],
  "keyFinancials": {
    "revenue":   { "value": 391035000000, "unit": "USD", "fiscalYear": 2024, "concept": "RevenueFromContractWithCustomerExcludingAssessedTax" },
    "netIncome": { "value": 93736000000,  "unit": "USD", "fiscalYear": 2024 }
  },
  "snapshot": {
    "profitMargin":     { "value": 0.2397, "formatted": "24.0%", "basis": "FY2024 net income / FY2024 revenue" },
    "revenueGrowthYoY": { "value": -0.028, "formatted": "-2.8%", "from": "FY2024", "to": "FY2025" },
    "debtToEquity":     { "value": 6.08, "basis": "FY2025 total liabilities / stockholders equity" }
  },
  "redFlags": [ { "code": "HIGH_LEVERAGE", "severity": "medium", "message": "Debt-to-equity 6.08 exceeds threshold 2.0." } ],
  "source": "SEC EDGAR (data.sec.gov)",
  "disclaimer": "Figures computed deterministically from XBRL filings. Informational only, not investment advice."
}

How the numbers are computed (auditable) profitMargin = latest annual net income / latest annual revenue. revenueGrowthYoY = latest annual revenue / prior annual revenue − 1. debtToEquity = latest annual total liabilities / stockholders' equity. Concepts are never mixed within a metric, so a revenue definition stays consistent across years. Each result reports the fiscal years it used. Red-flag rules (deterministic) NET_LOSS, REVENUE_DECLINE, NEGATIVE_EQUITY, HIGH_LEVERAGE, OPERATING_LOSS. An empty redFlags array means none of the checked rules triggered — not a clean bill of health. Use as an MCP tool for AI agents Once published, this actor is reachable through the hosted Apify MCP server at mcp.apify.com (Streamable HTTP). An agent can discover it, read its input and output schema, and call it with a ticker — getting a verdict-ready financial snapshot back in one turn. Clean schema + one clear job = a tool an LLM can pick and call reliably. FAQ How do I get SEC financial data for a company by ticker? Pass the ticker (e.g. AAPL) as query. The actor resolves it to the SEC CIK and returns filings, financials, ratios, and red flags as JSON. Is the data official? Yes — it comes directly from the SEC EDGAR public APIs (data.sec.gov and www.sec.gov), the authoritative source for US public-company filings. Are the financial ratios reliable? They're computed with exact arithmetic from XBRL data, never estimated by a language model. Each ratio reports the fiscal years it used so you can audit it. Which companies are covered? US SEC filers (companies filing 10-K / 20-F annual reports). For UK companies, see the related actor below. Related actors Part of a financial-intelligence actor suite: UK Companies House Financial Intelligence — KYB (officers, PSC, status, charges) + financials from filed accounts + red flags for UK companies. (Add your published Store URL here once live.) Run locally

npm i -g apify-cli
apify run -i '{"query": "AAPL", "contactEmail": "you@example.com"}'

Limits US SEC filers only (10-K / 20-F annual data). EU/private companies are covered by separate actors. EDGAR rate limit ~10 req/s; this actor makes ~3 calls per lookup.