合规声明：本文仅为量化交易 API 功能科普教学，不构成任何投资建议、交易策略推荐。证券市场有风险，投资需谨慎，量化交易需充分了解市场规则与潜在风险，务必先通过模拟交易充分验证后，再谨慎参与实盘操作。

很多刚接触量化交易的朋友，总会被各类代码和函数劝退。但其实搭建一个基础的量化策略，核心就是完成「数据获取 - 指标计算 - 交易执行」的完整闭环，而这整个流程，只需要吃透 PTrade 里 4 个核心函数就能实现。今天就用零基础也能看懂的方式，不带代码，带大家逐个拆解每个函数的作用、用法和注意事项，新手也能快速摸清量化交易的核心逻辑。

一、行情数据下载：download_history_data 函数

做量化回测和策略分析，第一步永远是拿到完整、准确的历史行情数据，而这个函数，就是 PTrade 里专门用来下载历史行情的核心工具。

它的核心作用，就是把你指定的股票、指定周期、指定时间段的历史行情数据，提前下载到本地，保证后续策略回测、指标计算的时候，有稳定的数据支撑，不用临时调取数据影响策略运行。

股票可做万0.854（满足资金条件可协商）

使用这个函数，只需要填准 4 个核心信息即可：

1. 你要下载数据的标的股票代码，需要附带对应的交易所后缀，区分沪市和深市标的；
2. 你需要的数据周期，这个函数支持 tick 级、1 分钟、5 分钟、日线等多种常用周期，完全能覆盖日内短线、中长线等不同策略的需求；
3. 数据的起始日期，也就是你要下载的历史数据从哪一天开始；
4. 数据的结束日期，也就是你要下载的历史数据截止到哪一天。
5. 这里有两个关键的使用提示：
6. 第一，1 分钟级别和 tick 级别的高频数据，数据体量非常大，如果下载的时间跨度很长，一定要提前确认好硬盘容量，避免出现存储不足、数据下载不全的问题；
7. 第二，数据下载的操作，建议放在策略的初始化环节执行，这样能保证策略正式运行前，所有需要的数据都已经下载完毕，不会出现策略运行中数据缺失的情况。

二、行情数据提取：get_market_data_ex 函数

完成行情数据下载之后，我们不需要用到所有的行情信息，只需要提取策略能用到的核心字段，这个函数，就是专门用来精准提取行情数据的核心接口，也是我们做技术指标计算、交易信号判断的核心基础。

我们日常交易中关注的开盘价、收盘价、最高价、最低价、最新价、成交量，还有大单金额、主力净买入净卖出、涨跌停价格等扩展行情数据，都可以通过这个函数，快速、精准地提取出来。

使用这个函数，核心是设置好几个关键信息：

1. 你需要提取的行情字段，既可以只提取收盘价这一个字段，也可以同时批量提取多个你需要的行情字段；
2. 你要提取数据的标的，既可以只查单只股票，也可以批量传入一整个股票池，一次性提取多只标的的行情数据，不用逐个操作；
3. 数据的周期、起止时间，需要和你之前下载的数据周期匹配，保证数据能对应上；
4. 你需要提取的数据数量，既可以提取指定时间段内的全部数据，也可以固定提取最近的多少根 K 线数据，适配不同的指标计算需求。
5. 这个函数的适用场景非常广，不管是回测中计算均线、MACD、KDJ 等各类技术指标，还是实盘盘中实时获取最新价格，判断交易信号，都可以通过这个函数完成，几乎能适配绝大多数技术面策略的开发需求。

三、基本面财务数据获取：get_financial_data 函数

量化交易不只有技术面策略，基本面选股、价值投资类的策略，同样可以通过量化实现，而这个函数，就是我们获取上市公司基本面财务数据的核心工具。

上市公司的总股本、净利润、经营现金流、资产负债情况等全维度的财务数据，都可以通过这个函数批量获取。有了这些基础财务数据，我们就能计算出市盈率（PE）、市净率（PB）、净资产收益率（ROE）、每股收益（EPS）等市场常用的基本面指标，轻松搭建起基本面选股、价值投资类的量化策略。

使用这个函数，核心要设置好 4 个关键信息：

1. 你需要提取的财务指标，按照规范填写对应的财务字段，就能精准提取到对应的财务数据；
2. 你要查询的标的股票，同样支持单只股票查询，也支持多只标的、全市场标的批量提取；
3. 财务数据的起止日期，划定你要查询的财务数据的时间范围；
4. 财报时间的匹配规则，可以根据策略需求，选择按财报发布时间匹配，或是按财报对应的报告期时间匹配。
6. 这个函数最大的优势，就是省去了我们手动逐个查询上市公司财报、手动整理财务数据的繁琐工作，通过函数就能批量获取全市场标的的财务数据，大幅提升基本面选股、财务指标筛选的效率，是搭建基本面量化策略的核心工具。

四、交易执行：passorder 下单函数

当我们通过行情数据、财务数据完成了策略的计算和判断，确定了要交易的标的、交易的方向、交易的价格和数量这些核心参数之后，就需要通过这个函数，完成最终的交易下单操作，这也是量化策略从回测验证，到实盘落地的最后一步。

这个函数的核心作用，就是把我们的策略交易信号，转化为实际的交易委托，对接交易通道完成下单，实现策略的自动化交易。

使用这个函数，有几个核心的参数必须设置准确，也是最容易出问题的地方：

1. 交易方向，必须明确区分买入和卖出，一旦填反就会造成完全相反的交易操作，引发不必要的亏损；
2. 交易标的的股票代码，必须准确填写，避免买错、卖错标的；
3. 下单方式，支持按最新价、限价、涨跌停价等多种委托模式，可以根据自己的策略需求灵活选择；
4. 下单数量，必须符合 A 股的交易规则，股票买入委托需要为 100 股的整数倍，避免出现委托无效的情况；
5. 对应的证券账户信息，确保委托下单到对应的账户中。
6. 关于这个函数，有几个必须重点强调的合规与风险提示：
7. 第一，这个函数直接对接实盘交易通道，必须先在模拟盘环境中反复测试，确认委托条件、参数设置完全无误后，再谨慎用于实盘操作，绝对避免因为代码错误、参数填错，造成非预期的交易和资金亏损；
8. 第二，示例中的条件仅为功能演示，实盘使用时，必须替换为经过充分回测、模拟验证的策略触发条件，严禁无规则、无纪律的频繁下单；
9. 第三，实盘交易过程中，必须严格遵守证券交易所的相关交易规则，不得利用该函数进行异常交易、违规交易等操作。

结尾总结

以上 4 个函数，已经完整覆盖了量化策略从「数据下载 - 行情提取 - 基本面数据获取 - 交易执行」的全流程，也是 PTrade 量化交易中，最核心、最常用、最基础的 4 个函数。

对于量化新手来说，完全不用急于搭建复杂的多因子策略，先从这 4 个函数入手，在模拟环境中逐个测试，吃透每个函数的作用、每个核心设置的含义，先完成 “获取数据 - 查看数据 - 模拟下单” 的基础流程，再逐步叠加自己的交易逻辑，就能稳步入门量化交易。

最后再次提醒：股市有风险，投资需谨慎。量化交易只是提升交易效率的工具，并非稳赚不赔的捷径，任何策略都需要经过充分的回测与模拟验证，再结合自身的风险承受能力谨慎使用。