gotdx

通达信行情协议的 Go 客户端，覆盖主行情、扩展市场、MAC 板块/统一行情、F10/文件接口，以及一个可直接运行的 Web Viewer。

快速开始 · 能力概览 · 示例 · Web Viewer · API 速览 · 测试 · 协议文档

gotdx 把通达信协议里常用的查询能力整理成更偏 Go 的调用方式。你可以直接查主行情和扩展市场的快照、K 线、分时、逐笔，也可以继续往下钻到 F10、财务、板块文件、扩展表格和 MAC 板块协议；如果只是想先看接口返回长什么样，仓库里还带了一个可以直接打开的网页查看器。

为什么用 gotdx

• 一个 Client 同时管理主站和扩展市场，适合做统一监控和跨市场抓取。
• 提供两套入口：高阶统一接口 Stock* / Ex* / MAC* / Goods*，以及面向协议细节的底层 Get* / ExGet*。
• 地址池、超时、重试都可配，适合对接不稳定的真实行情站点。
• 内置主站、扩展、MAC、券商 host/IP 列表，并支持 TCP 测速选最快节点。
• 自带 30+ 个示例，覆盖从列表、快照、K 线、分时到 F10、板块、扩展表格。
• 自带 cmd/webviewer，不写代码也能直接调方法、填参数、看返回字段。
• 协议实现、示例和 Web Viewer 已整理为统一风格，便于继续补协议、核字段和排查差异。

快速开始

安装

go get github.com/bensema/gotdx

最小示例

package main

import (
    "log"

    "github.com/bensema/gotdx"
)

func main() {
    mainHosts := gotdx.MainHostAddresses()
    exHosts := gotdx.ExHostAddresses()

    client := gotdx.New(
        gotdx.WithTCPAddress(mainHosts[0]),
        gotdx.WithTCPAddressPool(mainHosts[1:]...),
        gotdx.WithExTCPAddress(exHosts[0]),
        gotdx.WithExTCPAddressPool(exHosts[1:]...),
        gotdx.WithAutoSelectFastest(true),
        gotdx.WithTimeoutSec(6),
    )
    defer client.Disconnect()

    stocks, err := client.StockQuotesDetail(
        []uint8{gotdx.MarketSZ, gotdx.MarketSH},
        []string{"000001", "600519"},
    )
    if err != nil {
        log.Fatal(err)
    }
    for _, item := range stocks {
        log.Printf("stock code=%s price=%.2f turnover=%.2f%%", item.Code, item.Price, item.Turnover)
    }

    exQuotes, err := client.ExQuotes(
        []uint8{gotdx.ExCategoryUSStock},
        []string{"TSLA"},
    )
    if err != nil {
        log.Fatal(err)
    }
    for _, item := range exQuotes {
        log.Printf("ex: %+v", item)
    }
}

从哪套 API 开始

• 想尽快拿到业务数据：优先用 Stock* / Ex* / MAC* 统一高阶入口。
• 想逐个协议排查字段：用 Get* / ExGet* / GetMAC* 底层接口。
• 想先确认请求参数和返回格式：直接运行 go run ./cmd/webviewer。

内置 Host 列表与测速

results := gotdx.ProbeHosts(gotdx.MainHosts(), time.Second)
for _, item := range results[:3] {
    log.Printf("main host=%s addr=%s reachable=%v latency=%s",
        item.Name, item.Address, item.Reachable, item.Latency)
}

fastest, err := gotdx.FastestHost(gotdx.ExHosts(), time.Second)
if err != nil {
    log.Fatal(err)
}
log.Printf("fastest ex host: %s %s", fastest.Name, fastest.Address)

client := gotdx.New(
    gotdx.WithAutoSelectFastest(true),
    gotdx.WithTimeoutSec(6),
)

可用列表包括：MainHosts、BrokerHosts、ExHosts、MACHosts、MACExHosts，以及对应的 *HostAddresses 便捷函数。

能力概览

项目结构

• proto/: 各协议的请求/响应序列化与反序列化实现。
• client_quote.go: 主行情底层接口。
• client_exquote.go: 扩展市场底层接口。
• client_mac.go: MAC 协议接口。
• client_unified.go / client_goods.go: Stock* / Ex* / MAC* / Goods* 高阶统一入口。
• cmd/webviewer/: 浏览器调试界面。
• examples/: 可直接运行的示例。

示例

下面这些命令可以直接运行：

查看完整示例目录

• examples/stock_count
• examples/stock_server_info
• examples/stock_list
• examples/stock_list_old
• examples/stock_paged_list
• examples/stock_batch_quotes
• examples/stock_quotes
• examples/stock_quotes_encrypt
• examples/stock_lowlevel_quote
• examples/stock_quotes_list
• examples/stock_kline
• examples/stock_kline_offset
• examples/stock_feature_452
• examples/stock_index_tools
• examples/stock_tick
• examples/stock_history
• examples/stock_history_transaction_with_trans
• examples/stock_market_watch
• examples/host_probe
• examples/icfqs_raw
• examples/stock_transaction
• examples/stock_f10_block
• examples/stock_company_raw
• examples/stock_block_raw
• examples/main_experimental
• examples/ex_count
• examples/ex_quote
• examples/ex_list
• examples/ex_list_extra
• examples/ex_paged_list
• examples/ex_quotes
• examples/ex_quotes2
• examples/ex_quotes_list
• examples/ex_kline
• examples/ex_kline2
• examples/ex_board_list
• examples/ex_experiment_2487
• examples/ex_experiment_2488
• examples/ex_mapping_2562
• examples/goods_overview
• examples/ex_history
• examples/ex_tick
• examples/ex_server_info
• examples/ex_sampling
• examples/ex_category_list
• examples/ex_table
• examples/ex_table_detail
• examples/mac_board_list
• examples/mac_board_members
• examples/mac_board_members_quotes
• examples/mac_board_members_quotes_dynamic
• examples/mac_symbol_quotes
• examples/mac_market_monitor
• examples/mac_quotes
• examples/mac_transactions
• examples/mac_auction
• examples/mac_tick_charts
• examples/mac_symbol_info
• examples/mac_capital_flow
• examples/mac_server_info
• examples/mac_kline_offset
• examples/mac_file_query
• examples/mac_symbol_belong_board
• examples/mac_symbol_bars
• examples/unified_watchlist

Web Viewer

仓库内置了一个轻量的网页查看器，适合在这些场景下使用：

• 先确认某个方法应该填哪些参数。
• 快速查看返回字段，而不是先写一段测试代码。
• 对照 MAC 动态位图字段，直接看 bit/name/format/description，也可以用 TDX 商品语义分组调 goods_* 入口。
• 直接检查主站文件、表格文件和 CSV 文件的结构化结果。
• 对比不同主机返回的数据差异。
• 调试实验协议或原始接口。

启动：

go run ./cmd/webviewer

默认地址：

http://127.0.0.1:8080

Web Viewer 中的 ICFQS HTTP 原始接口已按 主题投资、行情、龙虎榜、每日复盘 分组；多表响应可用 table_index 选择展示的 ResultSets，完整响应保留在 Raw 面板。

API 速览

高阶统一入口

• StockQuotesDetail、StockQuotesList、StockQuotes 会按证券列表里的 DecimalPoint 尽力修正非 2 位小数价格，并在可获取到流通股本时补齐 Turnover。
• 主行情：StockCount, StockList, StockQuotesDetail, StockKLine, StockTickChart, StockIndexInfo, StockIndexMomentum, StockChartSampling, StockAuction, StockTopBoard, StockUnusual, StockVolumeProfile, StockHistoryOrders, StockHistoryTransaction, StockF10
• 扩展市场：ExCount, ExList, ExQuote, ExQuotes, ExKLine, ExTickChart, ExHistoryTransaction, ExTable
• 商品语义：GoodsCount, GoodsCategoryList, GoodsList, GoodsVarieties, GoodsQuote, GoodsQuotes, GoodsQuotesList, GoodsKLine, GoodsTickChart, GoodsChartSampling, GoodsHistoryTransaction
• MAC：MACBoardList, MACBoardMembers, MACBoardMembersWithSort, MACBoardMembersQuotes, MACBoardMembersQuotesWithSort, MACBoardMembersQuotesDynamic, MACBoardMembersQuotesDynamicWithFilter, MACSymbolQuotes, MACQuotes, MACQuotesWithDate, MACTransactions, MACTransactionsWithDate, MACAuction, MACTickCharts, MACSymbolInfo, MACCapitalFlow, MACFileList, MACDownloadFullFile, MACMarketMonitor, MACSymbolBelongBoard, MACSymbolBars；MACSymbolBars 会基于返回的流通股本字段尽力补齐 Turnover。

常用底层接口

• 主行情：GetSecurityCount, GetSecurityListRange, GetQuotesDetail, GetIndexInfo, GetIndexMomentum, GetVolumeProfile, GetMinuteTimeData, GetAuction, GetTopBoard, GetUnusual, GetTransactionData, GetHistoryOrders
• F10/文件：GetCompanyCategories, GetCompanyContent, GetFinanceInfo, GetXDXRInfo, DownloadFile, GetBlockFile
• 扩展市场：ExGetCategoryList, ExGetQuotesList, ExGetQuote, ExGetChartSampling, ExGetFileMeta, ExDownloadFile
• MAC：GetMACBoardCount, GetMACBoardList, GetMACBoardMembers, GetMACBoardMembersQuotes, GetMACBoardMembersQuotesDynamic, GetMACBoardMembersQuotesDynamicWithFilter, GetMACSymbolQuotes, GetMACQuotes, GetMACQuotesWithDate, GetMACTransactions, GetMACTransactionsWithDate, GetMACAuction, GetMACTickCharts, GetMACSymbolInfo, GetMACCapitalFlow, GetMACFileList, GetMACFileDownload, GetMACMarketMonitor, GetMACSymbolBelongBoard, GetMACSymbolBars

地址池与测速

• 内置列表：MainHosts, BrokerHosts, ExHosts, MACHosts, MACExHosts
• 地址便捷函数：MainHostAddresses, BrokerHostAddresses, ExHostAddresses, MACHostAddresses, MACExHostAddresses
• 测速函数：ProbeHosts, ProbeAddresses, FastestHost, FastestAddress
• 客户端能力：Client.ProbeHosts, Client.FastestHost, WithAutoSelectFastest

试验与兼容协议

• 主站试验：MainTodoB, MainTodoFDE, MainClient264B, MainClient26AC, MainClient26AD, MainClient26AE, MainClient26B1
• 主站兼容：StockListOld, StockFeature452, StockQuotesEncrypt, StockKLineOffset, StockHistoryTransactionWithTrans
• 扩展试验：ExListExtra, ExExperiment2487, ExExperiment2488, ExKLine2, ExMapping2562
• TDX 商品语义：GoodsCount, GoodsCategoryList, GoodsList, GoodsVarieties, GoodsQuote, GoodsQuotes, GoodsQuotesList, GoodsKLine, GoodsTickChart, GoodsChartSampling, GoodsHistoryTransaction

查看更完整的接口分组

主行情与通用接口

• Connect, Disconnect
• GetExchangeAnnouncement, GetServerHeartbeat, GetAnnouncement, GetServerInfo
• GetSecurityCount, GetSecurityQuotes, GetQuotesDetail, GetQuotesEncrypt
• GetSecurityList, GetSecurityListOld, GetSecurityListRange
• GetKLine, GetSecurityBars, GetSecurityBarsOffset, GetIndexBars
• GetIndexMomentum, GetIndexInfo, GetMinuteTimeData, GetTickChart, GetHistoryMinuteTimeData, GetHistoryTickChart
• GetChartSampling, GetAuction, GetTopBoard, GetUnusual
• GetTransactionData, GetHistoryOrders, GetHistoryTransactionData, GetHistoryTransactionDataWithTrans

F10、公司资料与文件

• GetCompanyCategories, GetCompanyContent, GetFinanceInfo, GetXDXRInfo, GetCompanyInfo
• GetFileMeta, DownloadFile, DownloadFullFile
• GetBlockFile, GetTableFile, GetCSVFile, GetParsedBlockFile, GetGroupedBlockFile

扩展市场

• ConnectEx, GetExServerInfo
• ExGetCount, ExGetCategoryList, ExGetList, ExGetListExtra
• ExGetQuotesList, ExGetQuote, ExGetQuotes, ExGetQuotes2
• ExGetKLine, ExGetKLine2
• ExGetHistoryTransaction, ExGetTickChart, ExGetHistoryTickChart, ExGetChartSampling
• ExGetBoardList, ExGetMapping2562
• ExGetFileMeta, ExDownloadFile, `ExDownload