Introducing EarningsBench: we tested 6 LLMs on SEC filing extraction. [Learn more.](https://www.financialdatasets.ai/blogs/earningsbench)

FINANCIAL DATASETS
Products:
  [Financial Statements](https://docs.financialdatasets.ai/api/financials/income-statements)
  [Stock Prices](https://docs.financialdatasets.ai/api/prices/historical)
  [SEC Filings](https://docs.financialdatasets.ai/api/filings/ticker)
  [Insider Trades](https://docs.financialdatasets.ai/api/insider-trades/insider-trades)
  [Institutional Ownership](https://docs.financialdatasets.ai/api/institutional-ownership/ticker)
  [Earnings](https://docs.financialdatasets.ai/api/earnings/earnings)
Developers:
  [Docs](https://docs.financialdatasets.ai/introduction)
  [Quickstart](https://docs.financialdatasets.ai/quickstart)
  [MCP Server](https://docs.financialdatasets.ai/mcp-server)
  [OpenAPI Spec](https://www.financialdatasets.ai/openapi.json)
  [llms.txt](https://www.financialdatasets.ai/llms.txt)
  [Support](mailto:support@financialdatasets.ai)
Resources:
  [Blog](https://www.financialdatasets.ai/blogs)
  [Pricing](https://www.financialdatasets.ai/pricing)
  [Contact](https://www.financialdatasets.ai/contact)
[LOG IN](https://www.financialdatasets.ai/login)
[SIGN UP](https://www.financialdatasets.ai/register)

# Connect your agent to the stock market

The stock market API built for AI agents. Real-time and historical financial data for 27,000+ US tickers over 30+ years, served as structured JSON from one REST API.

[GET AN API KEY](https://www.financialdatasets.ai/login)
[READ THE DOCS](https://docs.financialdatasets.ai/introduction)

## What this is

Financial Datasets is a REST API for US stock market data. Base URL: https://api.financialdatasets.ai. Every endpoint returns JSON and authenticates with an X-API-KEY header. Sign up at [financialdatasets.ai/register](https://www.financialdatasets.ai/register) and copy your key from the dashboard.

## Coverage

- 27,000+ active and delisted US tickers. Delisted companies are included, so datasets are survivorship-bias-free for backtesting.
- 100% of US public companies: every company that files with the SEC.
- 30+ years of fundamentals: income statements, balance sheets, and cash flow statements dating back to the early 1990s.
- Real-time ingestion: SEC filings are processed within seconds of publication.
- Not covered yet: non-US markets, options, indices, and currencies.

Full details: [market coverage](https://docs.financialdatasets.ai/market-coverage).

## Where the data comes from

Fundamentals, SEC filings, insider transactions, and institutional holdings are parsed directly from SEC EDGAR without intermediaries. Stock prices come from NYSE, NASDAQ, and ARCA via Databento. Details: [data provenance](https://docs.financialdatasets.ai/data-provenance).

## API endpoints

- [Financial Statements](https://docs.financialdatasets.ai/api/financials/income-statements): income statements, balance sheets, and cash flow statements. Normalized, as-reported, and segmented variants. GET /financials/income-statements, /financials/balance-sheets, /financials/cash-flow-statements.
- [Financial Metrics](https://docs.financialdatasets.ai/api/financial-metrics/snapshot): valuation, profitability, and growth ratios. Historical and real-time snapshot.
- [Stock Prices](https://docs.financialdatasets.ai/api/prices/historical): historical OHLCV plus real-time company and market snapshots. GET /prices, /prices/snapshot.
- [SEC Filings](https://docs.financialdatasets.ai/api/filings/ticker): full filings plus item-level extraction for 10-K, 10-Q, and 8-K (for example item 1A Risk Factors). GET /filings, /filings/items.
- [Insider Trades](https://docs.financialdatasets.ai/api/insider-trades/insider-trades): Forms 3, 4, and 5, plus insider ownership.
- [Institutional Ownership](https://docs.financialdatasets.ai/api/institutional-ownership/ticker): 13F holdings by investor or by ticker, plus activist and beneficial ownership.
- [Earnings](https://docs.financialdatasets.ai/api/earnings/earnings): earnings results and press releases, plus KPI metrics, forward guidance, and non-GAAP metrics.
- [Stock Screener](https://docs.financialdatasets.ai/api/financials/search-screener): POST /financials/search/screener, plus line-item search across statements.
- [Company News](https://docs.financialdatasets.ai/api/news/company): ticker-attributed company and market news.
- [Index Funds](https://docs.financialdatasets.ai/api/index-funds/ticker): ETF and index fund holdings, and funds by holding.
- [IPOs](https://docs.financialdatasets.ai/api/ipos/ipos): IPO filings.
- [Interest Rates](https://docs.financialdatasets.ai/api/macro/interest-rates/historical): central bank rates (FED, ECB, BOJ, and more).

Complete API map: [llms.txt](https://www.financialdatasets.ai/llms.txt). Machine-readable spec: [openapi.json](https://www.financialdatasets.ai/openapi.json). Every docs page is fetchable as raw markdown by appending .md to its URL.

## Conventions

- Tickers are uppercase symbols (AAPL, MSFT, SPY). Many endpoints accept ticker or cik.
- Dates use YYYY-MM-DD, with _gte, _lte, _gt, and _lt filter operators on fields like report_period and filing_date.
- period is annual, quarterly, or ttm. limit controls the number of results.
- Discover covered tickers by appending /tickers to most endpoints, for example GET /financials/tickers.

## Quick start

```bash
curl -H "X-API-KEY: YOUR_API_KEY" \
  "https://api.financialdatasets.ai/financials/income-statements?ticker=AAPL&period=annual&limit=4"
```

Setup takes about 30 seconds: create an account, copy your API key from the dashboard, and include it in the X-API-KEY header. Full walkthrough with Python and JavaScript examples: [quickstart](https://docs.financialdatasets.ai/quickstart).

## MCP server

Connect any MCP client to https://mcp.financialdatasets.ai/ (OAuth) or https://mcp.financialdatasets.ai/api with an X-API-KEY header. Works with Claude, Claude Code, Cursor, and the MCP SDKs. Tools cover prices, financial statements, metrics, filings, ownership, news, and screening. Setup guides: [MCP server docs](https://docs.financialdatasets.ai/mcp-server).

```bash
claude mcp add --transport http financial-datasets https://mcp.financialdatasets.ai/
```

## Pricing

- Credits: $20 one-time for 1,000 requests. All core data endpoints, real-time data, 1 year of history.
- Build: $200/month for 100,000 requests. All core data endpoints, real-time data, 30+ years of history.
- Scale: custom request volume. Adds earnings KPIs and guidance, webhooks, zero data retention, and uptime SLAs.

Details and FAQs: [financialdatasets.ai/pricing](https://www.financialdatasets.ai/pricing).

## Machine-readable resources

- API map: [https://www.financialdatasets.ai/llms.txt](https://www.financialdatasets.ai/llms.txt)
- OpenAPI spec: [https://www.financialdatasets.ai/openapi.json](https://www.financialdatasets.ai/openapi.json)
- Docs index for LLMs: [https://docs.financialdatasets.ai/llms.txt](https://docs.financialdatasets.ai/llms.txt)
- MCP server: https://mcp.financialdatasets.ai/
- Markdown mirrors: every page on this site is available as plain markdown. Append .md to the path (/pricing.md, /blogs.md, /contact.md, /blogs/<slug>.md). This homepage is /index.md.
- Support: [support@financialdatasets.ai](mailto:support@financialdatasets.ai) or [Discord](https://discord.gg/hTtb8wzgSQ)

Latest updates

March 29
[WE TESTED 6 LLMS ON SEC FILING EXTRACTION](https://www.financialdatasets.ai/blogs/earningsbench)

March 26
[ANNOUNCING OUR PARTNERSHIP WITH JULIUS](https://www.financialdatasets.ai/blogs/julius-ai-partnership)

CONTACT
  [support@financialdatasets.ai](mailto:support@financialdatasets.ai)

LEGAL
  [Terms of Service](https://www.financialdatasets.ai/terms-of-use)
  [Privacy Policy](https://www.financialdatasets.ai/privacy-policy)
  [Subprocessors](https://www.financialdatasets.ai/subprocessors)

[X / TWITTER](https://x.com/findatasets)

Financial Datasets, Inc. 2026