---
title: "convert currency · RUAL Documentation"
description: "Convert an amount between currencies using ECB daily reference rates."
canonical: https://docs.rual.nl/block-types/finance/currency_convert
language: en
---

# convert currency

This block is part of the [`finance`](https://docs.rual.nl/block-types/finance) group and was last modified in core [`v15.0.0`](https://docs.rual.nl/core-versions/150000).

Convert an amount between currencies using ECB daily reference rates.

- flow `flow`

- amount required `number` The amount to convert.

- from required `value` Source currency code (e.g. USD).

- to required `value` Target currency code (e.g. EUR).

- flow `flow`

- success `condition`

- result `number` The converted amount.

- rate `number` The applied exchange rate (to per from).

- last update `date` When ECB last published these rates.

- error `value`

| `exchange` |
| --- |
| `fx` |
| `convert money` |
| `currency conversion` |

A typical wiring for [convert currency](https://docs.rual.nl/block-types/finance/currency_convert): a [function trigger](https://docs.rual.nl/block-types/globals/trigger_custom_function) starts the flow; [number](https://docs.rual.nl/block-types/number/number_default) feeds the `amount` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `from` pin; [value](https://docs.rual.nl/block-types/value/value_default) feeds the `to` pin; the `flow` out pin feeds [debug](https://docs.rual.nl/block-types/state%20ui/state_debug).

![Studio canvas example for the convert currency block: typical wiring for convert currency.](https://docs.rual.nl/canvas-examples/currency_convert.png)

### Version history

Introduced in [`v15.0.0`](https://docs.rual.nl/core-versions/150000).