Skip to main content

# ledger-fx-rates

Render [current foreign exchange rates](https://www.ecb.europa.eu/stats/exchange/eurofxref/html/index.en.html) from the European Central Bank as [ledger market values](www.ledger-cli.org/3.0/doc/ledger3.html#Commodities-and-Currencies).

ledger-fx-rates output is compatible with any software that uses the ledger journal format, including [hledger](http://hledger.org/).

## Install

ledger-fx-rates requires Python 2.7 or later and only depends on the standard library.

Download the [latest release](https://github.com/benwebber/ledger-fx-rates/releases/latest) or install with pip:

` pip install ledger-fx-rates `

## Usage

Output rates for the Euro (EUR):

` $ ledger-fx-rates P 2017-02-09 AUD EUR 0.71608 P 2017-02-09 BGN EUR 0.51130 P 2017-02-09 BRL EUR 0.30004 P 2017-02-09 CAD EUR 0.71347 P 2017-02-09 CHF EUR 0.93703 P 2017-02-09 CNY EUR 0.13622 P 2017-02-09 CZK EUR 0.03701 P 2017-02-09 DKK EUR 0.13450 P 2017-02-09 GBP EUR 1.17523 P 2017-02-09 HKD EUR 0.12055 P 2017-02-09 HRK EUR 0.13388 P 2017-02-09 HUF EUR 0.00324 P 2017-02-09 IDR EUR 0.00007 P 2017-02-09 ILS EUR 0.24952 P 2017-02-09 INR EUR 0.01401 P 2017-02-09 JPY EUR 0.00833 P 2017-02-09 KRW EUR 0.00082 P 2017-02-09 MXN EUR 0.04575 P 2017-02-09 MYR EUR 0.21069 P 2017-02-09 NOK EUR 0.11254 P 2017-02-09 NZD EUR 0.67554 P 2017-02-09 PHP EUR 0.01874 P 2017-02-09 PLN EUR 0.23204 P 2017-02-09 RON EUR 0.22249 P 2017-02-09 RUB EUR 0.01591 P 2017-02-09 SEK EUR 0.10545 P 2017-02-09 SGD EUR 0.66116 P 2017-02-09 THB EUR 0.02671 P 2017-02-09 TRY EUR 0.25325 P 2017-02-09 USD EUR 0.93528 P 2017-02-09 ZAR EUR 0.06974 `

Output rates for a different currency:

` $ ledger-fx-rates CAD P 2017-02-09 AUD CAD 1.00365 P 2017-02-09 BGN CAD 0.71664 P 2017-02-09 BRL CAD 0.42053 P 2017-02-09 CHF CAD 1.31334 P 2017-02-09 CNY CAD 0.19092 P 2017-02-09 CZK CAD 0.05187 P 2017-02-09 DKK CAD 0.18852 P 2017-02-09 EUR CAD 1.40160 P 2017-02-09 GBP CAD 1.64720 P 2017-02-09 HKD CAD 0.16897 P 2017-02-09 HRK CAD 0.18764 P 2017-02-09 HUF CAD 0.00454 P 2017-02-09 IDR CAD 0.00010 P 2017-02-09 ILS CAD 0.34973 P 2017-02-09 INR CAD 0.01964 P 2017-02-09 JPY CAD 0.01168 P 2017-02-09 KRW CAD 0.00115 P 2017-02-09 MXN CAD 0.06412 P 2017-02-09 MYR CAD 0.29531 P 2017-02-09 NOK CAD 0.15773 P 2017-02-09 NZD CAD 0.94684 P 2017-02-09 PHP CAD 0.02626 P 2017-02-09 PLN CAD 0.32523 P 2017-02-09 RON CAD 0.31185 P 2017-02-09 RUB CAD 0.02229 P 2017-02-09 SEK CAD 0.14779 P 2017-02-09 SGD CAD 0.92668 P 2017-02-09 THB CAD 0.03744 P 2017-02-09 TRY CAD 0.35496 P 2017-02-09 USD CAD 1.31089 P 2017-02-09 ZAR CAD 0.09775 `

## Tips

### Using include to organize your ledger

Append the daily rates to a separate file:

` $ ledger-fx-rates >> ~/.ledger-fx-rates.dat `

In your main ledger file, include the file above:

` include .ledger-fx-rates.dat `

### Scheduling updates

The ECB updates these rates around 16:00 CET (15:00 UTC) on trading days.

## License

MIT

Metadata

Release files for ledger-fx-rates 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ledger-fx-rates 1.0.0
File Size Uploaded Provenance Actions
ledger-fx-rates-1.0.0.tar.gz 4.0 kB Without provenance Details for ledger-fx-rates-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ledger-fx-rates 1.0.0
File Interpreter ABI Platform Actions
ledger_fx_rates-1.0.0-py2.py3-none-any.whl Python 3, Python 2 none any Details for ledger_fx_rates-1.0.0-py2.py3-none-any.whl

Total release size: 10.6 kB

Release files / ledger-fx-rates-1.0.0.tar.gz

Download URL ledger-fx-rates-1.0.0.tar.gz
Size 4.0 kB
Tags Source
SHA-256 checksum
How to use checksums
2bf6a8f721a3f52070ef272fb88d303aec548a6414599b9757ca9e6fa7fb9d9f
BLAKE2b-256 checksum
How to use checksums
1f1412709757df702ddecee87bec0c5d7f885936e6c741aeee3534208c43f012
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release files / ledger_fx_rates-1.0.0-py2.py3-none-any.whl

Download URL ledger_fx_rates-1.0.0-py2.py3-none-any.whl
Size 6.6 kB
Tags Python 2 Python 3
SHA-256 checksum
How to use checksums
fbaf0c996e9cbe4dba598e151345248c5945ee1b8ebc06f369a745e987a81694
BLAKE2b-256 checksum
How to use checksums
21135b095808da02fe0070b12479201efa7d6874f664df6c080cc8a44f0a563a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Security for ledger-fx-rates 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page