2个稳定版本

1.1.0	2022年1月30日
1.0.0	2022年1月9日

#195 in 金融

MIT/Apache

17KB
178 行

hledger-get-market-prices

您可以使用此项目从Alpha Vantage API获取历史股价和基金价格，并将它们转换为hledger市场价格格式。这有助于跟踪您投资组合的当前价值。

如何安装

$ cargo install hledger-get-market-prices

如何使用

假设您想了解ISIN为IE00BJ0KDQ92的基金在XETRA上的交易情况。在hledger中，您调用此基金的品种为MSCIWRLD。在XETRA上以欧元进行MSCIWRLD的交易，hledger将此货币识别为商品€。

获取Alpha Vantage API密钥

首先，您需要一个Alpha Vantage API密钥。您可以在这里免费获取密钥。

hledger-get-market-prices期望在环境变量HLEDGER_GET_MARKET_PRICES_API_KEY中找到此密钥，因此您可以将此变量添加到所有应用程序的环境变量中（例如，如果您使用Bash，则可以在~/.bashrc中添加此变量）或者始终在调用hledger-get-market-prices时添加密钥（例如，HLEDGER_GET_MARKET_PRICES_API_KEY=<key> hledger get-market-prices ...）。

找出正确的符号

接下来，您需要找出基金的符号。理论上，您可以通过hledger get-market-prices search-stock-symbol进行搜索，但Alpha Vantage的搜索API有点复杂。您可以尝试通过ISIN进行搜索

$ hledger get-market-prices search-stock-symbol IE00BJ0KDQ92

目前，这没有返回任何结果。搜索基金名称（"Xtrackers MSCI World UCITS ETF 1C"）也没有结果。但是，您可以搜索XETRA使用的股票代码。正如您可以看到这里，XETRA使用的股票代码是XDWD。搜索XDWD会得到多个结果

$ hledger get-market-prices search-stock-symbol XDWD

              Region |    Symbol – Name                

           Frankfurt |  XDWD.FRK – Xtrackers (IE) Public Limited Company - Xtrackers MSCI World UCITS ETF
      United Kingdom |  XDWD.LON – Xtrackers (IE) Plc - Xtrackers MSCI World UCITS ETF 1C
               XETRA |  XDWD.DEX – Xtrackers (IE) Plc - Xtrackers MSCI World UCITS ETF 1C

您感兴趣的是XETRA的结果，因此XDWD.DEX是正确的符号。

获取历史数据

现在，您可以使用此符号请求历史数据

hledger get-market-prices history XDWD.DEX MSCIWRLD €

; Generated by hledger-get-market-prices V1.0.0
P 2022-01-07 MSCIWRLD 84.838 €
P 2022-01-06 MSCIWRLD 85.4 €
P 2022-01-05 MSCIWRLD 86.752 €
P 2022-01-04 MSCIWRLD 86.752 €
P 2022-01-03 MSCIWRLD 86.594 €
P 2021-12-30 MSCIWRLD 86.706 €
...

常见问题解答