开始学 Ptrade，核心路径是：先理解它“本地客户端 + 券商服务端”的运行架构，再掌握 Python 基础与事件驱动策略的固定骨架，接着熟悉数据获取方式，最后在回测环境中反复验证。Ptrade 相比其他工具对新手更友好的一点是，它有内置的零代码策略模板，可以在完全不会写代码时先跑通流程，建立直觉。

下面从环境、策略、数据、代码四个层面分别说明。

环境：分清“本地”与“服务端”

学习 Ptrade 的第一步，是弄清楚什么东西跑在哪里。这直接决定了你遇到问题该去哪里找原因。

本地客户端：你日常操作的是一个安装在 Windows 电脑上的客户端。策略的编写、回测参数的设置、结果的查看，都在这个客户端里完成。Ptrade 目前仅支持 Windows 系统，Mac 无法直接使用。客户端对硬件要求不高，普通办公电脑即可流畅运行。

券商服务端：策略的实际执行、回测计算、模拟/实盘交易运行，是在券商服务端完成的。这意味着客户端关闭或掉线，已经启动的策略在服务端仍会继续执行。你不需要在本地搭建 Python 环境或安装第三方库，Ptrade 平台内置了固定的 Python 环境（版本为 3.5.2），策略中无法导入自有包，所有逻辑必须写在单个策略文件内。

实操起点：联系你的券商开通 Ptrade 权限（通常有一定资金门槛），获取客户端安装包。安装后登录，先不要急着写代码，找到“策略中心”或“模板”区域，用内置的网格交易或均线模板跑一次回测，观察整个流程是如何运转的。

策略：理解事件驱动的固定骨架

Ptrade 的策略不是一段从头到尾执行的脚本，而是由平台在特定时间点调用你写好的函数。新手需要先记住两个必选函数，再逐步扩展。

initialize(context)：策略启动时只执行一次。用来做全局设置，比如设定股票池、基准、手续费，以及初始化一些后面要用的变量。可以把它理解为“开机设置”。

handle_data(context, data)：策略的核心逻辑所在。平台会按照你回测或交易时选择的频率（日线或分钟线）反复调用这个函数。比如你选日线频率，它每天触发一次；选分钟频率，它每分钟触发一次。你的买卖判断、下单动作，都写在这里面。

除了这两个必选函数，还有几个可选但常用的节点：before_trading_start 在每天开盘前执行，适合做盘前准备（如获取当日股票列表、重置状态变量）；after_trading_end 在收盘后执行，适合做当日总结和记录。新手初期先不用全部掌握，把 initialize 和 handle_data 用熟即可。

策略入门路径：先从“双均线”这类最经典的逻辑开始。它的规则极其简单——短期均线上穿长期均线时买入，下穿时卖出。用它来体会“数据获取 → 条件判断 → 调用下单函数”这个完整链条。Ptrade 内置了均线策略模板，可以先看模板的写法，再自己模仿着写一遍。

数据：历史数据用于判断，实时数据用于触发

Ptrade 的数据获取方式比较清晰，主要分两类场景。

历史数据：在 handle_data 或 before_trading_start 中，用 get_history 获取过去 N 个周期的 K 线数据。你需要指定几个关键参数：取多少条（count）、什么频率（'1d' 日线或 '1m' 分钟等）、取哪些字段（收盘价 'close'、最高价 'high' 等）、标的代码是什么。返回的数据通常是 pandas 格式，方便你直接用 .mean() 等方法计算均线。需要注意，Ptrade 只能获取 2005 年之后的数据，且 get_history 默认返回不复权价格，如果策略逻辑依赖复权价，需要手动指定复权参数。

实时数据：在 handle_data 中，函数自带的 data 参数已经包含了当前时刻的行情信息。比如 data['600570.SS']['close'] 可以直接拿到当前价格。如果需要更详细的盘口信息（如买一卖一价、成交量等），可以用 get_snapshot 获取快照数据，但这个函数仅在交易模块可用，回测中无法调用。

新手容易踩的坑：股票代码格式是“代码.交易所”，上海用 .SS，深圳用 .SZ，写错一个字母就会找不到数据。另外，不要在 handle_data 里反复调用 get_fundamentals 获取财务数据，因为这是在线请求，频繁调用会明显拖慢回测速度。正确做法是在 before_trading_start 中获取一次，存入全局变量 g 中，供后续使用。

代码：从模板出发，守住“单文件”约束

Ptrade 的策略代码必须写在一个 .py 文件里，不支持跨文件导入自己的函数或类。这对从零开始的人其实是一件好事：你不需要操心项目结构，一个文件从头写到尾就行。

全局对象 g：这是你在不同函数之间传递数据的唯一便捷方式。比如在 initialize 里设置 g.security = '600570.SS'，在 handle_data 里就可以直接用 g.security 获取标的代码。在 before_trading_start 里算好的指标值，也可以存入 g 中，供盘中逻辑使用。

下单函数：最常用的是 order_value 和 order_target。order_value(标的, 金额) 表示按金额买入或卖出（金额为负表示卖出）；order_target(标的, 目标数量) 表示调整持仓到指定股数（目标为 0 即清仓）。新手建议先用 order_target，因为它的语义最清晰——“我要持有多少股”，不容易因为价格波动导致下单金额算错。

学习节奏建议：第一周，用零代码模板跑通回测流程，理解“回测报告”里各项指标的含义。第二周，打开模板的代码，对照着看每一行在做什么。第三周，自己从零写一个双均线策略，哪怕写得慢，也要独立完成一次“写代码 → 回测 → 看结果 → 改逻辑”的完整循环。回测报告中的最大回撤和收益曲线，比单看收益率更能反映策略的真实风险特征。