10.2K ·GitHub
What is this?
easytrader is a Python library for automating Chinese stock quant trading - it can drive the 同花顺 (THS) desktop client, use the official miniqmt quant API, rebalance or track 雪球 (Xueqiu) portfolios, and mirror joinquant/ricequant paper trading.
Is this a trading platform or a library I call from my own code?
It is a Python library you import into your own scripts to control existing broker software and accounts - it is not a standalone trading platform or GUI application.
How do I get it talking to my broker?
You install the package and point easytrader at whichever integration you need: the running 同花顺 (THS) client, the miniqmt interface, or your 雪球 (Xueqiu) account/portfolio. Detailed setup for each is covered in the author's Chinese documentation.
Do I need the 同花顺 client or a broker account already set up?
Yes - easytrader automates existing broker software rather than connecting to exchanges on its own, so depending on the mode you pick you need the 同花顺 client installed, a miniqmt-enabled broker account, or a 雪球 account.
Does this work on macOS or Linux, or do I need Windows?
The 同花顺 client and miniqmt integrations are Windows desktop software, so those modes effectively require Windows; the README does not mention macOS or Linux support for them.
What are easyquotation and easyquant?
They are companion projects by the same author, shidenggui. easyquotation fetches real-time market-wide stock quotes, and easyquant is a lightweight quant trading framework meant to pair with easytrader.
Can I track simulated trading accounts too, not just real money?
Yes - easytrader can mirror your Joinquant or RiceQuant simulated trading accounts, in addition to syncing a live 雪球 (Xueqiu) portfolio.
Is there English documentation?
The README only links to Chinese-language documentation ('中文文档'); no English docs are mentioned.
Can I control a broker client running on a different machine?
Yes - the README lists remote operation of the client ('支持远程操作客户端') as a supported feature.
What are similar projects?
PanWatch, awesome-quant, vnpy, qlib, FQGate-agent, akshare, easy-stock, tushare
Which topics is it in?
algotrading, china-stock, stock-data, a-share, stock-analysis, investment, quantitative-trading, desktop-automation, gui-automation, trading-bot, quant, remote-control