---
name: log_return
kind: function
lang: py
domain: finance
version: "1.0.0"
purity: pure
signature: "def log_return(price_start: float, price_end: float) -> float"
description: "Calcula el retorno logaritmico entre dos precios."
tags: [finance, return, logarithmic, python]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: ""
imports: [math]
params:
  - name: price_start
    desc: "precio inicial (ej: 100.0). Debe ser > 0."
  - name: price_end
    desc: "precio final (ej: 110.0). Debe ser > 0."
output: "retorno logaritmico en forma decimal (ej: 0.0953 para aprox +9.53%). Aditivo en el tiempo."
tested: false
tests: []
test_file_path: ""
file_path: "python/functions/finance/finance.py"
---

## Ejemplo

```python
r = log_return(100.0, 110.0)
# 0.09531... (aprox 9.53%)
```

## Notas

Formula: ln(price_end / price_start).
Retorna 0.0 si alguno de los precios es menor o igual a cero.
Los retornos logaritmicos son aditivos en el tiempo, a diferencia de los retornos simples.
