bigbigmonkey123/futu-moni

futu-moni is a macOS tool that reads live stock price quotes for Japanese, Hong Kong, and US markets by tapping into the desktop app of Futu Niuniu, a stock trading platform popular in Asia. Instead of using Futu's official API, which normally requires an OpenD server and an API key, this project intercepts the network traffic that the Futu Niuniu desktop app already sends to Futu's own servers on your Mac, and reads the quote data straight from that traffic. To work, the tool temporarily reroutes some of the network connections on your computer to itself using macOS's built in packet filter, called pfctl, and local routing table, so it can sit between the Futu Niuniu app and the real Futu servers. On your first use of futu-moni you must log in manually inside the Futu Niuniu window that pops up, but after that first login the app can be set to log in automatically and no further manual steps are needed. Because it needs to change your Mac's network routing and packet filter rules, it must be run with administrator, or sudo, privileges. You run it either in a default mode that checks a few preset Japanese ETFs, or by naming the specific stocks you want, mixing markets in one command such as one US stock, one Hong Kong stock, and one Japan stock. It prints out the latest price, the previous close, the percentage change, and for most markets the day's open, high, low, and volume figures. Hong Kong quotes only show price, since deeper order book and volume details get cut off by how that market's data is formatted in the protocol. The project requires macOS, the Futu Niuniu desktop app already installed, and Python 3.11 or newer, and it is released under the MIT license.