# Financial Datasets

> Financial Datasets is a developer-friendly REST API providing institutional-grade stock market data for AI agents, quantitative research, and financial applications.

Financial Datasets covers 17,325+ tickers with 30+ years of historical data, sub-200ms response times, and 99.98% uptime. Subscription plans start at $200/mo (Developer) with per-request pricing from $0.00 to $0.10 depending on the endpoint. All endpoints use simple GET/POST requests with API key authentication.

Common use cases: AI agent tool use, financial modeling, quantitative analysis, backtesting, portfolio analytics, and building fintech products.

## Base URL & Authentication

Base URL: https://api.financialdatasets.ai

OpenAPI Spec: https://financialdatasets.ai/openapi.json

Authentication: Include your API key in the `X-API-Key` header with every request.

Example:
```
curl -H "X-API-Key: YOUR_API_KEY" https://api.financialdatasets.ai/prices?ticker=AAPL&interval=day&interval_multiplier=1&start_date=2024-01-01&end_date=2024-12-31
```

## Endpoints

### Stocks

| Endpoint | Path | Method | Price |
|---|---|---|---|
| Earnings | /earnings | GET | $0.00 / request |
| Stock Prices | /prices | GET | $0.01 / request |
| Financial Metrics | /financial-metrics | GET | $0.02 / request |
| Insider Trades | /insider-trades | GET | $0.02 / request |
| News | /news | GET | $0.02 / request |
| Institutional Holdings | /institutional-ownership | GET | $0.02 / request |
| SEC Filings | /filings | GET | $0.02 / request |
| Segmented Financials | /financials/segmented-revenue | GET | $0.02 / request |
| Analyst Estimates | /analyst-estimates | GET | $0.04 / request |
| Income Statements | /financials/income-statements | GET | $0.04 / request |
| Balance Sheets | /financials/balance-sheets | GET | $0.04 / request |
| Cash Flow Statements | /financials/cash-flow-statements | GET | $0.04 / request |
| All Financial Statements | /financials | GET | $0.10 / request |
| Search | /financials/search | POST | $0.01 per 10 filters |

### Crypto

| Endpoint | Path | Method | Price |
|---|---|---|---|
| Crypto Prices | /crypto/prices | GET | $0.01 / request |

### Macroeconomics

| Endpoint | Path | Method | Price |
|---|---|---|---|
| Interest Rates | /macro/interest-rates | GET | $0.01 / request |

## Subscription Plans

### Developer — $200/mo ($2,000/yr)
- Individual license
- 1,000 requests / minute
- All core data endpoints
- 30+ years historical data
- 100% market coverage

### Pro — $2,000/mo ($20,000/yr)
- Professional license
- Unlimited API requests
- Data redistribution rights
- Webhooks
- Early access program
- All Developer features

### Enterprise — Custom pricing
- Enterprise license
- Uptime SLAs
- Dedicated infrastructure
- Advanced security controls
- Audit logs
- Custom data feeds
- Historical backfill delivery
- Dedicated account manager
- Private Slack channel
- All Pro features

Contact: support@financialdatasets.ai

## Per-Request Pricing Summary

| Price | Endpoints |
|---|---|
| $0.00 | Earnings |
| $0.01 | Stock Prices, Crypto Prices, Interest Rates, Search (per 10 filters) |
| $0.02 | Financial Metrics, Insider Trades, News, Institutional Holdings, SEC Filings, Segmented Financials |
| $0.04 | Analyst Estimates, Income Statements, Balance Sheets, Cash Flow Statements |
| $0.10 | All Financial Statements (bundled) |

## Key Statistics

- 30+ years of historical fundamentals and KPIs
- 17,325+ stocks covered
- < 200ms update frequency
- 99.98% uptime and availability

## Links

- OpenAPI Spec: https://financialdatasets.ai/openapi.json
- Website: https://financialdatasets.ai
- API Docs: https://docs.financialdatasets.ai/introduction
- Pricing: https://financialdatasets.ai/pricing
- Support: support@financialdatasets.ai
- Twitter: https://x.com/findatasets