stocks tool

Partial for public keys

stocks_get_company_facts

Identity + dataset-coverage profile for one US public company.

Public-key response

Provider-licensed price coverage is omitted for public keys (reported unavailable); omitted sources are disclosed via meta.restricted_omitted.

Description

Identity + dataset-coverage profile for one US public company.

The result is the shared envelope (pagination null — a single profile). data holds the company identity (cik, name, exchange, sector, sic_code, sic_description), its tickers (each with symbol, active, and validity dates — delisted/renamed symbols included so you can recognise a historical ticker), fiscal_year_end (MM-DD of the latest annual period, or null), latest_filing_date, and a coverage summary. meta carries source and the profile's as_of.

sic_code/sic_description are the SEC's own classification from the filer's EDGAR submissions record; sector is a coarse bucket derived from it and is the same vocabulary stocks_screen filters on. All three are null for a company we have not classified yet — absence means unknown, not "unclassifiable".

coverage has one entry per dataset — financials, prices, filings — each {available, since, through}. Read it before asking for data: if coverage.prices.available is false we hold no prices for this company, and since/through bound the range you can actually request. This prevents asking for data we do not have. On the public surface, provider-licensed price coverage is omitted (reported unavailable) and the excluded sources are listed in meta.restricted_omitted.

A well-formed ticker we hold no mapping for returns unknown_entity, with Did you mean: …? suggestions when a close match exists; a string that is neither a ticker nor a CIK returns bad_parameter (use stocks_search_tickers for names).

Parameters

Input schema

NameTypeRequiredDefaultDescription
ticker_or_cikstringYesAn exact ticker ('AAPL', 'BRK.B') or a numeric SEC CIK ('320193', zero-padded accepted). For a company *name*, call stocks_search_tickers first — this tool does not fuzzy-match.

Provenance

Sources