egutierrez
5f4f1f7508
Añade campos params y output al frontmatter YAML de las 506 funciones del registry. Cada parámetro tiene descripción semántica (qué representa, unidades, rango típico) y cada función describe qué produce su output. Permite a agentes razonar sobre cadenas de composición (ej: prices → log_return → sharpe_ratio) sin leer código.
40 lines
1.2 KiB
Markdown
40 lines
1.2 KiB
Markdown
---
|
|
name: sharpe_ratio
|
|
kind: function
|
|
lang: go
|
|
domain: finance
|
|
version: "1.0.0"
|
|
purity: pure
|
|
signature: "func SharpeRatio(returns []float64, riskFreeRate float64, periodsPerYear float64) float64"
|
|
description: "Calcula el ratio de Sharpe anualizado a partir de retornos, tasa libre de riesgo y frecuencia."
|
|
tags: [finance, sharpe, risk, ratio]
|
|
uses_functions: []
|
|
uses_types: []
|
|
returns: []
|
|
returns_optional: false
|
|
error_type: ""
|
|
imports: [math]
|
|
params:
|
|
- name: returns
|
|
desc: "slice de retornos periódicos (ej: [0.01, -0.02, 0.015, 0.008])"
|
|
- name: riskFreeRate
|
|
desc: "tasa libre de riesgo por período (ej: 0.0001 para 0.01% diario)"
|
|
- name: periodsPerYear
|
|
desc: "número de períodos por año (252 para diarios, 12 para mensuales)"
|
|
output: "ratio de Sharpe anualizado sin dimensión (ej: 1.5 = 1.5 unidades de retorno por unidad de riesgo)"
|
|
tested: false
|
|
tests: []
|
|
test_file_path: ""
|
|
file_path: "functions/finance/sharpe_ratio.go"
|
|
---
|
|
|
|
# sharpe_ratio
|
|
|
|
Calcula el ratio de Sharpe: `(mean(returns) - riskFreeRate) / stddev(returns) * sqrt(periodsPerYear)`. Usa desviacion estandar muestral.
|
|
|
|
## Ejemplo
|
|
|
|
```go
|
|
sr := finance.SharpeRatio([]float64{0.01, 0.02, -0.005, 0.015, 0.008}, 0.0001, 252)
|
|
```
|