Skip to main content

py_ctp

上期技术期货交易 api 之 python 封装,实现接口调用。支持 windows(x86/x64) linux(x64).

更新

v6.7.10.20250422 全函数封装

ctp 接口封装由 ctp_generate 生成

安装

pip install py-ctp==6.7.10.20260815

示例

#!/usr/bin/env python
# -*- coding: utf-8 -*-
__title__ = 'test py ctp of se'
__author__ = 'HaiFeng'
__mtime__ = '20190506'

from py_ctp.trade import CtpTrade
from py_ctp.quote import CtpQuote
from py_ctp.enums import *
import time


class TestTrade(object):
    def __init__(self, addr: str, broker: str, investor: str, pwd: str, appid: str, auth_code: str, proc: str):
        self.front = addr
        self.broker = broker
        self.investor = investor
        self.pwd = pwd
        self.appid = appid
        self.authcode = auth_code
        self.proc = proc

        self.t = CtpTrade()
        self.t.OnConnected = self.on_connect
        self.t.OnUserLogin = lambda o, x: print('Trade logon:', x)
        self.t.OnDisConnected = lambda o, x: print(x)
        self.t.OnRtnNotice = lambda obj, time, msg: print(f'OnNotice: {time}:{msg}')
        self.t.OnErrRtnQuote = lambda obj, quote, info: None
        self.t.OnErrRtnQuoteInsert = lambda obj, o: None
        self.t.OnOrder = lambda obj, o: None
        self.t.OnErrOrder = lambda obj, f, info: None
        self.t.OnTrade = lambda obj, o: None
        self.t.OnInstrumentStatus = lambda obj, inst, stat: None

    def on_connect(self, obj):
        self.t.ReqUserLogin(self.investor, self.pwd, self.broker, self.proc, self.appid, self.authcode)

    def run(self):
        self.t.ReqConnect(self.front)
        # self.t.ReqConnect('tcp://192.168.52.4:41205')

    def release(self):
        self.t.ReqUserLogout()


class TestQuote(object):
    """TestQuote"""

    def __init__(self, addr: str, broker: str, investor: str, pwd: str):
        """"""
        self.front = addr
        self.broker = broker
        self.investor = investor
        self.pwd = pwd

        self.q = CtpQuote()
        self.q.OnConnected = lambda x: self.q.ReqUserLogin(self.investor, self.pwd, self.broker)
        self.q.OnUserLogin = lambda o, i: self.q.ReqSubscribeMarketData('rb2409')

    def run(self):
        self.q.ReqConnect(self.front)

    def release(self):
        self.q.ReqUserLogout()


if __name__ == "__main__":
    front_trade = 'tcp://180.168.146.187:10202'
    front_quote = 'tcp://180.168.146.187:10212'
    broker = '9999'
    investor = ''
    pwd = ''
    appid = ''
    auth_code = ''
    proc = ''
    if investor == '':
        investor = input('invesotr:')
        pwd = input('password:')
        appid = input('appid:')
        auth_code = input('auth code:')
        proc = input('product info:')
    tt = TestTrade(front_trade, broker, investor, pwd, appid, auth_code, proc)

发布到 PyPI

从 2023 年起,PyPI 不再支持用户名/密码认证,必须使用 API Token 或 Trusted Publishers。

方法一:使用 API Token(推荐)

  1. 访问 PyPI 并登录
  2. 进入 Account Settings 页面
  3. 找到 "API tokens" 部分并点击 "Add API token"
  4. 为 Token 添加描述(例如:py_ctp release)
  5. 选择作用域(Scope),通常选择 "Upload packages"
  6. 点击 "Add token" 并复制生成的 Token

有了 API Token 后,有两种使用方式:

选项 1:使用 .pypirc 配置文件

创建或编辑 ~/.pypirc 文件:

[pypi]
username = __token__
password = pypi-*******************************

将 pypi-******************************* 替换为你刚刚生成的实际 API Token。

然后正常执行发布命令:

rm dist -rf && python setup.py sdist && twine upload dist/*
rm dist -rf && python setup.py bdist_wheel && twine upload dist/*.whl

选项 2:使用命令行参数

rm dist -rf && python setup.py sdist && twine upload -u __token__ -p pypi-******************************* dist/*

方法二:使用 Trusted Publishers(适用于 GitHub Actions 等 CI/CD)

如果你使用 GitHub Actions 或其他 CI/CD 系统,可以配置 Trusted Publishers 实现自动发布。

详细信息请参考官方文档:

Metadata

Release files for py-ctp 6.7.10.20260818

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py-ctp 6.7.10.20260818
File Size Uploaded Provenance
py_ctp-6.7.10.20260818.tar.gz 10.6 MB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for py-ctp 6.7.10.20260818
File Interpreter ABI Platform
py_ctp-6.7.10.20260818-py3-none-any.whl Python 3 none any Details

Total release size: 21.3 MB

Release files / py_ctp-6.7.10.20260818.tar.gz

Download URL py_ctp-6.7.10.20260818.tar.gz
Size 10.6 MB
Tags Source
SHA-256 checksum
How to use checksums
a07e990f79f549c61351a4e6d2f04894353b36599dd16381c08cd7e875026640
BLAKE2b-256 checksum
How to use checksums
c6c35c968e4274915f563f84b2ee8246b8231a643eed49d912f0219fdae1bd2c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / py_ctp-6.7.10.20260818-py3-none-any.whl

Download URL py_ctp-6.7.10.20260818-py3-none-any.whl
Size 10.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a292b09059d648c526f357fbfacea33f5e7d0997770514e2dbc15545cf6dbbf4
BLAKE2b-256 checksum
How to use checksums
9bd8b42725f6c50ac2b0d87d2cdaae27598771859933dc62866b14851cf70dfd
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for py-ctp 6.7.10.20260818

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page