SEC EDGAR
FinanceUSdata.sec.gov
US company filings and XBRL facts: every submission, every reported financial concept, by CIK.
Capabilities (8)
GET /v1/data/sec/companyconcept1 creditReturns the full reported history of a single us-gaap line item for one company (every value, period, form and accession) instead of the whole facts blob.
GET /v1/data/sec/companyfacts1 creditReturns every XBRL fact the company has ever reported, grouped by taxonomy (us-gaap, dei, ifrs-full) then by tag then by unit, each value carrying its period, fiscal year/quarter, form and accession number.
GET /v1/data/sec/company-tickers1 creditReturns the SEC's master list of exchange-listed companies as an object of {cik_str, ticker, title} records, about 10,000 rows.
GET /v1/data/sec/company-tickers-exchange1 creditReturns the same ticker-to-CIK mapping in a compact columnar form (fields [cik, name, ticker, exchange] and an array of rows), adding the listing venue (Nasdaq, NYSE, CBOE, OTC).
GET /v1/data/sec/filing-index1 creditReturns the EDGAR archive directory listing for a single filing: every document in it with name, type and last-modified time, so you can locate the exhibits, the XBRL instance or the primary HTML.
GET /v1/data/sec/frames1 creditReturns one us-gaap concept in USD for every company that reported it in a given period: a cross-sectional frame of CIK, entity name, value and accession, suitable for ranking or screening.
GET /v1/data/sec/mutual-fund-tickers1 creditReturns the mapping of registered fund tickers to their CIK, series id (S000…) and class id (C000…) in columnar [cik, seriesId, classId, symbol] form.
GET /v1/data/sec/submissions1 creditReturns an issuer's EDGAR profile (name, tickers, exchanges, SIC, EIN, addresses, former names) plus the most recent ~1000 filings as parallel arrays of accession number, form type, filing date and primary document.
Response example
The shape of data from sec/companyconcept (One XBRL concept for a company). A sample, not live data.
{
"cik": 320193,
"taxonomy": "us-gaap",
"tag": "RevenueFromContractWithCustomerExcludingAssessedTax",
"label": "Revenue from Contract with Customer, Excluding Assessed Tax",
"description": "Amount, excluding tax collected from customer, of revenue from satisfaction of performance obligation by transferring promised good or service to customer. Tax collected from customer is tax assessed by governmental authority that is both imposed on and concurrent with specific revenue-producing tra…",
"entityName": "Apple Inc.",
"units": {
"USD": [
{
"start": "2016-09-25",
"end": "2017-09-30",
"val": 229234000000,
"accn": "0000320193-19-000119",
"fy": 2019,
"fp": "FY",
"form": "10-K",
"filed": "2019-10-31",
"frame": "CY2017"
},
{
"start": "2017-10-01",
"end": "2017-12-30",
"val": 88293000000,
"accn": "0000320193-19-000010",
"fy": 2019,
"fp": "Q1",
"form": "10-Q",
"filed": "2019-01-30"
},
"… 115 more items"
]
}
}Ask with this source
A prompt for your agent that names this source and how to call it through the crw MCP.
One XBRL concept for a company
Use SEC EDGAR (sec) from fastCRW Pergamon, capability "One XBRL concept for a company" (companyconcept). You want one specific financial metric over time for one company and do not want to download several megabytes of facts. Example options: cik=0000320193, concept=RevenueFromContractWithCustomerExcludingAssessedTax. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "companyconcept". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
All XBRL facts for a company
Use SEC EDGAR (sec) from fastCRW Pergamon, capability "All XBRL facts for a company" (companyfacts). You want a company's whole reported financial history in one call and will pick the line items yourself. Example options: cik=0000320193. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "companyfacts". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Ticker to CIK map
Use SEC EDGAR (sec) from fastCRW Pergamon, capability "Ticker to CIK map" (company-tickers). You hold a ticker or a company name and need the CIK that every other SEC capability requires. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "company-tickers". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Ticker to CIK map with exchange
Use SEC EDGAR (sec) from fastCRW Pergamon, capability "Ticker to CIK map with exchange" (company-tickers-exchange). You need ticker-to-CIK resolution and also care which exchange the security trades on. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "sec" and capability "company-tickers-exchange". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Licence
A work of the United States Government, not subject to domestic copyright under 17 U.S.C. 105, published by the agency as open data.
https://www.sec.gov/about/privacy-information#securityAttribution
Display this wherever you show the data. It arrives on every response as provenance.attribution_text.
Source: U.S. Securities and Exchange Commission, EDGAR
Cache: up to 3600s
