handsomejustin

handsomejustin / easy_tdx

Public

通达信python SDK，支持在线获取数据及离线本地数据读取。全面优化接口。

a-share-tdx chinese-stock-market financial-data mootdx pytdx
14
7
69% credibility
Found May 29, 2026 at 22 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

easy-tdx is a Python library that connects to TongDaXin stock market data servers to retrieve real-time quotes, historical K-line charts, technical indicators, and sector information for Chinese A-shares (A 股), Hong Kong stocks, US stocks, and futures markets. It provides both a command-line tool and a Python API with support for 32+ technical indicators like MACD, KDJ, RSI, and BOLL. The library includes both synchronous and asynchronous interfaces, auto-selects the fastest server, and can also read historical data from locally installed TongDaXin software.

How It Works

1
🔍 Discovering the tool

You hear about a tool that can fetch Chinese stock market data without complicated setup

2
📦 Installing in one click

You install it with a simple command and everything is ready to use immediately

3
📊 Getting stock quotes instantly

You enter a stock code and instantly see the current price, volume, and market data

4
📈 Generating charts with one line

With one command, you pull up K-line charts and technical indicators like MACD or RSI

5
Choosing your workflow
⌨️
Command-line style

Type simple commands like 'easy-tdx kline SZ 000001' to get instant results

🐍
Python script style

Write a few lines of code to fetch data and process it in your own programs

🎉 Building your analysis

You successfully combine price data, technical indicators, and sector information to understand the market

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 22 to 14 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is easy_tdx?

easy_tdx is a Python SDK that connects to TongDaXin servers via TCP to pull real-time and historical market data. It covers A-shares, Hong Kong stocks, US stocks, and futures with a unified API. The library ships with a CLI tool that outputs JSON by default, plus both synchronous and asynchronous Python interfaces.

Why is it gaining traction?

The pitch is straightforward: get stock data without fighting proprietary APIs or expensive data vendors. The CLI makes it dead simple to pipe live quotes into scripts or AI agents. Built-in support for 32 technical indicators (MACD, KDJ, RSI, BOLL, and custom ones like ZHUOYAO) saves you from rolling your own. It also reads local TongDaXin installation files for offline work, which is a rare feature.

Who should use this?

Quant traders building automated strategies who need programmatic access to Chinese market data. Python developers working on trading bots or financial dashboards. Anyone tired of scraping data or paying for third-party APIs. It is less suited for production trading systems where stability matters more than flexibility.

Verdict

The feature set is solid and the API is clean, but the project has only 14 stars and a credibility score of roughly 0.7%. That is early-stage territory. Documentation looks thorough and the codebase passes strict mypy checks, but low community adoption means you are taking a risk on long-term maintenance. Try it for personal projects or prototyping, but hold off on mission-critical trading infrastructure until it has more traction.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.