# yfin API

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

## API contract

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

## Common routes

- 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