UniRate Currency
unirate-api1 downloadsInline live and historical currency exchange rates. Type `usd:eur` in a note to see the rate; type `usd:eur:100` to convert. 170+ currencies and crypto via UniRateAPI.
- Overview
- Scorecard
- Updates1
Inline live and historical currency exchange rates in your notes.
Type `usd:eur` and the plugin renders the current USD→EUR rate where the inline code used to be. Type `usd:eur:100` and it renders the converted amount. 170+ currencies plus the major cryptocurrencies, with daily history back to 1999 (Pro plan).
Powered by UniRateAPI.
Why
Existing Obsidian finance plugins are either crypto-only (obsidian-crypto-lookup) or general-purpose calculators that happen to handle currency (obsidian-numerals). Neither gives you inline, in-line live rates in normal prose. A 2022 forum thread asking for one is still open.
Install
Until the plugin is approved on the community plugins list, install manually:
- Download
main.js,manifest.json, andstyles.cssfrom the latest release. - Drop them into
<your vault>/.obsidian/plugins/unirate-currency/. - Reload Obsidian and enable UniRate Currency under Settings → Community plugins.
- Open the UniRate Currency tab and paste your API key (get a free key).
Syntax
All forms go inside a single inline code span (`…`):
| You write | Renders as |
|---|---|
`usd:eur` |
0.9234 EUR/USD |
`usd:eur:100` |
92.34 EUR |
`100 usd:eur` |
92.34 EUR |
`gbp>jpy` |
198.42 JPY/GBP |
`usd→eur` |
0.9234 EUR/USD |
- Currency codes can be 3-5 characters, case-insensitive (
USDT,BTC,XAU). - Decimal places, thousand-grouping, and the appended currency code are all configurable.
- Rates are cached in memory for 60 minutes by default to avoid hammering the API.
Commands
- Insert exchange rate — opens a modal to pick from/to/amount/date and inserts the result at the cursor.
- Convert selection — select something like
100 USD to EUR(or100 usd:eur) and run the command to replace the selection with the converted value. - Clear rate cache — drop the in-memory cache; the next render will re-fetch.
Pricing
UniRateAPI's free tier covers live rates and supports 170+ currencies. Historical rates and commodities (XAU, XAG, XPT, XPD) require a Pro plan.
Disclosure
This plugin is built and maintained by UniRateAPI. If you'd rather use a different rate source, the inline syntax is generic enough that another plugin could implement it the same way — open an issue if you'd find that useful.
Development
npm install
npm run dev # esbuild watch
npm run build # tsc + esbuild production
npm test # jest unit tests
The plugin uses Obsidian's requestUrl API so it works on both desktop and mobile without CORS workarounds.
License
MIT. See LICENSE.