How oficcejo/tdx-api works
This repository provides a Go client for querying TDX stock data, plus a Web dashboard and REST API. The primary workflow is a browser or API caller requesting stock data; Web handlers dispatch to the client, which encodes TDX protocol requests and decodes responses. Separate branches cover code and trading-calendar data, historical-data downloads, and optional Tonghuashun adjusted K-lines. The main runtime calls are supported by excerpts; some extended API wiring is only documented, so uncertain links are omitted.
Main entry points: client.go TDX client · server.go HTTP API handlers · pull-trade.go Trade downloader · pull-kline.go K-line downloader
Components 20
Web application
- Dashboard UI
web/static/app.js - HTTP API handlers
web/server.go - Extended API
web/server_api_extended.go - Background tasks
web/tasks.go
TDX client
- TDX client
client.go - Connection setup
dial.go - Stock code catalog
codes.go - Trading calendar
workday.go
Data extensions
- K-line downloader
extend/pull-kline.go - Trade downloader
extend/pull-trade.go - MySQL K-lines
extend/pull-kline-mysql.go - Tonghuashun source
extend/spider-ths.go - Income analysis
extend/income.go
Protocol
- Frame encoding
protocol/frame.go - Request / response models
protocol/model_kline.go - Quotes and trades
protocol/model_quote.go
Other components
- Browser / API caller
- TDX servers
- Tonghuashun service
- Local / SQL storage
Connections 26
- Browser / API caller → Dashboard UI: uses
README.md - Dashboard UI → HTTP API handlers: fetches data
web/static/app.js - Browser / API caller → HTTP API handlers: requests endpoints
README.md - HTTP API handlers → TDX client: queries stock data
web/server.go - Extended API → TDX client: queries stock data
web/server_api_extended.go - HTTP API handlers → K-line downloader: starts pull task
web/server.go - Background tasks → HTTP API handlers: tracks task state
- TDX client → Frame encoding: sends frames
client.go - Frame encoding → Request / response models: encodes requests
protocol/frame.go - Request / response models → TDX client: decodes responses
- Connection setup → TDX servers: connects to
- TDX client → TDX servers: exchanges data
- TDX client → Stock code catalog: uses code metadata
client.go - Stock code catalog → Local / SQL storage: persists catalog
codes.go - Trading calendar → Local / SQL storage: persists workdays
workday.go - K-line downloader → TDX client: fetches K-lines
extend/pull-kline.go - K-line downloader → Local / SQL storage: stores K-lines
extend/pull-kline.go - MySQL K-lines → TDX client: fetches K-lines
extend/pull-kline-mysql.go - MySQL K-lines → Local / SQL storage: stores K-lines
extend/pull-kline-mysql.go - Trade downloader → TDX client: fetches trades
extend/pull-trade.go - Trade downloader → Trading calendar: iterates workdays
extend/pull-trade.go - Trade downloader → Local / SQL storage: writes CSV files
extend/pull-trade.go - Tonghuashun source → Tonghuashun service: requests adjusted data
extend/spider-ths.go - HTTP API handlers → Tonghuashun source: serves alternate K-lines
- Income analysis → Request / response models: uses price types
extend/income.go - TDX client → Quotes and trades: returns market data