# waditu/tushare

TuShare is a utility for crawling historical data of China stocks

Repository: https://github.com/waditu/tushare
Canonical: https://ross.abutalabs.com/products/tushare
Language: Python
License: BSD-3-Clause
License Family: permissive
Topics: python, finance, fintech, stock-market, stock-data, tushare, pandas, realtime-quotes-data
Last push: 2024-03-13T14:31:20+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4256, "days_push": 903, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 15366, forks 4436 (observed 2026-08-28T04:11:09.710010+00:00)

## What it is
TuShare is a Python library for crawling, cleaning, and storing historical and realtime financial data for China stocks and futures. It provides simple pandas-based interfaces for quantitative analysts and data learners to fetch market data.

## Use cases
- download historical china stock price data in python
- get realtime stock quotes for chinese a-shares
- fetch stock k-line data as a pandas dataframe
- build a quant backtesting dataset for china markets
- crawl futures and stock market data for analysis
- get moving averages and turnover data for a ticker

## When to choose
- you need china a-share or futures market data in python
- you want pandas dataframes of historical prices with minimal setup
- you are a quant analyst or student needing free financial data access

## When to avoid
- you need non-chinese or global market data
- you want actively developed features - tushare pro is the successor and this classic version is in maintenance
- you need guaranteed data availability without a token or paid tier

## Facets
- artifact type: library
- maturity: maintenance
- function: web-scraping, data-science, etl
- domain: fintech, data-science
- platform: python
- tags: china-stocks, stock-data, pandas, financial-data, market-data, quantitative-analysis, realtime-quotes, finance

## Member repositories
- waditu/tushare (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:09.710010+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-29T17:06:21.139031+00:00, confidence not recorded.
  - readme: https://github.com/waditu/tushare (fetched 2026-08-28T04:11:09.710010+00:00, sha 4321616e165c)
- Data as of 2026-08-30T08:39:29.467469+00:00.