openctp-ctpopt

openctp-ctpopt是由 openctp 使用Swig技术制作的CTP股票期权Python版接口。

简化了对接CTP股票期权API的过程，节省精力，快速上手 🚀

---

• 支持版本
• 快速使用
  • 方式一 pip
  • 方式二 手动配置
• 代码示例
• 编码增强
• 字符集问题
• 说明

---

支持版本

CTPAPI(C++)	openctp-ctpopt(python)	win x86	win x64	linux x64
3.7.0	3.7.0.*	✔️	✔️	✔️
3.6.7	3.6.7.*	✔️	✔️	✔️
3.6.3	3.6.3.*	✔️	✔️	✔️
3.5.8	3.5.8.*	✔️	✔️	✔️

用法

提供了两种安装方式: pip install安装、手动下载安装。

方式一：pip install方式

选择一个版本，如 3.7.0

pip install openctp-ctpopt==3.7.0.* -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host=pypi.tuna.tsinghua.edu.cn

引用方法:

from openctp_ctpopt import tdapi, mdapi

方式二： 手动下载方式

手动下载指定版本的动态库文件，并配置库路径。

• Windows

  因为 windows 下，不同的 python 版本编译的动态库之间不可共用，所以不同的 python 版本需要下载指定版本对应的动态库。

  如: 3.7.0-x64, python 3.10

  从目录 3.7.0/win64 和 3.7.0/win64/py310 下载库文件

  将下载的文件放在本地同一个目录下

  # 下载文件
  _thosttraderapi.pyd
  _thostmduserapi.pyd
  thosttraderapi.py
  thostmduserapi.py
  soptthosttraderapi_se.dll
  soptthostmduserapi_se.dll 

• Linux
  选择一个期权ctpapi版本，如: 3.7.0

  从目录3.7.0/linux64下载所有的文件

  将下载的文件放在同一目录下

  _thosttraderapi.so
  _thostmduserapi.so
  thosttraderapi.py
  thostmduserapi.py
  libsoptthosttraderapi_se.so
  libsoptthostmduserapi_se.so

  将文件所在路径配置库路径(specify_path填写自己的路径)

  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:<specify_path>

代码示例

参考 td_demo.py / md_demo.py

通过pip安装的可以直接使用代码示例；手动安装配置的，需要修改一下引入方式, 是import thosttraderapi 而不是import openctp_ctpopt

编码增强

在高级编辑器或IDE中，可以方便的查看接口说明及各字段含义。如下(Pycharm)

.

.

字符集问题

Linux下安装后，需要安装中文字符集，否则导入时报错：

>>> import openctp_ctpopt
terminate called after throwing an instance of 'std::runtime_error'
what():  locale::facet::_S_create_c_locale name not valid
Aborted

需要安装 GB18030 字符集，这里提供 ubuntu/debian/centos 的方案：

# Ubuntu (20.04)
sudo apt-get install -y locales
sudo locale-gen zh_CN.GB18030

# Debian (11)
sudo apt install locales-all
sudo localedef -c -f GB18030 -i zh_CN zh_CN.GB18030

# CentOS (7)
sudo yum install -y kde-l10n-Chinese
sudo yum reinstall -y glibc-common

说明

• openctp-ctp库默认只支持CTP柜台，如需连接TTS、XTP、TORA等柜台，可以使用openctp的CTPAPI兼容接口方式，将CTP的dll（如thosttraderapi_se.dll）替换为相应柜台的版本即可，具体见openctp
• CTPAPI-Python制作攻略： swig转换CTPAPI为Python攻略。
• 用于实盘前请充分测试相应的功能，openctp不对此承担任何责任。