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.20260817

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.20260817
File Size Uploaded Provenance
py_ctp-6.7.10.20260817.tar.gz 10.6 MB Without provenance Details

Built distribution (wheel)

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

Total release size: 21.3 MB

Release files / py_ctp-6.7.10.20260817.tar.gz

Download URL py_ctp-6.7.10.20260817.tar.gz
Size 10.6 MB
Tags Source
SHA-256 checksum
How to use checksums
3bfd781b4932dbf62250a9b6aa3abdce92f162494bc4ce6d2f66f4cbd41cc3ee
BLAKE2b-256 checksum
How to use checksums
35a6c11ec72c7ab75f756f01f40f0bcf7e5cba81e54205b18e012683d3238a09
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.20260817-py3-none-any.whl

Download URL py_ctp-6.7.10.20260817-py3-none-any.whl
Size 10.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
bbbc3d9df0f4b17a42a5c95b54727a6e2ebb738a7f3fcf54dabf7d6d0c562e3e
BLAKE2b-256 checksum
How to use checksums
b84806075341f17f84a728490d05507258ebd1a7a794f260c4ebcdd549a0256c
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.20260817

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