listcurrencyrates

currencyrates -- Command to list millisatoshis-per-unit from each configured source

SYNOPSIS

currencyrates currency

DESCRIPTION

Command added in v26.04.

The listcurrencyrates RPC command returns the number of units of a given currency for one BTC from each configured exchange-rate source.

  • currency (string): The ISO4217 currency code to query, eg USD.
    The plugin normalizes this value to uppercase before querying sources.

RETURN VALUE

On success, an object containing currencyrates is returned. It is an array of objects, where each object contains:

  • source (string): The name of the source of this rate (see currencyrate-add-source in lightningd-config)
  • amount (number): The amount of currency for 1 BTC.

AUTHOR

daywalker90 is mainly responsible.

SEE ALSO

lightning-currencyconvert(7)

RESOURCES

Main web site: https://github.com/ElementsProject/lightning

Core Lightning is Blockstream's open-source implementation of the Lightning Network optimised for performance. It is highly customizable through modular expandability.

© 2026 Core Lightning, a Blockstream project.
All rights reserved.

X Twitter Logo Streamline Icon: https://streamlinehq.com

X

The official Core Lightning X(Twitter) handle to follow project updates and announcements.

Github Logo 2 Streamline Icon: https://streamlinehq.com

Github

Github repository for source code, issues, and contributions. Visit our project here to explore or contibute.

Telegram

Community-driven telegram group where most of the node operators hang out. Go to https://t.me/lightningd to join.

Discord

Community-driven discord server where the devs flock together. Go to https://discord.gg/V6ay9yNhBQ to join.