Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.llmquantdata.com/llms.txt

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

Available as MCP tool: sec_filing_read — call directly from Claude / Cursor / any MCP client. See MCP Server for the 60-second setup.
Live   1 credit per call

​
What it does for your agent

sec_filing_read is the second step in SEC Filing’s progressive-disclosure pattern: after sec_filing_browse returns the list of filings for a ticker, use this tool to extract the full text of a specific item (Risk Factors, MD&A, Financial Statements, etc.). Pass either accession_number (recommended after browse) or year / quarter plus the item code, and the response carries the section text plus a manifest of the filing’s other sections. sec_filing_read is not semantic search: it performs parameterized lookup by (ticker, filing_type, accession_number OR year[+quarter], item) and returns the exact section text — no relevance ranking, no fuzzy matching.

​
Response

​
data
FilingReadResult
required
​
meta.count
number
Number of items returned.
​
meta.creditsUsed
number
Credits consumed (always 1).
​
meta.remainingCredits
number
Account credits remaining.
200 OK · sec_filing_read
{
  "data": {
    "ticker": "NVDA",
    "filing_type": "10-K",
    "accession_number": "0001045810-26-000021",
    "year": 2025,
    "quarter": null,
    "available_sections": [
      { "section_key": "1", "section_title": "Business", "ordinal": 1, "char_count": 48578 },
      { "section_key": "1A", "section_title": "Risk Factors", "ordinal": 2, "char_count": 32100 },
      { "section_key": "7", "section_title": "MD&A", "ordinal": 10, "char_count": 25400 }
    ],
    "items": [
      {
        "number": "1A",
        "name": "Risk Factors",
        "text": "Item 1A. Risk Factors\n\nOur business, financial condition and operating results may be materially affected by..."
      }
    ]
  },
  "meta": { "count": 1, "creditsUsed": 1, "remainingCredits": 99 }
}

​
Notes

Two-step lookup is canonical: call sec_filing_browse first (free) to get the list of filings, grab the accession_number you want, then call sec_filing_read (1 credit) with that accession + a specific item. This avoids ambiguity around period_of_report vs filed_at years for 10-Q.
Inspect available_sections[i].char_count before pulling more sections — long items (Risk Factors, MD&A) can be tens of thousands of characters. Read one section per call to keep agent context small.
10-K and 10-Q use completely different item code systems — see the parameter reference below. Mixing them returns 400.
For 10-Q, year alone is not enough — you must pass either year + quarter, or accession_number. year for 10-Q without quarter returns 400.
Plain-text output only. HTML / structured tables are not exposed by this tool. Very recently filed reports may briefly return “Processing” while sec-api.io indexes them.

​
Direct invocation

// 1) Browse to get the list of filings
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_browse",
    "arguments": { "ticker": "NVDA", "filing_type": "10-K", "limit": 5 }
  }
}

// 2) Read Risk Factors (item 1A) from the latest 10-K
{
  "method": "tools/call",
  "params": {
    "name": "sec_filing_read",
    "arguments": {
      "ticker": "NVDA",
      "filing_type": "10-K",
      "accession_number": "0001045810-26-000021",
      "item": "1A"
    }
  }
}

​
Full parameter reference

​
ticker
string
required
U.S. equity ticker (e.g. AAPL, NVDA, META).
​
filing_type
string
required
Filing type — 10-K or 10-Q.
​
year
integer
Calendar year of period_of_report. Required for 10-K when accession_number is omitted; required together with quarter for 10-Q when accession_number is omitted.
​
quarter
integer
Quarter of period_of_report (1-4). Only used for 10-Q. Required when looking up a 10-Q by year (without accession_number).
​
item
string
Specific section to extract. Omit to return every extractable section.10-K item codes: 1, 1A, 1B, 1C, 2, 3, 4, 5, 6, 7, 7A, 8, 9, 9A, 9B, 10, 11, 12, 13, 14, 15.10-Q item codes: part1item1, part1item2, part1item3, part1item4, part2item1, part2item1a, part2item2, part2item3, part2item4, part2item5, part2item6.Common picks: 10-K 1 (Business) · 1A (Risk Factors) · 7 (MD&A) · 8 (Financial Statements) · 10 (Directors / Officers); 10-Q part1item1 (Financial Statements) · part1item2 (MD&A) · part2item1a (Risk Factors).
​
accession_number
string
Exact SEC accession number (e.g. 0001045810-26-000021). Recommended after sec_filing_browse. Cannot be combined with year or quarter.

SEC Filing Browse

Step 1 — list available filings for a ticker before calling read.

13F Holdings by Manager

Institutional ownership data — a different SEC filing family (Form 13F).

MCP Server setup

Connect Claude / Cursor / any harness in 60 seconds.