SEC EDGAR API
SEC EDGAR API: public companies’ filings as structured facts
RoboSystems serves the XBRL filings of more than 8,000 public companies as one graph: every reported number with its concept, period and breakdown, and the text of each filing. Read it over a REST API, or let Claude, ChatGPT or any MCP client read it for you.
14-day trial on either plan, no card to start. Then $29 or $99 a month.
What it covers
- Annual and quarterly reports (10-K, 10-Q, 20-F and 40-F) filed since January 2024, with every number tagged in them.
- Each filing's text, searchable across filers and readable whole: annual reports back to 2015, and earnings releases filed on 8-K since 2024, with their exhibits.
- Updated every weekday. The graph is read-only and shared: every subscriber reads the same filings.
SEC filings API: seven ready-made operations
Seven operations answer the common questions without writing a query. Each is a REST operation at POST /extensions/roboledger/sec/operations/{name} and an MCP tool of the same name.
| financial-statement-analysis | One company's income statement, balance sheet, cash flow or equity statement, by ticker |
| build-fact-grid | Chosen concepts across companies, periods and dimensions, deduplicated |
| disclosures | The map of a filing's sections: one row per note or statement |
| information-block | One section read whole: its rows, breakdowns, calculation footing and text |
| describe-filing | How one filing is laid out: periods, statements, notes and its Items |
| search-text | Every place one filing's whole text says something |
| read-text | A window of a filing's whole text from an offset |
A company's latest annual income statement:
curl -X POST "https://api.robosystems.ai/extensions/roboledger/sec/operations/financial-statement-analysis" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"statement_type": "income_statement", "ticker": "NVDA", "period_type": "annual"}'Where its latest 10-K mentions export controls, exhibits included:
curl -X POST "https://api.robosystems.ai/extensions/roboledger/sec/operations/search-text" \
-H "X-API-Key: $ROBOSYSTEMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ticker": "NVDA", "query": "export control*"}'Once a plan has started, Cypher queries run against the graph directly at POST /v1/graphs/sec/query/cypher. Request and response schemas are in the extensions reference.
SEC EDGAR MCP server for Claude, ChatGPT and any client
- Claude: add RoboSystems SEC from Claude's connector directory and sign in.
- ChatGPT: install RoboSystems from ChatGPT's plugin directory and sign in.
- Any MCP client: add the SEC graph's address. The client runs the sign-in.
https://api.robosystems.ai/v1/graphs/sec/mcpReading the SEC graph through an MCP client uses no RoboSystems credits. The reasoning happens in your AI client; RoboSystems returns the data. Setup for each client →
EDGAR XBRL data, with the rules that make a number right
Raw EDGAR XBRL leaves four traps to the reader. The graph and its tools handle them, and the model is told the rules:
- Totals or breakdowns. Consolidated totals come back unless you ask for segments, so breakdowns aren't added to the total twice.
- The same concept, different tags. Companies tag revenue several ways. A comparison names each company's own tag, and a phrase like "operating lease liability" resolves to the tags filers actually use.
- Flows and balances. Revenue covers a period; assets are a point in time. They aren't mixed.
- Fiscal years differ. Periods keep their real dates, so a fiscal year that ends in January compares correctly with one that ends in December.
Every operation that resolves a filing names the one it picked and returns links: the filing in a viewer, the document as filed, and its EDGAR folder. A number is never a step away from its source.
How fresh it is
New filings arrive on weekdays. A new 10-K or 10-Q can be read whole the day it's filed, and an 8-K earnings release within about half an hour during the US business day. Its figures reach statements, comparisons and queries the next morning, after the nightly rebuild.
Plans and the free trial
- Starter, $29 a month: API and MCP access at standard rate limits, and one download of the whole graph a month.
- Advanced, $99 a month: five times the rate limits, and four downloads a month.
Your first subscription starts with a 14-day trial of the plan you pick, with no card needed to start it. The analysis operations, search and the download are open during the trial, at lower limits. Direct Cypher queries, the AI analyst and the plan's monthly AI credits open with the first payment. Without a card, the trial simply ends and nothing is charged. See pricing →
Download the whole graph, or run it yourself
Subscribers can pull the repository down as a single LadybugDB file and query it locally. A point-in-time copy of the same graph is published on Hugging Face under CC BY 4.0, with no subscription; it trails the hosted graph and leaves out the filing text and search.
RoboSystems is open source (Apache 2.0 and MIT), so you can also run the platform yourself and load the filings you need. To read one filing at a time in the browser, with no account, xbrlkit is free.
The SEC repository is one of three kinds of graph on the platform, beside your own ledger and graphs you model yourself. What a knowledge graph for finance is →