# Financial Datasets (slim)

> Financial Datasets is a stock market data API built for AI agents, with financial statements, SEC filings, earnings, insider and institutional holdings, prices, news and macro series for 27,000 US tickers, through REST, x402 and a hosted MCP server.

- Full: https://www.anchorterminal.com/tools/financial-datasets.md (~8,350 tokens) · this version ~2,030 tokens · JSON https://www.anchorterminal.com/tools/financial-datasets.json · canonical https://www.anchorterminal.com/tools/financial-datasets
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-04 · pricing https://www.anchorterminal.com/tools/financial-datasets#pricing · reviews https://www.anchorterminal.com/tools/financial-datasets#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**C · 61.8/100 · rank #492 of 1349 · #3 in Financial market data · not agent-ready · confidence medium**


Assessment: Every documented GET data endpoint takes x402 with no key, failed calls uncharged, and an agent can open and fund an account by API. A public OpenAPI file, llms.txt and a 28-tool OAuth MCP server cover the same data. There is no status page or free tier, keyed rate limits aren't published, and x402 data stops at 365 days.

## Facts

- Kind: HTTP API · vendor: Financial Datasets, Inc. · category: Financial market data · legal entity: Financial Datasets, Inc. · provenance 65/100
- Endpoint: `https://api.financialdatasets.ai` (HTTP, Streamable HTTP)
- Auth: OAuth or key · pricing: Pay per use · x402: yes, from $0.02/call · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Surface listed: The REST API at api.financialdatasets.ai with its x402 route, read from docs.financialdatasets.ai (llms.txt and Markdown pages), the OpenAPI file, financialdatasets.ai (pricing, news, terms, privacy, subprocessors), the MCP server's OAuth metadata, PyPI and the Y Combinator company page on 3 November 2026, with the hosted MCP server noted. One unauthenticated GET was made to read the 402 terms; no payment was made, no account was opened and no MCP session was started
- Plans: Credits $20 one-off for 1,000 requests. Personal $200 a month, 100,000 requests, overage $10 per 1,000, cap 1 million. Professional $2,000 a month, 2 million requests, overage $5 per 1,000, cap 10 million, commercial licence, redistribution, webhooks, uptime SLAs. Enterprise custom with bulk delivery and zero data retention
- x402: Version 2, scheme exact, USDC on Base, 300-second timeout, price per endpoint in the 402 header, 10,000 requests a minute per wallet, last 365 days, Non-Professional use. Not covered are /filings/items, /prices/snapshot/market and the POST endpoints, while /prices/tickers and /macro/inflation/series are free
- Agent onboarding: POST /agent/signup with email and agent_name returns a key once (201); POST /agent/checkout-link with the key returns a Stripe Checkout URL valid 24 hours, minimum $20, optional auto-refill; the owner's email receives a confirmation and signing into the dashboard before confirming revokes the key
- Coverage: 27,530 US tickers including delisted, 30 years of fundamentals; UK (674 companies) and France (376) annual fundamentals; India dated 23 October 2026, Japan 6 November and South Korea 13 November on the coverage page
- MCP tools: 28, among them get_income_statement, get_balance_sheet, get_cash_flow_statement, get_financial_metrics, get_earnings, get_filings, get_filing_items, get_insider_trades, get_institutional_holdings, get_stock_prices, get_news, get_macro_data, screen_stocks
- Data sources: SEC EDGAR parsed by the vendor for statements, filings, insider and 13F data; Databento for stock prices
- Legal entity: Financial Datasets, Inc., New York law, per the terms of 29 October 2026
- Prices: Earnings, over x402 $0.02 per call; Credits pack $20 per 1,000 requests; Personal plan $200 per month (plan); Professional plan $2000 per month (plan)

- Scores: Reliability 43, Performance pending, Schema & documentation 80, Agent ergonomics 73, Security & auth 49, Payments & pricing 75, Task success pending, Maintenance & community 56, Transparency & trust 63 · total over the 7 assessed categories
- Why: Reliability, Graded as a hosted service. · Schema & documentation, OpenAPI 3.0.1 at financialdatasets.ai/openapi.json, 68 operations with 13 response codes and one security scheme, named the source of truth… · Agent ergonomics, `limit` and `period` on the data endpoints, `as_reported` flags and snapshot variants, with no field selection (15 of 25). · Security & auth, A plain account key in the `X-API-KEY` header only, revoked from the dashboard, with no scopes, rotation or expiry; the MCP server adds OAut… · Payments & pricing, x402 on the vendor's own endpoints for every documented GET data endpoint, 36 of them, with the last 365 days only and a Non-Professional li… · Maintenance & community, UK fundamentals went live on 26 October 2026, India on 23 October, with Japan and South Korea dated for November on the coverage page (30). · Transparency & trust, A closed service under terms dated 29 October 2026 that name Financial Datasets, Inc., set New York law, and state the licence per plan (15…
- Sources: 22, open questions: 6, both in the full twin
- Capabilities: market.fundamentals, market.filings, market.prices, market.history, market.news, market.indices, data.markets, data.company
- JSON: https://www.anchorterminal.com/api/v1/tools/financial-datasets.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/financial-datasets.svg` or a link to https://www.anchorterminal.com/tools/financial-datasets from a page on financialdatasets.ai or one of its subdomains, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: https://docs.financialdatasets.ai/; https://www.financialdatasets.ai/contact; more in the full twin

## Before you call it

1. Without a key, read the price from the PAYMENT-REQUIRED header of the 402 and pay with x402 on Base; each page of `next_page_url` is a separate paid request
2. Keep `limit` small and ask for one `period` at a time; premium endpoints count as 2, 4 or 8 requests on keyed plans
3. Send the key only to api.financialdatasets.ai in the `X-API-KEY` header; on 401 ask the owner for a new key rather than signing up again
4. Treat a 402 on a keyed account as an empty balance and mint a checkout link for the owner; don't retry the call
5. Check the plan's licence before showing the data to anyone else; redistribution needs Professional or Enterprise

## Connect

```bash
pip install financial-datasets
```

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

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

x402:

```bash
curl -i "https://api.financialdatasets.ai/earnings?ticker=NVDA&limit=4"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/financial-datasets

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| EODHD | C | 59 | market.history, market.prices, market.fundamentals, market.filings, market.news, market.indices, data.markets, data.company | https://www.anchorterminal.com/tools/eodhd.min.md |
| Intrinio | C | 54.2 | market.prices, market.fundamentals, market.filings, market.news, market.history, market.indices, data.markets, data.company | https://www.anchorterminal.com/tools/intrinio.min.md |
| Financial Modeling Prep | D | 48.7 | market.fundamentals, market.prices, market.history, market.filings, market.news, market.indices, data.company, data.markets | https://www.anchorterminal.com/tools/financial-modeling-prep.min.md |
| Finnhub | E | 45.1 | market.prices, market.fundamentals, market.news, market.filings, market.history, market.indices, data.markets, data.company | https://www.anchorterminal.com/tools/finnhub.min.md |
| Twelve Data | BB | 70 | market.prices, market.history, market.fundamentals, market.indices, market.news, market.filings, data.markets | https://www.anchorterminal.com/tools/twelve-data.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)