行情接口是数据管道的进水口
做实时交易数据脚本，第一道关卡就是拿到实时行情。行情接口分两类：快照接口和逐笔接口。快照接口返回某一时刻的盘口十档、最新价、成交量等字段，适合做监控面板和简单策略。逐笔接口返回每一笔成交和每一笔委托，数据量大但颗粒度细，适合做订单流分析和高频策略。
公开渠道常见的是Level-1行情，包含最优一档买卖价和成交量。Level-2行情提供十档盘口和逐笔委托，通常需要券商权限或付费数据商。自己写脚本时，先确认数据源授权范围，避免踩到合规红线。行情接口的调用频率通常有限制，免费接口一秒几次，付费接口可以到几十次甚至更高。脚本里要做限流控制，不然会被封IP。
行情字段里最容易被忽略的是时间戳精度。交易所发布的时间戳有毫秒级也有微秒级，脚本必须统一时区并做本地时间校准。盘口数据要做有效性校验，比如买一价小于卖一价、成交量非负、价格在涨跌停范围内。这些校验能过滤掉数据源偶发的脏数据。
交易接口是执行环节的命门
行情有了，下一步是下单。交易接口分查询接口和委托接口。查询接口用来查资金、持仓、当日委托和成交回报，委托接口用来报单、撤单。股票交易接口通常走券商提供的柜台API或者第三方量化平台的中转接口。
自己写脚本对接交易接口，第一件事是搞清鉴权方式。常见的有API Key加Secret签名、OAuth令牌、柜台资金账号加通讯密码。鉴权信息不能硬编码在脚本里，要放到环境变量或加密配置文件中。交易接口的返回码要仔细处理，比如“已报”“部成”“全成”“废单”对应不同状态，脚本要能区分并更新本地订单状态机。
委托接口还有一个关键参数是订单类型。股票实盘常见的是限价单和市价单，部分券商支持对手方最优价格委托。市价单在流动性差的股票上容易滑点，脚本里要设置价格保护，比如偏离最新价超过2%就拒单。撤单接口要注意交易所的撤单频率限制，单账户每秒撤单次数有上限，超了会被限制交易。
推送接口决定脚本的实时性
轮询行情接口能拿到数据，但延迟高、浪费请求配额。真正做实时脚本要用推送接口，也就是WebSocket或TCP长连接。推送接口由数据源主动把行情变化推给脚本，脚本收到消息后触发策略逻辑。
推送接口的关键是断线重连和消息序号校验。网络抖动会导致连接断开，脚本要能自动重连并重新订阅。消息序号用来发现丢包，一旦序号不连续就要主动拉取快照补全数据。推送频率高的场景下，脚本要用异步IO或消息队列做缓冲，避免策略计算阻塞收包线程。
推送接口的订阅粒度也要注意。有的数据源按全市场推送，有的按股票列表订阅。全市场推送数据量大，脚本要做过滤，只处理策略关注的股票池。订阅列表要支持动态更新，盘中临时加股票不能重启脚本。
数据存储与回放是脚本的底座
实时数据拿到后要落盘，方便盘后复盘和策略回测。股票实时数据推荐用列式存储或时序数据库，按天分表，字段包括时间戳、代码、最新价、成交量、买卖档位。落盘时要保留原始推送报文，方便排查数据源问题。
回放模块是脚本的隐藏刚需。策略逻辑写完后，用历史推送数据回放验证，能发现很多实盘才会暴露的问题，比如涨跌停板上的委托被拒、停牌股票没有行情推送、集合竞价阶段数据字段异常。回放速度可以调节，从1倍速到100倍速，方便快速迭代。
脚本的日志要记录三件事：接口调用耗时、数据校验失败次数、订单状态变更。接口调用耗时突然升高往往意味着数据源限流或网络拥塞。数据校验失败次数飙升说明数据源质量下降，要触发降级逻辑，比如切换到备用数据源或暂停策略开仓。
期货实时脚本的差异点
期货实时交易数据脚本和股票有相似之处，但有几个关键差异。期货行情接口要提供买卖各五档盘口和最新结算价、持仓量、成交量。期货交易接口要处理保证金查询、可用资金、平今平昨标志。期货有夜盘，脚本的交易日切换逻辑和股票不同，夜盘属于下一交易日。
期货推送接口的行情频率通常比股票高，商品期货活跃合约一秒可能有几十笔成交。脚本要用更高效的序列化协议，比如Protobuf或FlatBuffers，减少解析开销。期货交易接口的报单还要带上投机套保标志和套利指令，这些字段在股票接口里没有对应。
接口选型的实操建议
自己实现脚本，优先选提供完整文档和测试环境的接口。测试环境能模拟委托和成交回报，方便把订单状态机跑通再上实盘。接口的稳定性比功能丰富更重要，盘中断线一次可能造成直接亏损。
脚本架构上要把行情接收、策略计算、订单执行拆成独立模块，用消息队列解耦。行情模块只负责收数据和校验，策略模块订阅行情做计算，执行模块接收策略信号调交易接口。这样任何一个模块出问题不会拖垮整个脚本。
接口的限流规则要写进脚本的配置里，包括每秒请求数、每日请求总数、并发连接数。超过限流阈值时脚本要自动降频或排队，不能硬怼。交易接口的调用要加幂等设计，同一笔委托重复提交时能识别并拒绝，避免重复下单。
最后提醒一句，实盘接口的权限开通需要走券商流程，部分接口有资金门槛或交易经验要求。脚本写完先在模拟环境跑够两周，把各种异常分支都触发一遍，再考虑接入实盘资金。
