Skip to main content

Bean Price Support

Overview

Our plugin supports bean-price, a tool that fetches market data prices from various sources on the internet and renders them in plain text accounting price syntax.

This feature allows you to keep your Beancount ledger updated with the latest market values for commodities, currencies, and cryptocurrencies.

Configuration

To fetch the latest prices for your commodities, you need to ensure that they have the appropriate price metadata attached to their Beancount directive.

The syntax for the price metadata is generally <CURRENCY>:<module>/<ticker>.

Example:

2000-01-01 commodity AAPL
price: "USD:yahoo/AAPL"

Supported Standard Sources

The plugin supports all the standard price sources provided by bean-price. Below is a list of the available modules and what they provide:

NameModuleProvides prices forBase currencyLatest priceHistorical price
Alphavantagebeanprice.alphavantageStocks, FX, CryptoMany currencies
Coinbasebeanprice.coinbaseMost common (crypto)currenciesMany currencies
Coincapbeanprice.coincapMost common (crypto)currenciesUSD
Coinmarketcapbeanprice.coinmarketcapMost common (crypto)currenciesMany Currencies
European Central Bank APIbeanprice.ecbratesMany currenciesMany currencies (Derived from EUR rates)
OANDAbeanprice.oandaMany currenciesMany currencies
Quandlbeanprice.quandlVarious datasetsVarious datasets
Rates APIbeanprice.ratesapiMany currenciesMany currencies
Thrift Savings Planbeanprice.tspTSP FundsUSD
Yahoobeanprice.yahooMany currenciesMany currencies
EastMoneyFund(天天基金)beanprice.eastmoneyfundChinese FundsCNY