量化交易软件ptrade获取get_stock_exrights函数详细教程！

我们上班会看工资条，知道每个月发了多少工资、有没有奖金；买基金也会看分红记录，知道什么时候能拿到收益，那我们怎么在Ptrade中看见股票的 "分红送股账本"呢？今天就来带大家了解get_stock_exrights函数。

get_stock_exrights函数的作用特别好理解：查询股票历史上的分红、送股、配股记录（这些都叫 "除权除息"）。返回的结果是一张表格，清清楚楚列着每一次的时间和具体内容，比如 "2023 年 6 月 1 日，每 10 股送 5 股、分红 2 元"。

举个生活中的例子：就像查家里的 "存款利息记录本"，输入银行卡号（类似股票代码），就知道每年什么时候结过息、结了多少 ——get_stock_exrights就是这样，输入股票代码，就知道它过去的分红送股情况。

函数怎么用呢？

get_stock_exrights函数用法很直接，核心是告诉它 "查哪支股票"，想查特定日期的话再补充日期就行：

l 第一个参数（必须写）：股票代码（带市场后缀，比如.SS、.SZ）；

第二个参数（可选）：要查的日期（格式是 YYYYmmdd，比如 2023 年 5 月 10 日写 "20230510"），不写就查这支股票所有历史记录。

重点看 3 个实用字段（不用记全，记关键的）表格里字段很多，咱们重点看 3 个和收益相关的，其他字段不用深究：

实战演练：

场景 1：模拟查一支股票的所有分红送股记录

逻辑：模拟查工商银行（601398.SS）所有历史分红送股记录，了解它的 "赚钱能力"。

运行后会看到什么？会显示类似这样的表格：

场景 2：模拟查一支股票某一天的分红送股记录

逻辑：模拟查贵州茅台（600519.SS）2025 年 6 月 26 日的分红送股记录，看当天有没有 "福利"。

运行后会看到什么？如果当天有记录，会显示如下：

意思是：2025 年 6月 26 日，贵州茅台每 10 股分红 276 元（27.6×10=276），没有送股 。

新手要注意的点：

1）日期格式别写错

日期必须是 "YYYYmmdd" 的格式，比如 2023 年 10 月 1 日要写 "20231001"，不能写 "2023-10-01" 或 "2023/10/01"，不然查不到结果。

2）没记录会返回 None

如果查的日期没有分红送股，函数会返回 "None"，不用慌，这说明当天没有相关操作，不是代码错了。

get_stock_exrights函数就是股票的 "分红送股账本"，核心作用就一个：查股票过去什么时候送过股、分过红，以后想知道一支股票是不是 "大方"（经常分红），用这个函数一查就清楚，选股票更有底。