Obsidian Stats logoObsidian Stats

UniRate Currency

by unirate-api
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Inline 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.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

UniRate Currency for Obsidian

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:

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Drop them into <your vault>/.obsidian/plugins/unirate-currency/.
  3. Reload Obsidian and enable UniRate Currency under Settings → Community plugins.
  4. 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 (or 100 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.

Sponsors