Ptrade API 文档项目

Ptrade量化交易API的完整文档库 - 基于三个主要版本的详细对比分析和使用指南

如需了解与 Ptrade 接口相关的官方接入说明与流程，请私信，我会提供“仅含官方信息来源”的参考路径。 Ptrade开发者圈QQ群590529320

🎯 项目简介

Ptrade是由恒生电子开发的量化交易API平台，被多家券商采用并进行定制化部署。本项目整理了三个主要版本的完整文档，包括：

• 东莞证券版本 (PBOXQT1.0V202202.01.041) - 最新功能版本
• 国盛证券版本 (PBOXQT1.0V202202.01.016) - 稳定标准版本
• 社区维护版本 (PBOXQT1.0V202202.00.005) - 社区增强版本

✨ 项目特色

📊 基于实际API文档的版本对比

• 通过对比三个版本的真实API文档发现技术差异
• 详细分析函数调用和返回值的具体差异
• 提供升级指南和兼容性建议

🔍 完整的功能分类和索引

• 按功能分类整理所有API接口
• 清晰标注各版本的支持情况
• 提供完整的策略示例库

💡 实用的最佳实践

• 基于官方QA文档的最佳实践
• 性能优化和稳定性建议
• 错误处理和调试技巧

📚 丰富的学习资源

• 从基础到高级的完整策略示例
• 详细的财务数据API文档
• 有用链接和学习资源汇总

🚀 快速开始

1. 选择您的版本

根据您使用的券商环境选择对应版本：

券商	版本号	特点	推荐用途
东莞证券	V041	最新功能，完整支持	专业交易，需要最新特性
国盛证券	V016	稳定可靠，标准功能	生产环境，追求稳定性
社区维护	V005	学习友好，示例丰富	学习研究，功能探索

👉 不确定选哪个？ 查看 版本选择指南 或 详细版本对比

2. 根据您的需求选择入口

🎓 我是新手，想学习

• 📖 入门指南 - 从零开始学习Ptrade
• 💡 策略示例 - 看实际代码学习
• 📚 完整文档导航 - 文档库总入口

🔍 我要查API接口

• 📋 API参考文档 - 完整的API接口说明和导航
• 🔖 API分类索引 - 按功能分类的接口速查表
• 📊 行业概念数据 - 行业分类和概念板块数据

⚖️ 我要对比版本差异

• 🔍 版本差异对比 - 主要技术差异分析
• 📊 版本详细信息 - 完整的版本功能对比和选择指南
• 📄 原始文档 - 三个版本的完整原始API文档

❓ 我遇到了问题

• 🔧 高级功能和FAQ - 常见问题、支持库、版本变更等
• ❓ 常见问题解答 - 详细的问题排查指南

📁 文档结构

docs/
├── README.md              # 📚 文档库总入口
├── getting-started/       # 🎓 入门指南
│   ├── README.md          # 入门导航
│   ├── quick-start.md     # 快速开始
│   └── ...               # 其他入门文档
├── api-reference/         # 📋 API参考文档
│   ├── README.md          # API文档主页和导航
│   ├── stock-trading.md   # 股票交易接口
│   ├── market-data.md     # 市场数据接口
│   ├── technical-indicators.md # 技术指标接口
│   └── ...               # 其他API模块文档
├── examples.md           # 💡 策略示例库
├── api-classification.md  # 🔖 API分类索引
├── industry-concept-data.md # 📊 行业概念分类数据
├── versions/              # ⚖️ 版本信息和对比
│   ├── README.md          # 版本选择指南
│   ├── version-comparison-table.md # 功能对比表
│   └── ...               # 其他版本文档
├── version-differences.md # 🔍 版本差异对比
├── original/              # 📄 原始文档
│   ├── README.md          # 原始文档导航
│   ├── Ptrade社区.md      # 社区版本原始文档
│   ├── Ptrade国盛.md      # 国盛版本原始文档
│   └── ...               # 其他原始文档
└── advanced/              # 🔧 高级功能
    ├── README.md          # 高级功能导航
    ├── faq.md            # 常见问题解答
    └── ...               # 其他高级文档

🔍 主要发现

关键技术差异

通过对比三个版本的实际API文档，我们发现了以下重要差异：

1. 委托状态字段类型变化 ⚠️ (最重要)

# V005: int类型
if order.status == 8:

# V016/V041: str类型
if order.status == '8':

2. 版本独有功能

• V005独有: 企业微信推送、资金调拨、邮件设置
• V016缺少: 企业微信、可转债专门接口、融券信息查询
• V041最全: 包含所有新功能和最新字段更新

3. 技术指标支持

• V005: 需手动计算MACD等指标
• V016/V041: 内置get_MACD(), get_KDJ(), get_RSI(), get_CCI()

📖 使用指南

🎯 按角色导航

新手用户

1. 了解基础 → 入门指南
2. 看代码学习 → 策略示例
3. 查找接口 → API参考

开发者

1. 查看完整API → API参考文档
2. 学习最佳实践 → 策略示例
3. 处理版本兼容 → 版本差异对比

运维人员

1. 了解平台限制 → 版本差异说明
2. 解决常见问题 → FAQ问答
3. 查看支持库 → 高级功能

📚 学习资源

• 策略示例库 - 从基础到高级的完整示例
• 高级功能 - 常见问题、支持库、版本变动

🤝 贡献指南

本项目基于公开的API文档整理，欢迎贡献：

1. 发现错误: 提交Issue报告文档错误
2. 补充内容: 提交PR添加新的策略示例或最佳实践
3. 版本更新: 帮助更新新版本的API差异

⚠️ 免责声明

• 本项目仅用于学习和研究目的
• 所有策略示例仅供参考，实盘交易请充分测试
• 具体API功能以各券商实际部署为准
• 投资有风险，交易需谨慎

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

---

最后更新: 2024年12月 维护状态: 活跃维护中 文档版本: 基于三个主要版本的实际API文档整理