# TickerFacts

> US public-company fundamentals from SEC EDGAR filings: revenue, earnings, balance sheet, margins, and growth, as web pages, a screener, and a JSON API. Fundamentals only (no market prices). Not financial or investment advice or a recommendation to buy, sell or hold. For research and education only; verify dates and primary sources. Figures may contain errors; terms of use: https://tickerfacts.com/terms

URL patterns: company pages are https://tickerfacts.com/stocks/{TICKER}, metric histories https://tickerfacts.com/stocks/{TICKER}/{METRIC}, JSON https://tickerfacts.com/api/v1/companies/{TICKER}. The MCP tool server (Streamable HTTP, no auth) is at https://tickerfacts.com/mcp. The same tools are A2A skills: Agent Card at https://tickerfacts.com/.well-known/agent-card.json, JSON-RPC at https://tickerfacts.com/a2a/v1. OpenAPI 3.1: https://tickerfacts.com/openapi.json. No key is needed; a free key (POST https://tickerfacts.com/api/v1/keys with {"email": ...}, sent as Authorization: Bearer) raises the agent rate limit.

## Data access

- [Company page (example: AAPL)](https://tickerfacts.com/stocks/AAPL): annual fundamentals for one company, from its SEC filings
- [Metric history (example: AAPL revenue)](https://tickerfacts.com/stocks/AAPL/revenue): one metric by actual period end with compatible YoY change
- [Screener](https://tickerfacts.com/screener): filter US companies by revenue, margins, ROE, and growth
- [JSON API (example: AAPL)](https://tickerfacts.com/api/v1/companies/AAPL): the same data as JSON, with per-year margins, return on equity, leverage and growth, and notes on years not comparable with the year before; preferred for programmatic and agent use
- [Company search (example: apple)](https://tickerfacts.com/api/v1/search?query=apple): ticker, CIK and listing status by name or ticker, forgiving typos; MCP search_companies
- [Compact multi-company JSON](https://tickerfacts.com/api/v1/companies?tickers=MSFT,GOOGL,AMZN&periods=1&metrics=revenue,operating_income): up to 20 tickers per request, with explicit per-ticker errors; MCP get_fundamentals_batch
- [Cash-flow inputs (example: MSFT)](https://tickerfacts.com/api/v1/valuation/MSFT): operating cash flow, capex, net income and share count per period with source filings; observations only, no fair value; MCP get_cashflow_inputs
- [County context (example: Travis, Texas)](https://tickerfacts.com/api/v1/counties/48453): Census ACS characteristics with 90% margins of error and BLS QCEW private-industry jobs and pay, by FIPS code or name; MCP get_county_context
- [Developer and agent guide](https://tickerfacts.com/developers): JSON API and MCP setup, with copy-paste client configs
- Feedback from agents: MCP send_feedback, or POST https://tickerfacts.com/api/v1/feedback with {"kind": ..., "summary": ...}; report missing or wrong data, confusing responses and what would solve your user's task. Every report is read.
- [Sitemap](https://tickerfacts.com/sitemap.xml): every company page

## Notes

- Sources: public SEC EDGAR filings; Census ACS, BLS QCEW, Treasury and BLS series for context data.
- Text and data mining is permitted (TDMRep: https://tickerfacts.com/.well-known/tdmrep.json).
- For bulk or automated access, use the JSON API rather than scraping HTML.