tickflow
TickFlow Python Client
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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
- 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 · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for commercial and proprietary projects.
last release 2026-06-20 (55 days) · last repo commit 2026-06-20 · 539 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 269,650 downloads/mo, #8,255 on PyPI
Alternatives
Verify before relying
# 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']}")- 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
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 on this page. Verify before relying on it.
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
tickflow on PyPI
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.
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
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']}")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 the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packageshttpxtyping-extensions |
| Maintenance | Actively maintained 55 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 269,650 / month, #8,255 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersIntended Audience :: Financial and Insurance IndustryLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9Topic :: Office/Business :: Financial :: InvestmentTyping :: Typed |
Evidence: tickflow-0.1.24-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “kline candle data fetcher”
- tickflowTickFlow is a Python client for accessing market data across Chinese…
- smartapi-pythonA Python client library for Angel Broking's REST API that enables…
- finance-datareaderFetches historical and current financial data—stock prices, indices,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Investment packages
Generates country- and subdivision-specific government holiday calendars on demand, supporting 250 country codes with optional language localization and holiday categories.
Fetches financial and market data from Yahoo Finance's public APIs, including ticker information, historical prices, and live streaming data.
However, do not use it for commercial applications or high-volume data collection without confirming compliance with Yahoo's terms of service.
Provides elementary financial functions (IRR, NPV, PMT, and others) that were deprecated and removed from NumPy, offering a dedicated replacement for financial calculations.
However, given the aging status (no releases since 2019) and unclear compatibility with modern Python and recent numpy versions, verify that it works with your target…
CCXT is a unified API library for connecting to and trading on more than 100 cryptocurrency exchanges and prediction markets, supporting both REST and WebSocket protocols with normalized cross-exchange data access.
Official Python client for accessing live and historical market data from Databento, supporting multiple asset classes, schemas, and data formats with normalized message structures.
Install it if you need programmatic access to Databento's historical or live market data; skip it if you don't have a Databento account or need data from a different…
EdgarTools parses SEC EDGAR filings into typed Python objects and pandas DataFrames, extracting financial statements, insider trades, fund holdings, and other filing types with a consistent API.
The main gotcha is that you must provide an email to the SEC with every request, but that is a documented requirement.
See also baostock · yahooquery · pandas-ta · tushare · efinance · tdxpy · mootdx · alpha-vantage · python-binance · vnai