波波 API多维表格港美股管理：股价定时更新与收益仪表盘
同时持有 A 股、港股、美股的人都懂：三个市场、三种币种，收盘价要一个个查，汇率要手动折算，Excel 记的持仓表永远是旧的。飞书官方「飞书 AI 最佳实践」知识库里的「个人港美股管理」模板用多维表格解决了这件事——字段捷径自动查股价，自动化每天定时刷新，仪表盘自动汇总收益。本文拆解这套模板的完整结构和配置方法。
整体功能
- 通过多维表格字段捷径，自动查询股票收盘价格；
- 仪表盘自动汇总个人收益。
模板（名为「投资总表」）由 7 张数据表组成：
| 数据表 | 作用 |
|---|---|
| 持仓管理 | 核心表：当前持仓、成本、最新价、市值、盈亏 |
| 美港股自选 | 观察池：目标买入价、距离目标%、量价数据 |
| A股自选 | A 股观察池 |
| 现金账户表 | 各币种现金余额，折算人民币 |
| 汇率配置表 | 币种对人民币汇率 |
| 个股PE估值 | 单只重仓股的估值测算 |
| 错误日志 | 记录自动更新失败的情况 |
核心：用字段捷径查最新股价
「持仓管理」表的关键字段：
- 股票代码 / 公司名称 / 市场（A股、美股、港股）/ 所属行业；
- 持仓数量 / 持仓成本 / 买入日期 / 状态；
- 最新股价：字段捷径字段，使用「全球股票信息查询」捷径；
- 最新股价.当前价格：捷径返回的结构化结果自动展开的数字列;
- 今日汇率（关联汇率配置表）、市值(CNY)（公式：数量 × 现价 × 汇率）、盈亏比例（公式）。
字段捷径的配置只有两项：
- 股票代码或公司名称 → 引用表里的「股票代码」字段；
- 查询日期 → 引用「查询日期」字段；
- 生成范围选「整列」，并打开「获取更多信息」开关，即可一次刷新全部持仓。
查 ETF 也支持：在代码/名称一栏输入 ETF 的具体中文名称即可查询。
每天 15 点自动更新
手动点一次只能刷一次，模板里配了一条自动化流程「每日定时更新股票价格」，实现无人值守：
- 定时触发：每天 15:00（A 股收盘后），周一至周五重复；
- 修改记录：刷新「A股自选」表的股价字段；
- 修改记录（副本）：刷新「持仓管理」表。
配置入口在多维表格左侧栏的「自动化」，搭好后打开启用开关并「保存并启用」即可。此后股价、市值、盈亏比例每天自动变成最新值。
仪表盘：收益一眼看全
数据自动更新后，仪表盘就是活的：
- 市场分布图（饼图）：A 股 / 美股 / 港股持仓只数占比；
- 盈利排行榜：按盈亏比例排名的个股榜单；
- 指标卡：股票持仓总值等关键数字；
- 日历看板：按买入日期展示建仓记录。
多币种折算的处理
模板用「汇率配置表」（币种、对人民币汇率、更新时间）做统一换算源：「持仓管理」和「现金账户表」都通过关联字段引用币种，再用公式把美元、港币资产折成人民币余额（原币余额 × 当前汇率），这样总资产口径始终一致，改一处汇率全表生效。
观察池玩法
「美港股自选」表除了现价和今日涨跌%，还设计了几个实用字段：目标买入价、距离目标%（现价距目标价的百分比）、回撤幅度%、买入逻辑（文字记录当初为什么想买）、量比 / 换手率 / 量价形态。到价与否一列公式看穿，避免天天盯盘。
上手方式
在飞书「飞书 AI 最佳实践」知识库中找到「个人港美股管理」的「投资总表」模板，创建副本到自己的空间，替换成自己的持仓数据，再按上文打开定时自动化即可。