Skip to main content

Getting Started

yfin is a hosted Yahoo Finance API and yfinance-compatible SDK built for builders, services, notebooks, and agents. Use it as a drop-in Python migration path from yfinance, or call the REST API directly with public limits up to 40 requests/second anonymously and 200 requests/second with a contact identity.

pip install yfin
import yfin as yf

aapl = yf.Ticker("AAPL")
print(aapl.history(period="5d", interval="1d"))
print(aapl.fast_info)

What To Read First​

  • Quickstart for the shortest path from install to data.
  • Concepts for symbols, data freshness, historical prices, adjustments, market hours, and missing data.
  • Guides for common workflows such as quotes, charts, options, fundamentals, screeners, and AI agents.
  • Python SDK for yfinance-compatible calls and low-level client use.
  • TypeScript SDK for JavaScript and TypeScript apps.
  • REST API for direct hosted API requests.
  • API Reference for endpoint schemas, examples, and error bodies.
  • Errors and Rate Limits for production handling.
  • yfin vs yfinance for a direct comparison.

Public Endpoints​

  • Hosted API: https://api.yfin.dev
  • OpenAPI: https://api.yfin.dev/v1/openapi.json
  • Endpoint catalog: https://api.yfin.dev/v1/endpoints
  • Health: https://api.yfin.dev/v1/health
  • LLM index: https://docs.yfin.dev/llms.txt