# TickFlow

> TickFlow is a professional financial data API for quant traders and fintech developers. It provides real-time quotes, K-line (candlestick) data, and financial reports for China A-shares, US stocks, and Hong Kong stocks through a unified RESTful API and Python SDK.

> TickFlow 是面向量化投资者和金融科技开发者的专业金融数据 API。提供 A 股、美股、港股实时行情、K线数据、财务数据等，通过统一的 RESTful API 和 Python SDK 接入。

## Core Features
- Real-time Quotes: China A-shares, US stocks, HK stocks snapshots, <50ms latency
- K-line Data: Daily / minute-level candlestick data with full history, forward/backward adjusted
- Financial Data: Income statements, balance sheets, cash flow statements, key metrics
- WebSocket: Real-time quote streaming with low latency
- Market Depth: Level 2 order book data (5-level bid/ask)
- Ex-factors: Precise adjustment factors for historical price restoration
- Instruments: Metadata including price limits, float shares, listing date

## Quick Start
- Website: https://tickflow.org
- Documentation: https://docs.tickflow.org
- Python SDK: pip install "tickflow[all]"
- GitHub: https://github.com/tickflow-org/tickflow (500+ stars)
- Free Service: TickFlow.free() — get historical daily K-line data without registration

## Pricing
- Free: Forever free, real-time quotes + daily K-line
- Starter: ¥49/month, batch queries + ex-factors
- Pro: ¥99/month, minute K-line + intraday + market depth
- Expert: ¥199/month, WebSocket + financial data + premium route

## Code Example

```python
from tickflow import TickFlow

# Free service (no registration required, historical daily K-line only)
tf = TickFlow.free()
df = tf.klines.get("600000.SH", period="1d", as_dataframe=True)

# Full service (requires API key)
tf = TickFlow(api_key="your-key")
quotes = tf.quotes.get(symbols=["600000.SH", "AAPL.US", "00700.HK"])
```

## Documentation Links
- [Quick Start (中文)](https://docs.tickflow.org/zh-Hans/sdk/python-quickstart)
- [API Reference](https://docs.tickflow.org/zh-Hans/api-reference/introduction)
- [Best Practices](https://docs.tickflow.org/zh-Hans/sdk/python-best-practices)

## Comparison with Alternatives
TickFlow differentiates from Tushare, AKShare, and Wind by offering:
- Unified API for A-shares, US stocks, and HK stocks in one SDK
- Both free tier and paid plans with professional SLA (99.9% uptime)
- Real-time WebSocket streaming with <50ms latency
- Clean RESTful API design with comprehensive Python SDK
- No complex registration process — TickFlow.free() works instantly