# yfin

> yfin is a free hosted Yahoo Finance API for builders, apps, notebooks, services, and AI agents.

## Start Here

- [Landing page](https://yfin.dev/) - Product overview, SDK links, route families, and rate limits.
- [API reference](https://docs.yfin.dev/) - Interactive reference rendered from the live OpenAPI contract.
- [OpenAPI JSON](https://api.yfin.dev/v1/openapi.json) - Machine-readable API contract.
- [Endpoint catalog](https://api.yfin.dev/v1/endpoints) - Machine-readable endpoint list for tool discovery and code generation.
- [Health](https://api.yfin.dev/v1/health) - Service status and shipped endpoint count.

## SDKs

- [Python SDK](https://pypi.org/project/yfin/) - Native Python client for the hosted API.
- [TypeScript SDK](https://www.npmjs.com/package/@bluefin-ai/yfin) - JavaScript and TypeScript client for Node, browsers, Workers, Bun, Deno, and agent runtimes.

## Common Workflows

- Quotes: `https://api.yfin.dev/v1/quote?symbols=AAPL,MSFT`
- Historical prices: `https://api.yfin.dev/v1/history?symbol=AAPL&period=5d&interval=1d`
- Search: `https://api.yfin.dev/v1/search?q=apple`
- Options: `https://api.yfin.dev/v1/options?symbol=AAPL`
- Fundamentals: `https://api.yfin.dev/v1/fundamentals?symbol=AAPL`
- Market summary: `https://api.yfin.dev/v1/market_summary`

## Project

- [GitHub](https://github.com/bluefin-ai/yfin) - Source, SDKs, and issues.
- [Docs LLM context](https://docs.yfin.dev/llms.txt) - API-reference-focused crawler summary.