简介面向高频交易与量化投资者的同花顺Level-2全推行情Python API操作手册聚焦沪深市场深度行情获取与涨停板策略等实战场景适合具备Python基础、希望接入低延迟行情的中高级开发者。压缩包共1个PDF文件约850KB以版本修订说明与接口文档为主体便于按版本脉络查阅。已有2833人学习下载具备一定参考热度。手册完整梳理V2.0.0至V2.1.9的迭代轨迹从单连接转多连接、支持上证逐笔委托到级联功能、Level-1数据、Linux兼容、离线调试与异步订阅接口并逐项说明快照字段扩充、数据类型精度调整及回调参数变更。正文涵盖TDS的C/S架构与高可用设计、运行环境要求、安装验证步骤以及初始化实例、注册行情与断线通知回调、设置连接市场与超时、订阅五档十档快照、逐笔成交委托与委托队列等接口用法可帮助读者快速搭建行情接入环境并规避常见配置问题。1. 一份能跑通全推行情的 Python SDK到底解决了什么做涨停板策略的人最怕什么不是模型不收敛而是行情数据慢半拍、盘口只有五档、逐笔委托拿不到。你盯着五档快照做封单强度判断结果主力在十档之外挂撤单你根本看不见你想统计逐笔委托里的撤单节奏接口却只给你成交回报。这份《Level-2 全推行情 Python API 操作手册》对应的 SDK就是冲着这几个痛点来的沪深 Level-2 十档快照、逐笔成交、逐笔委托、委托队列、极速盘口全部通过回调推给你而不是让你轮询。它适合谁适合已经能写 Python、手里有行情账号、想把涨停板封单结构和撤单行为做成因子的量化从业者。不适合只想拿日线做回测的新手因为这套东西的价值全在盘中毫秒级的推送细节里。2. 环境与初始化把 TDS 实例跑起来的第一公里2.1 安装与运行环境核对这份 SDK 是 C/S 结构Python 侧只是一个薄封装真正的解码和分发在服务端完成所以本地环境不用堆很高。手册给的硬件底线是 64 位双核、8G 内存、下行 100Mbps操作系统 Windows7 以上或 CentOS 7 这类常见 Linux 发行版Python 3.564 位及以上。我一般会先确认 Python 位数因为 32 位解释器加载 64 位动态库会直接报错这个坑比想象中常见。安装走的是本地包不是从公共源拉# Linux 下需要 root 权限安装Windows 用管理员权限的终端 pip install ./L2-tdsapi-python-X.X.X-XXXXXXXX.tar.gz # 如果 pip 装完导入异常退回源码方式 python setup.py install装完先做最小验证别急着写业务逻辑# 验证安装是否成功没有异常就说明动态库加载正常 import datafeed print(datafeed imported ok)这里要说明一点pip install和setup.py install二选一即可前者适合干净环境后者适合你已经手动解压、想看清包内文件结构的情况。验证阶段只导入datafeed顶层包不导入tds_api是为了把「包没装上」和「动态库依赖缺失」两类错误分开——如果import datafeed就炸基本是安装路径或权限问题如果这步过了、导入tds_api才炸多半是动态库依赖没满足。2.2 创建实例、注册回调与 set_env 的参数取舍整个 SDK 是回调驱动的工作流程是创建TDS实例 →set_env注册回调并设环境参数 →login登录 →sub订阅 → 回调里收数据。顺序不能乱set_env必须在注册和登录之前调用这是硬约束。from datafeed.tds_api import TDS # 1. 创建实例 tds TDS() # 2. 定义行情推送回调签名固定为 (data_list, count, stats) def callback_stock(data_list, count, stats): # data_list 是本次推送的数据列表可能多条 # count 是条数stats 是链路时间戳字典 print(recv count:, count) # 生产环境这里不要做重活见 2.3 的堵包说明 # 3. 设置环境参数并注册证券快照回调 tds.set_env( fnctickstockcallback_stock, # 证券快照回调 m_heartbeat_interval10, # 心跳间隔秒最小 1 m_reconn_count5, # 断线重试次数1 不重连 m_reconn_interval3, # 重连间隔秒 m_timeout5000, # 同步请求超时毫秒 m_connectmarketUSH;USZ, # 连接市场可只填单市场 m_connectsubscribe1, # 重登后自动重发订阅 m_logpath./tds_log, # 日志路径 m_loglevelwarn # 日志级别 )set_env的参数里真正影响稳定性的就三个m_reconn_count、m_reconn_interval、m_connectsubscribe。m_connectsubscribe1是我强烈建议开的它让 SDK 在断线重连成功后自动把之前的订阅请求重发一遍否则你半夜网络抖一下第二天开盘发现订阅全丢了这种血泪经验不值得重复。m_connectmarket默认USH;USZ双市场如果你只做沪市涨停板填USH能少一条连接、少一份资源占用。m_timeout只影响get_code_list、get_tick_stock这类同步查询不影响推送回调。回调函数有六个数据入口对应关系要记牢fnctickindex指数快照、fnctickstock证券快照、fncorderqueue委托队列、fncorderdata逐笔委托、fnctransaction逐笔成交、fncsuperstock极速盘口。极速盘口需要额外产品权限没权限的账号注册了也收不到数据别以为是接口写错了。2.3 回调里为什么不能做重活手册里有一句容易被忽略的话不要在回调函数中做耗时很长的操作否则很可能导致接收实时行情堵包。这不是客套。回调是在 SDK 的接收线程里同步执行的你在里面写数据库、算因子、发 HTTP接收线程就被你占住了后面的数据包在缓冲区里堆积表现出来就是「行情延迟越来越大」甚至「回调突然不触发了」。常见做法是回调里只做一件事把data_list塞进queue.Queue业务线程另起一个消费者慢慢处理。这样接收线程永远轻量堵包风险降到最低。import queue import threading raw_queue queue.Queue(maxsize200000) def callback_stock(data_list, count, stats): # 回调里只入队不做任何计算和 IO try: raw_queue.put_nowait((data_list, stats)) except queue.Full: # 队列满说明消费端跟不上这里要记数告警而不是阻塞 pass def consumer(): while True: data_list, stats raw_queue.get() # 真正的落库、因子计算放这里 process(data_list, stats) threading.Thread(targetconsumer, daemonTrue).start()stats字典里带produce_time、send_time、recv_time三个微秒级时间戳这是你排查延迟的黑匣子recv_time - send_time是链路耗时send_time - produce_time是服务端处理耗时。涨停板策略对延迟敏感我一般会在消费端持续统计这两个差值的分位数一旦 P99 明显抬升先查本地消费是否堵了再查网络。3. 登录、查询与订阅把数据流真正接上3.1 登录返回值与错误码排查登录是同步调用返回 0 成功负数失败。手册列了一串错误码实际排障时高频的就那么几个-1004用户名密码错误、-1005无法连接服务器、-1016重复登录、-1018版本太低。-1016特别值得说同一个账号在多处登录会互踢你本地调试时忘了关上一个进程新进程就登不上现象是「账号密码明明对的却返回 -1016」第一次遇到很容易怀疑人生。ret tds.login(your_account, your_password) if ret ! 0: # 按错误码分流处理不要笼统打印 if ret -1016: print(重复登录检查是否有残留进程占用账号) elif ret -1018: print(SDK 版本过低需要更新安装包) else: print(login failed, code:, ret)登录成功后func_notify这个断线通知回调才会真正有意义。它的机制是断线后多次重连都失败SDK 已停止工作此时回调收到{code: int, msg: str}code为 1 表示网络断开、2 表示网卡不正常、3 表示重复登录被踢下线。收到这个通知正确响应是重新调用login和订阅而不是干等。3.2 代码表与快照查询市场号别填错查询类接口都是同步的适合盘前拉代码表、盘中补数据。市场号是最容易翻车的地方上交所 A 股是USHA但上证风险警示板是USHT两者是分开的市场号深交所 A 股是USZA。你做涨停板策略ST 股和普通股在不同市场号下漏了USHT就会漏掉一批标的。# 拉取上证指数全部代码 index_codes tds.get_code_list(USHI) # 拉取 USHA 全市场证券快照[] 表示全市场 snapshots tds.get_tick_stock(USHA, []) # 只查单只股票的快照 one tds.get_tick_stock(USHA, code_list[600000]) # 极速盘口查询需要产品权限 super_snap tds.get_super_stock(USHA, code_list[600000])get_code_list返回字符串列表失败返回空列表[]get_tick_stock返回字典列表。注意get_code_info在手册里标注「暂未实现」别在它上面浪费时间。查询接口返回的是「当前时刻的一份数据」不是流做实时策略还是得靠订阅推送。3.3 订阅接口的四种操作与异步订阅订阅分同步和异步两套。同步的sub是「取消该市场该类型的所有订阅并重新订阅」语义要看清——它不是增量添加是全量重置。增量用add_sub取消单个代码用del_sub整体取消用unsub。# 全量订阅 USHA 证券快照会先清掉该市场该类型的旧订阅 tds.sub(stock, USHA, []) # 增量添加 USHA 逐笔成交订阅 tds.add_sub(trans, USHA, []) # 取消 USHA 单只股票的逐笔委托订阅 tds.del_sub(order, USHA, [600000]) # 取消 USHA 全部快照订阅 tds.unsub(stock, USHA)异步订阅async_sub是 V2.1.4 之后加的好处是不阻塞调用线程结果通过fucsubscribe注册的回调通知。回调参数是(data_type, op_type, market, code_list, statuscode, callback_type)statuscode为 0 表示成功callback_type为 1 表示异步订阅触发、2 表示断线重连后自动重发触发。做多市场批量订阅时异步接口能明显减少启动阶段的等待。def on_subscribe(data_type, op_type, market, code_list, statuscode, callback_type): if statuscode ! 0: print(subscribe failed:, data_type, market, statuscode) tds.set_env(fucsubscribeon_subscribe) # op_type: 1 全新订阅 2 取消订阅 3 增加订阅代码 4 取消订阅代码 tds.async_sub(stock, 1, USHA, [])4. 数据结构与字段涨停板策略真正用得上的那些列4.1 快照字段的分层理解证券快照字段很多但按用途可以分三层。第一层是价格量能pre_price、open_price、high_price、low_price、new_price、volume、turnover、trade_num。第二层是盘口Level-2 给到买一到买十的bidorder_price、bidorder_volume、bid_numorders卖侧对称。第三层是沪市特有的撤单与委托统计withdraw_buynum、withdraw_buyvolume、withdraw_buyturnover、withdraw_sellnum、withdraw_sellvol、withdraw_sellturnover以及totalbid_num、totalask_num、bidorder_num、askorder_num。对涨停板封单强度判断第三层才是金矿。封单量看买一量但封单的「真实性」要看撤单买一挂着巨量、同时withdraw_buynum持续攀升说明有资金在反复挂撤制造虚假封单。这个组合信号五档快照根本给不了。4.2 status 与 mode_state 的状态机解读status字段是字符串沪深编码规则不同这是最容易解析错的地方。上证第 1 位S 启动、C 开盘集合竞价、T 连续交易、E 闭市、P 停牌、M 可恢复熔断、N 不可恢复熔断、U 收盘集合竞价第 2 位 0/1 表示能否正常交易第 3 位 0/1 表示是否上市第 4 位 0/1 表示当前时段是否接受订单申报。深证第 1 位S 启动、O 开盘集合竞价、T 连续竞价、B 休市、C 收盘集合竞价、E 已闭市、H 临时停牌、A 盘后交易、V 波动性中断第 2 位 0 正常、1 全天停牌。def is_continuous_trading(market, status): # 沪深连续交易时段的判定逻辑不同必须分市场 if market.startswith(USH): return len(status) 1 and status[0] T if market.startswith(USZ): return len(status) 1 and status[0] T return Falsemode_state是深市 2022.5.16 之后的新字段格式是「交易方式状态」成对拼接比如1T2T3T4T5T1 匹配成交、2 协商成交、3 点击成交、4 询价成交、5 竞买成交状态字母含义同上。deal_mode表示最近一笔成交的成交方式。做深市策略时如果你的因子只认竞价成交就得用matching_volume、matching_turnover、matching_price这三个字段而不是汇总后的volume否则会把大宗协商的量混进你的封单模型里。4.3 逐笔与委托队列的字段要点逐笔成交和逐笔委托在 V2.0.7 之后都带了通道号字段V2.1.9 逐笔委托又加了委托序号。委托序号是做「委托生命周期追踪」的关键同一笔委托从下单到成交或撤单靠序号串起来才能算出真实的撤单率和挂单存活时间。委托队列给的是买一/卖一价位的排队明细做封单前排识别时队列长度和逐笔委托的匹配能看出有没有大单在队首反复插撤。5. 避坑与排查五个真实会卡住你的问题5.1 现象回调注册了但一条数据都不触发原因通常有三个一是订阅没成功sub返回了负值但没检查二是市场号填错比如把USHA写成USHA带空格或用了不存在的市场号三是极速盘口没开产品权限。解决先检查sub/async_sub的返回码再用get_tick_stock同步查一次同代码确认账号本身有数据权限最后核对市场号是否在手册的市场表里。5.2 现象盘中行情越来越慢最后回调停了原因就是 2.3 说的回调堵包接收线程被业务逻辑占住。解决回调里只入队消费端异步处理同时给队列设上限满了记数告警而不是无限堆积。我一般还会在消费端打印recv_time - send_time的滑动分位数延迟抬升时能第一时间定位是本地堵了还是链路问题。5.3 现象断线重连后订阅全没了原因是m_connectsubscribe没设成 1或者设了但用的是同步订阅且重连逻辑没走fucsubscribe回调。解决set_env里显式设m_connectsubscribe1并注册fucsubscribe在callback_type2的回调里确认重发结果。另外func_notify收到code3重复登录被踢时SDK 已停止工作必须手动重新login自动重连救不了这种情况。5.4 现象级联模式下从 SDK 连不上主 SDK级联模式要两步主从 SDK 各自在程序同级目录建tool.ini主 SDK 写mastertrue和socket_port9999从 SDK 写masterfalse和socket_port9998然后从 SDK 在login之前调用register_addr(master, 主IP, 9999)。常见错误是端口号后面没接换行符导致配置读取失败以及从 SDK 先login再register_addr——顺序反了必然失败。还有一点从 SDK 的账号密码必须和主 SDK 一致。5.5 现象离线调试模式不生效start_offline_debug必须在实例创建之后、login之前调用已经登录了再调不生效。数据文件名必须严格是stock.csv、index.csv、order.csv、queue.csv、trans.csv、superstock.csv、codelist.ini之一命名不规范 SDK 直接不读。另外级联模式下只有父节点支持离线调试子节点调了无效。6. 用离线调试把策略回放跑通一个可复现的验证套路实盘前我最看重的一步是用离线调试模式把整条数据链路跑一遍。它不连线上网关login直接返回成功SDK 按你指定的间隔和条数回放本地 CSV触发和实时一模一样的回调。这意味着你可以在没有行情账号、没有开盘的时间段把回调解析、因子计算、落库全流程验证一遍。from datafeed.tds_api import TDS tds TDS() def callback_stock(data_list, count, stats): # 回放时 stats 里的时间戳来自文件不是真实链路时间 print(replay count:, count) tds.set_env(fnctickstockcallback_stock) # 关键必须在 login 之前调用 tds.start_offline_debug( pathD:\\datafeed, # 数据目录 subtype[stock, trans], # 只回放快照和逐笔成交 push_space3000, # 每次推送间隔 3000ms push_count5000, # 单次推送 5000 条 playback_times1 # 文件遍历 1 次 ) # 离线模式下 login 不连服务器直接成功 tds.login(test1, 123456)参数怎么调push_space和push_count共同决定回放速度push_count / push_space就是你的模拟吞吐。想压测消费端处理能力就把push_count调大、push_space调小看队列会不会满想贴近真实盘中节奏就按你实际每秒收到的条数量级来设。subtype只填你真正要验证的数据类型填多了回放时间长且干扰排查。playback_times大于 1 可以用来验证长时间运行的稳定性比如内存有没有缓慢增长。有一个细节要注意离线模式下查询接口只读文件前 3000 条指数前 300 条并去重后供查询所以get_tick_stock在离线模式拿到的不是全量别拿它验证全市场逻辑。回放触发回调的规则和实时一致——当次读取的数据里不含你订阅的代码就不触发回调这一点恰好能帮你验证订阅过滤逻辑写对没有。我自己的习惯是任何一次 SDK 升级、任何一次因子逻辑改动都先用离线回放跑一遍确认回调不炸、字段不空、队列不堵再上实盘。这套流程帮我挡掉过好几次字段类型变更引发的静默错误——比如withdraw_buyturnover从 int 改成 float 那次不做回放根本发现不了精度问题。希望帮到你。本文还有配套的精品资源点击获取
企业数字化 ERP 产品动态
相关推荐
Superpowers工具包:AI工程化的15个核心技能解析 1. Superpowers工程大脑深度解析最近在AI工程化领域,Superpowers这个工具包突然火了起来。作为一个长期关注AI落地的技术从业者,我第一时间体验了这个号称能给AI装上"工程大脑"的神奇工具。经过两周的深度使用,不得不说这确实是一套… · 2026/11/22 6:23:25
C++实现图灵机验证图灵完备性 - 信奥竞赛实战解析 1. 项目背景与核心挑战 最近在洛谷刷题时遇到一道很有意思的信奥题目B3981,要求用C验证图灵完备性。这道题出自"信息与未来2024"竞赛,属于典型的计算机理论基础与实际编程结合的题型。作为信奥备考的经典训练素材,这类题目往往能考… · 2026/11/10 3:43:20
标准化基础知识培训PPT怎么做:从内容框架到讲授节奏的完整指南 简介:这份《标准化基础知识培训》PPT面向企业质量、研发与管理人员,以及需要系统了解标准化体系的职场新人,帮助解决标准术语混淆、标准层级不清、体系搭建缺乏依据等常见问题。内容围绕标准化基本术语、发展史、标准分类与体系、标准代号编号… · 2026/11/19 12:16:44
考电工证都要考什么到期换证流程 工地太忙根本没时间复习考试 电工证到底值不值得考 工地太忙根本没时间复习考试,电工证到底值不值得考?这个问题,很多一线工人、转岗人员甚至想换行业的人都在问。尤其在新乡这样的工业城市,建筑施工、电力维护、设备安装等行业对电工证的需求越来越大。… · 2026/11/22 6:22:49
徐泾镇审电工证怎么报?上岗必备的坑别踩 徐泾镇审电工证怎么报?上岗必备的坑别踩 不知道去哪报名怕被中介坑?徐泾镇审电工证是很多电工朋友进工地、上岗必备的敲门砖,可报名渠道复杂、流程不清,稍不留神就掉进中介陷阱。别急,这篇从洛阳涧西区市政工程一线电工视角出发,给你讲明白徐泾镇审电工… · 2026/11/22 6:22:49
苏州吴中电工证哪里考网上查询流程全解析 苏州吴中电工证哪里考网上查询流程全解析 之前考的证在外省能不能转过来?这可能是很多准备报考或已经持证的小伙伴最关心的问题之一。特别是在苏州吴中区这样外来务工人员较多的地方,跨省证书的转换、复审和继续教育问题成了很多电工从业者心头的“老大难”… · 2026/11/22 6:22:49
李堡考电工证2026河南最新政策下如何快速拿到证上岗 李堡考电工证2026河南最新政策下如何快速拿到证上岗 找工作遇到硬门槛?电工证没拿到,面试都过不了!很多在河南李堡地区想从事电工工作的朋友,最头疼的就是这个“证”字。2026年河南最新政策对特种作业证的报考条件、培训方式、考试内容都做了调整… · 2026/11/22 6:22:49
柯桥电工证考核怎么选?良心建议帮你避坑 柯桥电工证考核怎么选?良心建议帮你避坑 你是不是正愁找不到电工证怎么办?是不是因为没证连面试都过不了?别急,我懂你,今天这些建议全是来自一线经验, 良心建议 帮你搞定【柯桥电工证考核】,一步到位,别再走弯路了。… · 2026/11/22 6:21:49
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 平价的电工证查询保姆级教程:别被中介坑,一步步教你搞定 你是不是也经常在网上看到“平价的电工证查询”这样的关键词,但又不知道去哪报名,怕被中介坑?特别是像你这样的平顶山学员,既想考个正规电工证,又怕花冤枉钱走弯路。别担心,这篇保姆级教程就是… · 2026/11/22 0:00:42
麻阳考电工证在哪里考内部消息你知道吗 麻阳考电工证在哪里考内部消息你知道吗 不知道去哪报名怕被中介坑, 内部消息 告诉你,麻阳考电工证不一定要去外地,本地其实也有正规渠道,但很多人因为不了解流程和资质,反而被坑了钱还考不到证。今天我就从一个干了这么多年特种作业培训的“老江湖”角… · 2026/11/22 0:00:43
揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 揭阳普宁电工证换证怎么操作?良心建议帮你理清流程 之前考的证在外省能不能转过来?这是很多已经在外地工作、现在想回揭阳普宁发展的电工朋友最关心的问题。如果你也是其中之一,那这篇文章就是为你们量身定制的,从换证流程到避坑建议,良心建议全给你讲透… · 2026/11/22 0:00:43
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:37
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:30
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/21 15:19:32