Skip to main content
Version: In-Progress

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✓✓