Google Sheets Argento

Qué hace

Un script de Apps Script que agrega funciones personalizadas a tu Google Sheet. Escribís una fórmula y la celda se llena con datos financieros de Argentina.

Cómo instalarlo

No hace falta Node, clasp ni extensiones de Chrome. Solo copiar un archivo en Apps Script.

1. Abrí tu Google Sheet

   Creá una planilla nueva o usá una existente donde quieras las fórmulas.

2. Entrá a Apps Script

   Menú Extensiones → Apps Script. Se abre el editor de Google.

3. Pegá el código completo

   Borrá el contenido por defecto del editor y pegá el archivo all-in-one.js del repositorio (incluye todas las funciones).

   Abrir all-in-one.js (raw) Ver en GitHub

4. Guardá el proyecto

   Ctrl+S o ⌘+S. Podés renombrar el proyecto a “Sheets Argento” si querés.

5. Volvé a la hoja y probá

   La primera vez que uses una fórmula, Google pedirá autorizar el script (acceso a servicios externos). Aceptá y listo.

   =DOLAR("blue")

Cómo usarlo

Escribí las fórmulas en cualquier celda, igual que =SUMA(). Algunas funciones devuelven un número; otras, tablas completas.

Cuándo se actualizan los datos

Google Sheets recalcula al abrir la hoja o al editar celdas. Podés forzar con Ctrl+R (Windows) o ⌘+R (Mac), o en Archivo → Configuración → Cálculo. Las cotizaciones live usan cache de ~60 s en Apps Script para no saturar las APIs.

Catálogo de funciones

Cada ítem enlaza a la documentación detallada en el repositorio (parámetros, errores y más ejemplos).

API / datos abiertos

Miscelánea de la página: JSON estático servido por GitHub Pages. Pensado para agentes, scripts y quien no quiera pelearse con el PDF de BYMA.

Endpoint

https://ferminrp.github.io/google-sheets-argento/api/cedears.json

Forma de la respuesta

{
  "schema_version": 1,
  "name": "cedears",
  "count": 428,
  "fields": {
    "Cedears": "Ticker del CEDEAR en BYMA",
    "Name": "Nombre de la empresa / instrumento subyacente",
    "Market": "Mercado del subyacente (ej. NYSE, NASDAQ, B3)",
    "Ratio": "String de conversión…",
    "TickerOriginal": "Ticker del subyacente en su mercado de origen"
  },
  "items": [
    { "Cedears": "AAPL", "Name": "Apple Inc.", "Market": "NASDAQ", "Ratio": "20", "TickerOriginal": "AAPL" },
    { "Cedears": "ADGO", "Name": "Adecoagro S.A.", "Market": "NYSE", "Ratio": "1", "TickerOriginal": "AGRO" }
  ]
}

Ejemplos

# curl
curl -s https://ferminrp.github.io/google-sheets-argento/api/cedears.json | jq '.items[] | select(.Cedears=="AAPL")'

# JavaScript
const res = await fetch('https://ferminrp.github.io/google-sheets-argento/api/cedears.json');
const { items } = await res.json();
const aapl = items.find((c) => c.Cedears === 'AAPL');

Es un snapshot versionado en el repo, no una API de cotizaciones en vivo. Los precios siguen viniendo de data912 vía las fórmulas de Sheets. CORS: GET público (ideal para fetch desde scripts y agentes).

Fuentes de datos

El proyecto no aloja cotizaciones propias: consulta APIs públicas y open data mantenidas por la comunidad y organismos.

Las cotizaciones dependen de terceros y pueden retrasarse o fallar si la API de origen no responde. Esto no es consejo financiero. Verificá siempre con tu broker o fuente oficial antes de operar.

Preguntas frecuentes

Cosas que suelen aparecer al instalar o usar las fórmulas.