mirror of
https://github.com/aljazceru/plugins.git
synced 2025-12-29 19:04:21 +01:00
45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# Currencyrate plugin
|
|
|
|
This plugin provides Bitcoin currency conversion functions using various
|
|
different backends and taking the median. It caches results for an hour.
|
|
|
|
## Installation
|
|
|
|
For general plugin installation instructions see the repos main
|
|
[README.md](https://github.com/lightningd/plugins/blob/master/README.md#Installation)
|
|
|
|
## Options:
|
|
|
|
* --add-source: Add a source, of form NAME,URL,MEMBERS where URL and MEMBERS
|
|
can have `{currency}` and `{currency_lc}` to substitute for upper-case and
|
|
lower-case currency names. MEMBERS is how to deconstruct the result, for
|
|
example if the result is `{"USD": {"last_trade": 12456.79}}` then MEMBERS
|
|
would be "USD,last_trade".
|
|
* --disable-source: Disable the source with this name.
|
|
|
|
For c-lightning versions 0.9.3 and above, you can specify these
|
|
options multiple times to add or disable multiple sources.
|
|
|
|
## Commands
|
|
|
|
`currencyrate` returns the number of msats per unit from every backend, eg:
|
|
|
|
```
|
|
$ lightning-cli currencyrate USD
|
|
{
|
|
"localbitcoins": "5347227msat",
|
|
"bitstamp": "5577515msat",
|
|
"coingecko": "5579273msat",
|
|
}
|
|
```
|
|
|
|
`currencyconvert` converts the given amount and currency into msats, using the
|
|
median from the above results. eg:
|
|
|
|
```
|
|
$ lightning-cli currencyconvert 100 USD
|
|
{
|
|
"msat": "515941800msat"
|
|
}
|
|
```
|