期货量化交易入门系列三——CTP生产API版本、评测API版本及SIMNOW环境

一、CTP API版本分类

1. 生产API版本

• 定义：用于实盘交易或与生产环境兼容的API版本，需通过穿透式监管认证。
• 版本号：
  • 穿透式生产版：从 v6.3.15_20190220 开始，后续版本如 6.6.1 也属于生产版。
  • 最新版本：目前最新为 v6.7.9_P1_20250319，支持更长的合约代码（InstrumentID扩展至80字节）。
• 用途：
  • 实盘交易：需通过期货公司接入生产环境。
  • SimNow仿真环境：必须使用生产版API（如6.3.15及以上）。
• 兼容性：
  • 若使用旧版本（如6.3.11及以前），无法连接穿透式监管升级后的柜台，且不会触发OnFrontConnected回调。

2. 评测API版本

• 定义：用于期货公司内部评测的过渡版本，需通过穿透式监管测试。
• 版本号：
  • 穿透式评测版：如 v6.7.9_P1_CP_20250225，用于评测阶段，未通过测试则无法接入生产环境。
• 用途：
  • 期货公司内部对客户策略进行合规性测试。
  • 开发者需在评测通过后，切换至生产版API进行实盘交易。

3. 生产和评测合二为一API版本

从6.7.11版本开始，交易和行情API的评测与生产版本合并，若不修改默认模式，默认接入的是生产版本。

交易TraderAPI和行情MdAPI的评测版本与生产版本合并

交易TraderAPI和行情MdAPI，均增加一个bool类型的默认参数blsProductionMode，表示api是否使用生产模式，true 为生产模式（默认值），false为测评模式。

即：

1)traderapi的接口由 “CreateFtdcTraderApi(const char pszflowPath=“”); ”改为 “CreateFtdcTraderApi(const charpszflowPath =“”,bool blsProductionMode=true);”。

2)mdapi的接口由 “CreateFtdcMdApi(const char *pszFlowPath = “”, const bool blsUsingUdp=false, const bool blsMulticast=false);”改为“CreateFtdcMdApi(const char *pszFlowPath = “”, const bool blsUsingUdp=false, const bool blsMulticast=false, bool blsProductionMode=true);” 。

二、SIMNow环境详解

1. 环境定位

• 官方模拟平台：由上海期货交易所全资子公司上期技术运营，用于策略验证和系统测试。
• 特点：
  • 与实盘高度一致：交易规则、合约代码、结算逻辑均模拟实盘。
  • 支持穿透式监管：需使用生产版API（6.3.15及以上）。

2. 环境配置

• 登录信息：

  • BrokerID: 9999
  • AppID: simnow_client_test
  • AuthCode: 0000000000000000（16个0）。
  • 支持上期所期权、能源中心期权、中金所期权、广期所期权、郑商所期权、大商所期权
  • 交易品种：六所所有期货品种以及上期所、能源中心、中金所、广期所
  • 账户资金：初始资金两千万，支持入金，每日最多三次。
  • 交易阶段(服务时间)：与实际生产环境保持一致。

• 前置地址：

  • 第一组：
    • 交易前置：tcp://182.254.243.31:30001
    • 行情前置：tcp://182.254.243.31:30011
  • 第二组：
    • 交易前置：tcp://182.254.243.31:30002
    • 行情前置：tcp://182.254.243.31:30012
  • 第三组：
    • 交易前置：tcp://182.254.243.31:30003
    • 行情前置：tcp://182.254.243.31:30013
  • 7x24环境（第二套环境）：
    • 交易前置：tcp://182.254.243.31:40001
    • 行情前置：tcp://182.254.243.31:40011

第二套环境仅服务于CTP API开发爱好者，仅为用户提供CTP API测试需求，不提供结算等其它服务。
新注册用户，需要等到第三个交易日才能使用第二套环境。
账户、钱、仓跟第一套环境上一个交易日保持一致。
交易阶段(服务时间)：交易日，16:00～次日09:00；非交易日，16:00～次日12:00。
用户通过SimNow的账户（上一个交易日之前注册的账户都有效）接入环境，建议通过商业终端进行模拟交易的用户使用第一套环境。

3. 使用限制

• 交易时间：第一套环境与实盘一致，上午时段：9:00–10:15、10:30–11:30，下午时段：13:30–15:00‌‌
  ）。7x24小时环境在非交易时间段开放，具体在下午16点后，资金持仓使用正式环境中的上一日数据。
  中国金融期货交易所：上午：09:30-11:30，下午：13:00-15:15
• 数据限制：
  • 不支持逐笔成交数据（仅提供快照数据，每秒2次切片）。
  • 组合合约行情需自行计算，CTP仅转发交易所原始数据。
• 维护周期：常因系统升级暂停服务，建议备用其他仿真环境（如openctp的TTS）。
• 模拟入金：在SimNow官网，每日可入金三次，单次入金上限为200万。
• API版本：SimNow上必须使用生产版本API，评测版本无法使用，上面API下载地址中的API生产版本在SimNow中均可正常使用。
• SimNow账号：首次在SimNow官网上注册账号后需要激活一次才能正常使用。

三、生产环境与评测环境的对比

四、常见问题与注意事项

1. 版本兼容性：

   • 若使用错误版本（如评测版连生产环境），会导致连接失败或无回调响应。
   • 可通过GetApiVersion()函数检查当前API版本。

2. SimNow使用建议：

   • 数据过滤：非交易时段可能收到重复行情（如夜盘数据重演），需按时间戳过滤。
   • 合约代码规范：各交易所合约命名不同（如中金所为大写+4位数字），需严格匹配。

3. 替代方案：

   • OpenCTP：支持7x24模拟交易，兼容CTP API，且提供股票、期货、期权全品种仿真。
   • TTS平台：提供类似SimNow的功能，支持负价合约和更多撮合模式。

五、总结

• 生产API是实盘交易的必经之路，版本迭代需紧跟穿透式监管要求。
• 评测API是过渡工具，确保策略合规后需切换至生产版。
• SimNow作为官方模拟平台，虽存在维护频繁的问题，仍是上实盘前的重要测试环节，可结合其他仿真环境提升开发效率。

如需具体代码示例或接入细节，可参考CTP官方文档或社区开源项目。