---
id: tickflow
version: "0.1.24"
license: MIT
license_treatment: permissive
maintenance: active
---

# tickflow — TickFlow Python Client

License: permissive · Maintenance: active · Downloads: 269.6K/mo

## What it is and what it does

TickFlow is an official Python client for the TickFlow market data API, designed to fetch financial data across multiple markets: Chinese A-shares (Shanghai, Shenzhen, Beijing exchanges), ETFs, US stocks, and Hong Kong stocks. It provides two service tiers—a free tier offering historical daily candles and instrument metadata without registration, and a paid tier (requiring API key registration) that adds real-time quotes, intraday minute-level candles, and higher request frequency. The SDK supports both synchronous and asynchronous usage patterns, with optional pandas DataFrame output for convenient data manipulation.

The package depends on httpx for HTTP requests and typing-extensions for type hints, keeping dependencies minimal. It requires Python 3.9 or later and supports current Python versions through 3.14. Symbol format is standardized across all markets (e.g., "600000.SH" for Shanghai, "AAPL.US" for US stocks), and the API supports both single-symbol and batch queries. Batch operations include progress reporting, making it practical for fetching data on many securities at once.

Use it for:

- Fetch historical daily OHLCV data for backtesting trading strategies on Chinese A-shares or US stocks
- Build a real-time stock quote dashboard using the paid API with async concurrent requests
- Retrieve intraday minute-level candles for day-trading analysis on multiple symbols in parallel
- Query instrument metadata and exchange information for portfolio construction or market screening
- Integrate market data into pandas-based research workflows with automatic DataFrame conversion

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

TickFlow is a Python client for accessing market data across Chinese A-shares, ETFs, US stocks, and Hong Kong stocks through the TickFlow API, offering both free historical daily candles and paid real-time quotes and intraday data.

Yes, if you need market data across Chinese, US, or Hong Kong equities. The free tier is immediately usable without registration for historical daily data; the paid tier unlocks real-time quotes and intraday candles. Low dependency footprint, active maintenance, and support for both sync and async patterns make it practical for research, trading, and financial applications. No known vulnerabilities as of the fact sheet date.

## Install

pip install tickflow
uv add tickflow
poetry add tickflow

## Installing tickflow

Before you install: Low install friction with only two lightweight runtime dependencies (httpx and typing-extensions). The package is actively maintained with a recent commit on 2026-06-20 and has accumulated 539 stars, indicating steady adoption since its first release on 2026-03-12.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and proprietary projects.

Quickstart:

# Free tier (no API key needed)
from tickflow import TickFlow

tf = TickFlow.free()
df = tf.klines.get("600000.SH", period="1d", count=100, as_dataframe=True)
print(df.tail())

# Paid tier with real-time quotes
tf = TickFlow(api_key="your-api-key")
quotes = tf.quotes.get(symbols=["600000.SH", "000001.SZ"])
for q in quotes:
    print(f"{q['symbol']}: {q['last_price']}")

Requires Python 3.9 or later; pandas is optional but needed for as_dataframe=True output; paid tier requires API key registration at tickflow.org

Verify before relying:

- Whether the free tier's historical daily data is sufficient for typical use cases or if most users require the paid API key
- Rate limiting and quota details for both free and paid tiers beyond what the description states
- Performance characteristics and latency for concurrent requests via AsyncTickFlow

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 269.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stock market data api client, chinese stock quotes real-time, kline candle data fetcher, multi-market financial data, trading data api wrapper, us hk stock data python, async market data client, market-data-api, financial-data, async-client

[View on SkillFed](https://skillfed.io/packages/tickflow) · [View on PyPI](https://pypi.org/project/tickflow/)