跳转到主要内容

Beancount 实时价格

你的账簿。今日价格。

你已记录你所拥有的。用一行纯文本保持其价值最新。Beancount.io 负责价格更新。

适用于托管 Beancount.io 账本中支持的价格源。

选择你的价格源

你持有哪些资产?

正在加载价格源目录…

已有账本?自动识别持仓

账本内容仅在浏览器中解析,不会上传。

添加到你的账本
; 在上方选择资产,生成 include 配置。

粘贴到账本会加载的文件中,资产代码须与账本一致。

一行连接
刷新时不产生提交
你的价格优先

你的下一份报告不应从价格更新开始。

一笔购买记录一个瞬间。市场价格不断变动。如果你用纯文本跟踪投资,维护报价脚本和价格文件可能变成第二份工作。托管价格 include 处理这种重复工作。

连接一次。像往常一样打开你的账簿。

  1. 添加价格源

    选择估值币种和你持有的资产,将生成的 include 配置粘贴到账本会加载的文件中。资产代码须与账本一致。

  2. 让价格刷新

    当你打开账簿时,Beancount.io 会在五分钟刷新窗口过后检查新价格。

  3. 读取你的估值

    价格可供你的报告使用。你的购买、销售、数量和记录成本仍然属于你。

标准 Beancount 价格条目
; BTC-USD

2026-09-17 price BTC 92000.00 USD

2026-09-18 price BTC 94000.00 USD
示例源摘录。金额和观察时间仅为示例。

市场价格变动。你的记录保持为你所有。

你自己的价格优先

需要时使用你报表中的价格。对于相同日期和货币对,你写入的价格优先,无论文件包含的顺序如何。

保持干净的历史

刷新价格不会重写你的账本或创建 Git 提交。你的历史保持专注于你所做的更改。

刷新失败保留最后的好价格

当源不可用时,仍可使用先前验证的缓存价格。它可能已过时;缓存价格不是新的市场观察。

价格历史为你的账簿留出空间

托管价格条目不计入你账本的条目限制。

从你可以检查的源开始。

每个价格源都是可读的 Beancount 文本,包含带日期的价格和来源信息。在上方选择估值币种,即可查看目录已收录的持仓报价。

探索投资跟踪

价格源示例

比特币 / 美元BTC-USD

目录涵盖加密货币、股票、基金和外币。不同配对的支持情况有所不同,选择器会显示当前估值币种下已收录的价格源。

选择你的价格源

URL include 是 Beancount.io 的扩展。上游 Beancount 和 Fava 需要本地价格文件。

一些值得了解的事情。

阅读 bea CLI 指南
这些是实时交易价格吗?

这些是自动刷新的估值价格。托管加载器在你的账本加载五分钟刷新窗口过后检查新数据。提供者的观察时间可能更早。这不是流式交易源。

刷新会改变我的成本基础或交易吗?

不会。托管源仅提供价格指令。价格影响市场估值;它们不会改变你账本中记录的数量、购买成本、现金流、费用或已实现收益。

我可以使用自己的价格吗?

可以。对于相同日期和商品对(包括反向对),你自己的价格优先,无论包含顺序如何。稍后日期的托管价格仍可使用。

如果价格源离线会发生什么?

失败的刷新不会用空的替换已验证的缓存源。缓存价格可能已过时。如果没有可用的已验证价格,你的账簿仍会加载,但该持仓可能缺少市场估值。

URL include 在上游 Beancount 或 Fava 中有效吗?

上游 Beancount 和 Fava 不会自行获取 URL include。在托管 Beancount.io 账本中使用此设置。兼容的 bea CLI 版本也会解析托管 include,并可导出本地价格文件供离线工具使用;请参阅 CLI 指南。

我可以连接哪些资产?

选择估值币种,再点选快捷项或搜索资产代码。选择器会根据当前目录,为已收录的配对生成 include 配置。目录外的配对可能仍支持按需推导,但在支持情况确认前,不会进入复制的配置。资产代码须与你的账本一致。

保持你的账簿。摆脱价格更新琐事。

向你的托管账本添加一个支持的价格 include,让你的下一次估值以更新的数据开始。