Code Examples

Quick examples using the official SDKs. Install once, then use the typed client — no manual HTTP headers or URL construction needed.

Node.js / TypeScript

npm install sec-daily-api
import { SecDailyAPI } from "sec-daily-api";

const client = new SecDailyAPI({ apiKey: process.env.SEC_DAILY_API_KEY });

// Get recent 8-K filings for Apple
const { filings } = await client.getFilings({
  ticker: "AAPL",
  formTypes: ["8-K"],
  limit: 5,
});
for (const f of filings) {
  console.log(f.filingDateInEst, f.formType, f.entity?.name);
}

// Get latest press releases
const { news } = await client.getNews({ newsType: "PressReleases", limit: 5 });
for (const n of news) {
  console.log(n.publishedDateInUtc?.slice(0, 10), n.title);
}

// Look up a company by ticker
const entity = await client.getEntity({ ticker: "MSFT" });
console.log(entity.name, entity.cik);

Python

pip install sec-daily-api
from sec_daily_api import SecDailyAPI

client = SecDailyAPI()  # reads SEC_DAILY_API_KEY from environment

# Get recent 8-K filings for Apple
result = client.get_filings(ticker="AAPL", form_types="8-K", limit=5)
for f in result["filings"]:
    print(f["filingDateInEst"], f["formType"], f.get("entity", {}).get("name"))

# Get latest press releases
news = client.get_news(news_type="PressReleases", limit=5)
for n in news["news"]:
    print(n["publishedDateInUtc"][:10], n["title"])

# Look up a company by ticker
entity = client.get_entity(ticker="MSFT")
print(entity["name"], entity["cik"])

MCP — Use with Claude, ChatGPT, Cursor, or Windsurf

Add the config below to your AI app and query SEC data in plain English — no code needed. Works with any MCP-compatible AI tool.

{
  "mcpServers": {
    "sec-daily": {
      "command": "npx",
      "args": ["-y", "sec-daily-mcp"],
      "env": {
        "SEC_DAILY_API_KEY": "your_key_here"
      }
    }
  }
}

Then ask your AI: “Show me Apple's latest 10-K filings” or “What SEC filings did Tesla submit last week?”

Sample response

All list endpoints return a consistent shape:

{
  "filings": [
    {
      "id": "0000320193-24-000123",
      "formType": "10-K",
      "filingDateInEst": "2024-11-01",
      "entity": {
        "name": "Apple Inc.",
        "cik": "0000320193",
        "ticker": "AAPL"
      },
      "periodOfReport": "2024-09-28",
      "linkToFiling": "https://www.sec.gov/Archives/edgar/data/320193/..."
    }
  ],
  "count": 42,
  "hasMore": true
}

See each endpoint's reference page: Filings, News, Entity.

Ready to start building?

Get your free API key — 1,000 requests/month, no credit card required.

Get API Key →