# FinanceData/FinanceDataReader

Financial data reader

Repository: https://github.com/FinanceData/FinanceDataReader
Canonical: https://ross.abutalabs.com/products/financedatareader
Language: Python
License: MIT
License Family: permissive
Topics: krx, financedata, financial-data-reader, stock-price, btc, kospi, symbol, stock-prices
Last push: 2026-05-13T19:12:11+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 82, release rhythm 35, longevity 100
- inputs: {"age_days": 3058, "days_push": 112, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1535, forks 407 (observed 2026-08-28T04:04:59.806298+00:00)

## What it is
FinanceDataReader is a Python library and CLI tool for reading financial data such as stock listings, stock prices, indexes, exchange rates, and cryptocurrency prices from Korean and global markets. It crawls data from sources like KRX, Naver, and FRED and returns it as pandas DataFrames.

## Use cases
- download korean stock price data for samsung electronics
- list all kospi or nasdaq listed symbols
- fetch usd/krw exchange rate history
- get bitcoin price data in python
- pull kospi index historical prices
- export stock listings to csv from the terminal
- read financial statements from naver finance

## When to choose
- you need Korean market (KRX/KOSPI/KOSDAQ) data in pandas
- you want a quick CLI to fetch stock, index, or FX data
- you need listings for global exchanges like NASDAQ, NYSE, HKEX, or TSE

## When to avoid
- you need guaranteed real-time or tick-level market data
- you require an official licensed data feed with SLA guarantees
- you need data sources not covered by its crawlers

## Facets
- artifact type: library
- maturity: active
- function: data-science, etl, web-scraping, cli, sdk
- domain: fintech, data-science, analytics
- platform: python, cli, cross-platform
- tags: financial-data, stock-prices, krx, kospi, exchange-rates, cryptocurrency, market-data, crawler, command-line

## Member repositories
- FinanceData/FinanceDataReader (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:59.806298+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:07.381943+00:00, confidence not recorded.
  - readme: https://github.com/FinanceData/FinanceDataReader (fetched 2026-08-28T04:04:59.806298+00:00, sha 3262b17d9d48)
- Data as of 2026-08-30T08:39:29.467469+00:00.