algoderiv/agent-skills/ctp-api
Claude Code and agent skill by algoderiv/agent-skills
- community
Checking that the SKILL.md file is still in the repository.
CTP (Comprehensive Transaction Platform) 6.7.8 API documentation for futures and options trading in China. Use this skill for understanding CTP trading interfaces, market data subscription, order execution, position management, and account queries.
Install
npx vskill@latest install algoderiv/agent-skills/ctp-apiSKILL.md
CTP 6.7.8 API Skill
CTP(综合交易平台)是中国期货市场最广泛使用的交易接口。本技能涵盖 CTP 6.7.8 版本的完整 API 文档,包括交易接口、行情接口、数据结构和错误处理。
When to Use This Skill
This skill should be triggered when:
- 使用 CTP API 进行期货/期权交易开发
- 实现行情订阅和数据处理
- 处理订单提交、撤单、查询操作
- 理解 CTP 回调机制和事件处理
- 调试 CTP 连接、登录、交易问题
- 查询账户资金、持仓、成交记录
Quick Reference
核心类
| 类名 | 用途 | |
|---|---|---|
CThostFtdcTraderApi | 交易接口主类,处理订单、查询 | |
CThostFtdcMdApi | 行情接口主类,订阅市场数据 | |
CThostFtdcTraderSpi | 交易回调接口,接收交易响应 | |
CThostFtdcMdSpi | 行情回调接口,接收行情数据 |
常用请求方法 (TraderApi)
常用回调方法 (TraderSpi)
行情接口 (MdApi)
关键数据结构
常见错误码
| 错误码 | 含义 | |
|---|---|---|
| 0 | 成功 | |
| 3 | 不合法的登录 | |
| 5 | 用户未登录 | |
| 13 | 资金不足 | |
| 14 | 报单数量不合法 | |
| 22 | 合约代码错误 | |
| 25 | 平仓量超过持仓量 | |
| 30 | CTP未初始化 | |
| 31 | 前置不活跃 |
Reference Files
This skill includes comprehensive documentation in references/ (52 files, ~1.1MB total):
| 类别 | 文件 | 描述 | |
|---|---|---|---|
| 入门 | getting_started_*.md | 入门指南、阅读指引 (3 files) | |
| 交易接口 | trader_api.md | CThostFtdcTraderApi 类 | |
| 行情接口 | md_api.md | CThostFtdcMdApi 类 | |
| 交易回调 | trader_spi.md | CThostFtdcTraderSpi 回调 | |
| 行情回调 | md_spi.md | CThostFtdcMdSpi 回调 | |
| 请求方法 | requests_*.md | Req* 方法 (5 files) | |
| 回调方法 | callbacks_*.md | OnRsp/OnRtn (10 files) | |
| 交易功能 | trading_*.md | 交易相关 (5 files) | |
| 行情功能 | market_data_*.md | 行情相关 (5 files) | |
| API参考 | api_reference_*.md | 完整 API (14 files) | |
| 版本记录 | changelog_*.md | 更新日志 (4 files) | |
| 监管 | monitoring.md | 看穿式监管说明 |
Working with This Skill
交易流程
- 初始化:
CreateFtdcTraderApi()创建 API 实例 - 注册:
RegisterSpi()注册回调,RegisterFront()注册前置地址 - 连接:
Init()启动连接,等待OnFrontConnected()回调 - 认证:
ReqAuthenticate()客户端认证(看穿式监管) - 登录:
ReqUserLogin()用户登录 - 交易: 发送报单、查询等请求
- 释放:
Release()释放资源
行情流程
- 初始化:
CreateFtdcMdApi()创建行情 API - 注册: 注册 Spi 和前置地址
- 连接:
Init()启动,等待OnFrontConnected() - 登录:
ReqUserLogin()登录行情服务器 - 订阅:
SubscribeMarketData()订阅合约行情 - 接收: 通过
OnRtnDepthMarketData()接收行情推送
注意事项
- 所有请求都是异步的,通过回调返回结果
- 每个请求需要唯一的 RequestID
- 登录前需要先完成看穿式客户端认证
- 流控限制:每秒最多 1-2 个请求
- 注意处理断线重连逻辑
Source
- PDF: CTP 6.7.8 API接口说明
- Pages: 2466
- Version: 6.7.8
- Date: 2024-12
Notes
- 本技能从官方 PDF 文档自动提取
- 包含完整的 API 方法、回调、数据结构
- 代码示例为 C++ 风格,Python 绑定方法名相同
- 详细信息请参考 references/ 目录下的分类文档
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/ctp-api/SKILL.md
Popularity
- Repository stars
- 53
- Repository forks
- 3
- 7-day trend score
- 20
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 1 May 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/algoderiv/agent-skills/ctp-api)