#flex #reports #command-line-utilities #cli #interactivebrokers

bin+lib ibflex

一个用于读取 Interactive Brokers Flex 报表并与 Ledger-cli 交易进行比较的库和 CLI 工具

29 个版本 (5 个稳定版本)

1.3.0 2023 年 9 月 22 日
1.2.1 2023 年 7 月 1 日
1.2.0 2023 年 3 月 16 日
0.11.0 2023 年 2 月 21 日
0.3.1 2022 年 12 月 29 日

#55 in 金融

Download history 2/week @ 2024-03-10 78/week @ 2024-03-31

每月 80 次下载

GPL-3.0-or-later

67KB
1.5K SLoC

interactive-brokers-flex-rs

辅助处理 IB Flex 报表和 Ledger-cli 对比的工具

该包包含一个 CLI 应用程序,也是一个库,帮助处理 Interactive Brokers 的 Flex 报表。它简化了 Flex 查询的下载,并将下载的交易(分布和税务)与 Ledger 的记录进行比较,识别缺失的交易。

该包包含几个组件

  • 命令行应用程序 (CLI) ibflex,提供了 ibflex 库的所有功能
  • ibflex 库公开以下功能
    • 下载 IB Flex 查询报告
    • 解析 IB Flex 查询报告
    • 运行 Ledger-cli 获取过去 60 天内的交易
    • 将下载的 Flex 查询 .xml 报告中的现金交易与 Ledger 交易进行比较
  • as-symbols crate 提供了 IB Flex 报告和 Ledger 之间的符号映射。即报告中的符号 VHYL 在 Ledger 中对应 VHYL_AS

该项目最初是对我的 Python 脚本的重写,并打算根据需要扩展以解析 Flex 查询。

配置

要查看当前配置,请运行

ibflex cfg

如果不存在,将自动创建配置文件。

要编辑值,请使用任何文本编辑器。

符号配置

有关设置符号数据文件的说明,请参阅 as-symbols crate。目前,这需要符号映射。IB(即 VHYL)中的符号可以映射到 Ledger 中的不同符号(即 VHYL_AS)。

使用方法

下载 Flex 查询报告需要查询 ID 和令牌。可以通过几种方式提供

  1. 作为下载(Dl)方法的参数。使用参数 --queryid--token
  2. 作为环境变量

应用程序将从环境变量中读取值

  • IBFLEX_TOKEN
  • IBFLEX_QUERYID
  1. 在配置文件中:应用程序将读取当前目录中的配置文件 ibflex.toml。请参阅下面的章节。

下载

下载Flex报告所需的参数有

  • flex_query_id
  • ib_token

设置完成后,调用CLI

ifblex dl

这将在当前目录中保存报告。文件名将包含今天的日期。

比较

要比较交易,请运行

ibflex cmp

这将比较下载的IB交易与Ledger中的交易。新的股息和税收交易将被报告为“新”。其他交易将被报告为“跳过”。

变更日志

请参阅变更日志

致谢

许可

请参阅LICENSE文件。

依赖项

~13–27MB
~402K SLoC