> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finzaria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-divisa

> Moneda por cuenta, moneda base para reportes y traspasos con tipo de cambio.

Finzaria maneja **varias monedas**: cada cuenta tiene su propia `currency`, y el workspace define una
**moneda base** para consolidar reportes y patrimonio.

## Moneda base

`GET /v1/workspace` incluye `baseCurrency`. Los totales consolidados (patrimonio, reportes) se
expresan en esa moneda; cambiarla con `PATCH /v1/workspace` **re-etiqueta** los consolidados sin tocar
los datos originales de cada cuenta.

## Tipo de cambio

`GET /v1/exchange-rates/latest?quote=USD&base=MXN` devuelve la tasa del día (fuente: Frankfurter),
útil para prellenar traspasos entre divisas.

## Traspasos entre monedas

Un `transfer` entre cuentas de distinta moneda lleva:

* `exchangeRate` — cuánto vale 1 unidad de la moneda origen en la moneda destino, **o**
* `toAmount` — el monto exacto que llegó a la cuenta destino (en su moneda).

```json theme={null}
{
  "type": "transfer",
  "amount": "100.00",
  "date": "2026-07-14",
  "fromAccountId": "cuenta_usd",
  "toAccountId": "cuenta_mxn",
  "exchangeRate": "17.50"
}
```

## Consolidación

`GET /v1/net-worth` y los reportes convierten todo a la moneda base con las tasas del día. Cuando hay
mezcla de monedas, los totales se marcan como **aproximados** (`estimated`) e incluyen la fecha de las
tasas usadas.