Google Sheets Argento

Scripts de Apps Script que añaden a tu Google Sheet funciones típicas para el día a día de un Argentino de bien.

🌐 Documentación y guía de uso: ferminrp.github.io/google-sheets-argento

Instalación

1. Abrí tu Google Sheet → Extensiones → Apps Script
2. Pegá el contenido de all-in-one.js (archivo único con todas las funciones)
3. Guardá y volvé a la hoja
4. Probá: =DOLAR("blue") (la primera vez Google pide autorizar el script)

Guía paso a paso, catálogo de fórmulas y fuentes de datos: sitio web.

Documentación de Funciones

Cotizaciones y tipos de cambio

• Dólar - Cotizaciones actuales del dólar
• Dólar Histórico - Cotizaciones históricas del dólar
• BCRA - Variables económicas del Banco Central

Instrumentos financieros argentinos

• Acciones - Información de acciones argentinas
• Acciones Histórico - OHLC histórico de acciones (data912)
• Bonos - Información de bonos argentinos
• Bonos Histórico - OHLC histórico de bonos (data912)
• Letras - Información de letras del tesoro
• Opciones - Información de opciones argentinas
• Obligaciones Negociables - Información de ONs
• Caución - Cálculo de cauciones tomadoras y colocadoras

Instrumentos financieros internacionales

• CEDEAR - Información de CEDEARs
• CEDEAR Histórico - OHLC histórico de CEDEARs (data912)
• USA Stocks - Información de acciones estadounidenses

Indicadores económicos

• Inflación - Índices de inflación mensual
• UVA - Valores del índice UVA
• Riesgo País - Valores del riesgo país

Criptomonedas

• Crypto - Precios de criptomonedas
• CriptoYa - Comparador de precios de criptomonedas
• Rendimientos - APY de criptomonedas en Argentina

Inversiones y plazos fijos

• Plazo Fijo - Tasas de plazos fijos
• FCI - Información de Fondos Comunes de Inversión

🔄 Actualización automática

Google Sheets recalcula las fórmulas al:

• Abrir la hoja
• Editar cualquier celda

Forzar recálculo:

• Ctrl + R (Windows) o ⌘ + R (Mac)
• Archivo → Configuración de hoja de cálculo → Cálculo → "Al cambiar" o "Cada minuto"

👏 Agradecimientos

• A Argentina Datos y su creador Enzo Notario por las APIs de inflación, UVA y cotizaciones históricas de dólares.
• A @JohnGalt_is_www por sus APIs de bonos, letras, CEDEARs y acciones argentinas y estadounidenses.
• A @http://criptoya.com/ por su API de comparación de precios de criptomonedas.
• A Banco Central de la República Argentina por su API de variables económicas.

Archivos principales

• src/dolar.js – Código fuente para cotizaciones de dólar
• src/dolar_historico.js – Código fuente para cotizaciones históricas de dólar
• src/cedear.js – Código fuente para información de CEDEARs
• src/acciones.js – Código fuente para información de acciones argentinas
• src/market_historico.js – Helpers de series históricas OHLC (data912)
• src/usa_stocks.js – Código fuente para información de acciones estadounidenses
• src/bonos.js – Código fuente para información de bonos argentinos
• src/letras.js – Código fuente para información de letras del tesoro
• src/opciones.js – Código fuente para información de opciones argentinas
• src/obligaciones.js – Código fuente para información de obligaciones negociables
• src/inflacion.js – Código fuente para índices de inflación
• src/crypto.js – Código fuente para precios de criptomonedas
• src/uva.js – Código fuente para índices UVA
• src/riesgopais.js – Código fuente para valores del riesgo país
• src/rendimientos.js – Código fuente para rendimientos de criptomonedas
• src/plazofijo.js – Código fuente para tasas de plazos fijos
• src/fci.js – Código fuente para fondos comunes de inversión
• src/criptoya.js – Código fuente para comparador de precios de criptomonedas
• src/bcra.js – Código fuente para variables del Banco Central
• src/caucion.js – Código fuente para cálculo de cauciones
• src/fecha.js – Utilidades compartidas de parseo de fechas (YYYY-MM-DD y DD/MM/YYYY)
• src/http.js – fetchJson + cache (CacheService) para todas las APIs
• src/market_panel.js – Helpers compartidos de paneles data912
• all-in-one.js – Archivo único con todas las funciones combinadas

Desarrollo

npm install
npm run build   # genera all-in-one.js + docs/api/cedears.json
npm test        # requiere haber corrido build antes

Para enriquecer data/cedears.json con metadata de Yahoo Finance (yfinance-metadata): pip install -r requirements.txt y python scripts/enrich-cedears-yfinance.py (ver doc/CEDEAR.md).

• Tests unitarios: tests/
• Siempre ejecutar npm run build después de modificar archivos en src/ (o data/cedears.json)
• API pública de CEDEARs (ratios): api/cedears.json
• Las cotizaciones live usan cache de ~60s en Apps Script para ahorrar cuota de UrlFetch
• Aliases de dólar: mep → bolsa, ccl → contadoconliqui