# Finnhub

> Free realtime API for stocks, forex, and cryptocurrency: real-time quotes and candles, company fundamentals, estimates, ownership, filings, transcripts, ETFs/mutual funds/bonds/indices, economic data, and alternative datasets. REST base URL https://finnhub.io/api/v1 plus a real-time WebSocket at wss://ws.finnhub.io. All requests are authenticated with an API key passed as the `token` query parameter or the `X-Finnhub-Token` header (free key via https://finnhub.io/register). A hard cap of 30 API calls/second applies on top of per-plan limits; HTTP 429 signals a breached limit.

Generated by API Evangelist from the Finnhub catalog entry (method: generated — Finnhub publishes no llms.txt; /llms.txt returns the HTML site shell).

## APIs

- [API Documentation](https://finnhub.io/docs/api): full REST reference — stocks, forex, crypto, fundamentals, estimates, filings, economy, alternative data (117 operations)
- [Official Swagger 2.0 spec](https://finnhub.io/static/swagger.json): machine-readable contract published by Finnhub
- [WebSocket trades](https://finnhub.io/docs/api/websocket-trades): real-time trades for US stocks, forex, and crypto (1 connection per API key)
- [WebSocket news](https://finnhub.io/docs/api/websocket-news): real-time news for US and Canadian stocks (Premium)
- [WebSocket press releases](https://finnhub.io/docs/api/websocket-press-releases): real-time press releases for global companies (Enterprise)

## Specs

- [OpenAPI (official Swagger 2.0, 117 ops)](https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/openapi/finnhub-swagger-original.json)
- [AsyncAPI 2.6 for the WebSocket streams](https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/asyncapi/finnhub-asyncapi.yml)
- [MCP profile (community server + candidate tools)](https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/mcp/finnhub-mcp.yml)
- [Tool crosswalk (MCP tools -> REST operationIds)](https://raw.githubusercontent.com/api-evangelist/finnhub/refs/heads/main/mcp/finnhub-tool-crosswalk.yml)

## Docs

- [Authentication](https://finnhub.io/docs/api/authentication): token query param or X-Finnhub-Token header
- [Rate limits](https://finnhub.io/docs/api/rate-limit): plan limits + 30 calls/second cap; 429 on breach
- [Libraries](https://finnhub.io/docs/api/library): official Python, Go, JavaScript, Ruby, Kotlin, PHP clients
- [Open data](https://finnhub.io/docs/api/open-data): bulk Kaggle datasets (SEC financials, filings metadata, S&P 500 futures ticks)
- [Pricing](https://finnhub.io/pricing)
- [Sign up](https://finnhub.io/register)
- [Terms of service](https://finnhub.io/terms-of-service)
- [GitHub organization](https://github.com/Finnhub-Stock-API)