对于刚接触量化交易的新手来说，PTrade 的 Python API 是开启自动化交易的第一步。本教程将从 零基础 开始，带你一步步完成 环境配置、API 接口调用、并执行第一个订单。

一、什么是 PTrade Python API？

PTrade 是一个支持 Python 编程语言 的量化交易平台，它提供了一套完整的 API 接口，允许用户通过编写 Python 代码来实现：

• 获取股票数据
• 下单买卖
• 管理持仓
• 查看账户信息
• 策略回测等

二、准备工作（10 分钟）

✅ 步骤 1：开通 PTrade 权限

• 联系合作券商（如国金证券、银河证券等）开通 PTrade 量化权限；
• 需满足一定资金要求（一般为 5 万元以上）；
• 获取 API 接口文档 和 模拟交易账号。

建议先使用 模拟盘 练手，避免实盘风险。

✅ 步骤 2：安装 Python 环境

• 安装 Python 3.6+（推荐使用 Anaconda 或 PyCharm 环境）；
• 打开命令行（Windows 可以使用 CMD 或 PowerShell，Mac/Linux 使用 Terminal）；
• 安装 PTrade 相关依赖库：

pip install ptrade

如果遇到网络问题，可以尝试更换 pip 源，例如：

pip install ptrade -i https://pypi.tuna.tsinghua.edu.cn/simple

三、第一个 PTrade Python API 示例

1. 初始化 PTrade 对象

from ptrade import PTrade

# 创建 PTrade 实例
ptrade = PTrade()

2. 登录账户

# 登录 PTrade 账户
ptrade.login('your_username', 'your_password')

请确保你已经获取了 模拟交易账号和密码，如果未注册，需要联系券商开通。

3. 获取股票数据（可选）

# 获取某只股票的历史数据
data = ptrade.get_stock_data('600519.SS', '2023-01-01', '2023-10-01')

# 打印前几条数据
print(data.head())

这一步用于验证 API 是否正常工作。

4. 下单操作（核心）

# 下单函数示例
order = ptrade.order('600519.SS', 'buy', 100, 20.0)

# 打印订单信息
print(f"订单 ID: {order.order_id}")
print(f"状态: {order.status}")

security：股票代码，格式为 '600519.SS'（上证）或 '000001.SZ'（深证）direction：方向，'buy' 表示买入，'sell' 表示卖出amount：数量（必须是 100 的整数倍）price：价格（可选，默认按最新价下单）

5. 查询订单状态

# 查询订单状态
status = ptrade.get_order_status(order.order_id)
print(f"订单状态: {status}")

6. 撤单操作（可选）

# 撤单
ptrade.cancel_order(order.order_id)

四、完整代码示例

from ptrade import PTrade

# 初始化 PTrade 实例
ptrade = PTrade()

# 登录
ptrade.login('your_username', 'your_password')

# 获取股票数据（可选）
data = ptrade.get_stock_data('600519.SS', '2023-01-01', '2023-10-01')
print("历史数据:")
print(data.head())

# 下单
order = ptrade.order('600519.SS', 'buy', 100, 20.0)
print(f"\n下单成功！订单ID: {order.order_id}")

# 查询订单状态
status = ptrade.get_order_status(order.order_id)
print(f"订单状态: {status}")

# 撤单（可选）
# ptrade.cancel_order(order.order_id)

五、常见问题与解决方法

六、下一步学习建议

• 学习更多 API 函数：如 get_realtime_quote()、get_position()、get_portfolio() 等；
• 尝试编写简单策略：如均线交叉、网格交易等；
• 了解 PTrade 的 事件驱动框架（initialize, handle_data 等）；
• 探索 PTrade 的 回测功能，优化策略逻辑。

七、总结：零基础也能玩转 PTrade Python API

一句话总结

PTrade 的 Python API 是量化交易的“第一把钥匙”，学会它，你就可以开始编写自己的交易策略，实现自动化交易。

如果你还不会 Python，别担心！我们可以从最简单的语法开始学起，我也可以帮你完成 PTrade 的账户开通与 API 接入。欢迎随时联系我！开户找我优惠多多！选8888资金靓号！ETF佣金万0.5！逆回购手续费百万分之一！免费量化qmt/ptrade！更多优惠欢迎找我！