{"id":16632710,"url":"https://github.com/benwebber/ledger-fx-rates","last_synced_at":"2025-10-30T04:30:24.760Z","repository":{"id":62575503,"uuid":"81548813","full_name":"benwebber/ledger-fx-rates","owner":"benwebber","description":":ledger: :euro: Fetch foreign exchange rates for ledger and hledger","archived":false,"fork":false,"pushed_at":"2017-02-10T09:30:35.000Z","size":5,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T06:24:23.564Z","etag":null,"topics":["accounting","exchange","forex","fx","hledger","ledger"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benwebber.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-02-10T09:23:47.000Z","updated_at":"2024-08-28T15:14:49.000Z","dependencies_parsed_at":"2022-11-03T16:15:14.720Z","dependency_job_id":null,"html_url":"https://github.com/benwebber/ledger-fx-rates","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Fledger-fx-rates","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Fledger-fx-rates/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Fledger-fx-rates/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benwebber%2Fledger-fx-rates/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benwebber","download_url":"https://codeload.github.com/benwebber/ledger-fx-rates/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238930129,"owners_count":19554122,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["accounting","exchange","forex","fx","hledger","ledger"],"created_at":"2024-10-12T05:09:55.367Z","updated_at":"2025-10-30T04:30:24.232Z","avatar_url":"https://github.com/benwebber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ledger-fx-rates\n\nRender [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](http://www.ledger-cli.org/3.0/doc/ledger3.html#Commodities-and-Currencies).\n\n**ledger-fx-rates** output is compatible with any software that uses the ledger journal format, including [hledger](http://hledger.org/).\n\n## Install\n\n**ledger-fx-rates** requires Python 2.7 or later and only depends on the standard library.\n\nDownload the [latest release](https://github.com/benwebber/ledger-fx-rates/releases/latest) or install with pip:\n\n```\npip install ledger-fx-rates\n```\n\n## Usage\n\nOutput rates for the Euro (EUR):\n\n```\n$ ledger-fx-rates\nP 2017-02-09 AUD EUR 0.71608\nP 2017-02-09 BGN EUR 0.51130\nP 2017-02-09 BRL EUR 0.30004\nP 2017-02-09 CAD EUR 0.71347\nP 2017-02-09 CHF EUR 0.93703\nP 2017-02-09 CNY EUR 0.13622\nP 2017-02-09 CZK EUR 0.03701\nP 2017-02-09 DKK EUR 0.13450\nP 2017-02-09 GBP EUR 1.17523\nP 2017-02-09 HKD EUR 0.12055\nP 2017-02-09 HRK EUR 0.13388\nP 2017-02-09 HUF EUR 0.00324\nP 2017-02-09 IDR EUR 0.00007\nP 2017-02-09 ILS EUR 0.24952\nP 2017-02-09 INR EUR 0.01401\nP 2017-02-09 JPY EUR 0.00833\nP 2017-02-09 KRW EUR 0.00082\nP 2017-02-09 MXN EUR 0.04575\nP 2017-02-09 MYR EUR 0.21069\nP 2017-02-09 NOK EUR 0.11254\nP 2017-02-09 NZD EUR 0.67554\nP 2017-02-09 PHP EUR 0.01874\nP 2017-02-09 PLN EUR 0.23204\nP 2017-02-09 RON EUR 0.22249\nP 2017-02-09 RUB EUR 0.01591\nP 2017-02-09 SEK EUR 0.10545\nP 2017-02-09 SGD EUR 0.66116\nP 2017-02-09 THB EUR 0.02671\nP 2017-02-09 TRY EUR 0.25325\nP 2017-02-09 USD EUR 0.93528\nP 2017-02-09 ZAR EUR 0.06974\n```\n\nOutput rates for a different currency:\n\n```\n$ ledger-fx-rates CAD\nP 2017-02-09 AUD CAD 1.00365\nP 2017-02-09 BGN CAD 0.71664\nP 2017-02-09 BRL CAD 0.42053\nP 2017-02-09 CHF CAD 1.31334\nP 2017-02-09 CNY CAD 0.19092\nP 2017-02-09 CZK CAD 0.05187\nP 2017-02-09 DKK CAD 0.18852\nP 2017-02-09 EUR CAD 1.40160\nP 2017-02-09 GBP CAD 1.64720\nP 2017-02-09 HKD CAD 0.16897\nP 2017-02-09 HRK CAD 0.18764\nP 2017-02-09 HUF CAD 0.00454\nP 2017-02-09 IDR CAD 0.00010\nP 2017-02-09 ILS CAD 0.34973\nP 2017-02-09 INR CAD 0.01964\nP 2017-02-09 JPY CAD 0.01168\nP 2017-02-09 KRW CAD 0.00115\nP 2017-02-09 MXN CAD 0.06412\nP 2017-02-09 MYR CAD 0.29531\nP 2017-02-09 NOK CAD 0.15773\nP 2017-02-09 NZD CAD 0.94684\nP 2017-02-09 PHP CAD 0.02626\nP 2017-02-09 PLN CAD 0.32523\nP 2017-02-09 RON CAD 0.31185\nP 2017-02-09 RUB CAD 0.02229\nP 2017-02-09 SEK CAD 0.14779\nP 2017-02-09 SGD CAD 0.92668\nP 2017-02-09 THB CAD 0.03744\nP 2017-02-09 TRY CAD 0.35496\nP 2017-02-09 USD CAD 1.31089\nP 2017-02-09 ZAR CAD 0.09775\n```\n\n## Tips\n\n### Using `include` to organize your ledger\n\nAppend the daily rates to a separate file:\n\n```\n$ ledger-fx-rates \u003e\u003e ~/.ledger-fx-rates.dat\n```\n\nIn your main ledger file, include the file above:\n\n```\ninclude .ledger-fx-rates.dat\n```\n\n### Scheduling updates\n\nThe ECB updates these rates around 16:00 CET (15:00 UTC) on trading days.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwebber%2Fledger-fx-rates","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenwebber%2Fledger-fx-rates","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenwebber%2Fledger-fx-rates/lists"}