Texto del repositorio público, commit 8729248. Fuente: docs/claude/market-data.md.
Market data: proxies, funciones y defensas contra el 429
Detalle movido desde
CLAUDE.mdel 2026-10-04 para que el fichero que se carga en cada sesión solo lleve el índice y las reglas críticas. Léelo antes de tocar esta zona.
API proxies — dev vs producción
Todas las llamadas a APIs externas de mercado van por rutas /api/* para evitar CORS. Hay DOS implementaciones que deben mantenerse en espejo:
- Dev: proxies del dev server en
vite.config.js+ plugins (plugins/yahoo-crumb-proxy.jspara/api/yahoo-profile,plugins/secure-api-proxy.jspara/api/eodhd-secure). - Producción (Vercel): funciones serverless en
api/+ rewrites envercel.json:yahoo,yahoo2,eodhd,eodhd-secure,nasdaq,frankfurter(FX — sin ella toda conversión caía a rate 1),yahoo-profile(crumb dance portado; beta/sectores/topHoldings funcionan en prod desde 2026-07-17).
- Producción self-hosted (la real): el server Express sirve TAMBIÉN los proxies de market data (
server/routes/marketProxy.js, registrado en index.js con rate-limit 300/min/IP) — espejo 1:1 de los proxies/plugins de dev, incluido el crumb dance de yahoo-profile y el eodhd-secure (key por JWT oEODHD_PLATFORM_KEY). El reverse proxy (nginx) solo necesita:/api/*,/contact,/webhooks,/share-data,/share-performance→ Express, y el resto → estáticos dedist/.
⚠️ app.set('trust proxy', …) es lo que hace que los rate-limiters sean POR IP (2026-09-11). Detrás de nginx toda petición llega desde 127.0.0.1, así que sin ese ajuste req.ip era el mismo para todo el mundo y el límite de market data (300/min) funcionaba como un cubo GLOBAL compartido por todos los usuarios, sus pestañas y el cron — una carga de Dashboard con 25 posiciones ya son ~60-80 peticiones. Cada 429 que eso provocaba dejaba un activo SIN histórico, y un activo sin histórico vale 0 en toda la serie de rendimiento. El valor es el número de proxies de confianza (TRUST_PROXY_HOPS, por defecto 1 = solo nginx), nunca true: con true cualquiera falsifica X-Forwarded-For y se salta el límite. Si se añade Cloudflare u otro balanceador, sube el contador.
Al añadir un proxy nuevo: añadirlo en los TRES lados — vite.config (dev), server/routes/marketProxy.js (producción self-hosted) y api/ + rewrite (solo si se despliega en Vercel).
Market data — which function to use
| Use case | Function | API calls |
|---|---|---|
| List view, watchlists, price refresh | getQuote(ticker) | 1 |
| Full overlay with news + fundamentals | getEnrichedData(ticker) | 3 |
| Historical chart data | getHistoricalData(ticker, range) | 1 |
getProfile()returns emptyname: ""— name always comes fromgetQuote()→companyName- Metric labels from
getEnrichedDataare:'52W HIGH','52W LOW','MARKET CAP'— use these exact strings when matching - Pence-quoted tickers are divided by 100 → GBP only when Yahoo reports currency
GBp/GBX(isPenceCurrencyinyahooFinance.js). NEVER infer pence from the.Lsuffix: LSE ETFs like SMH.L/VUAA.L are USD-denominated (the suffix check turned $111.20 into £1.11).inferTickerCurrency(ticker, assetCurrency)disambiguates.Lwith the DB asset currency. - MIC-suffixed tickers (ISO 10383 exchange codes, e.g.
AMZ.XGAT= Amazon on Tradegate) are translated to Yahoo suffixes byresolveTicker(MIC_TO_YAHOO_SUFFIXintickerMap.js): Tradegate/Gettex →.DE(Xetra proxy — Yahoo has no feed for them),XMAD→.MC,XNAS/XNYS→ bare symbol, etc. Only KNOWN 4-char MICs are translated; unknown suffixes pass through. Yahoo's own suffixes are ≤2 chars so no collision is possible. Any "asset never loads a price" report → first check the stored ticker survivesresolveTicker→getQuote(tests:tickerMap.resolve.test.js). - Las fechas de las series históricas salen de
barDateFromTimestamp(ts, meta.gmtoffset), NUNCA denew Date(ts*1000).toISOString(): Yahoo estampa las barras1wk/1moa la MEDIANOCHE LOCAL del inicio del periodo, así que leídas en UTC toda serie europea se va un día atrás (la semana del lunes 28-jul de^IBEXllega como2025-07-27T22:00Z, la de^GSPCcomo2025-07-28T04:00Z; la barra de abril de VUAA.L como03-31T23:00Z). Mezclar una serie europea con una americana dejaba la intersección de fechas VACÍA: el simulador histórico no pintaba NADA con ^IBEX + ^GSPC en ningún rango semanal/mensual (medido: 1 fecha común de 263 antes, 263 después). Las barras diarias no se mueven — van estampadas a la apertura, a horas de la medianoche local. Tests:yahooFinance.barDate.test.js. - In-memory cache: 1 min for quotes, 60 min for historical data
- ⚠️ NUNCA un
Promise.allsobre los tickers de una cartera: va porrunPooled(src/lib/asyncPool.js, pool de 4 +withRetry). Yahoo estrangula las RÁFAGAS, y cada 429 que provoca deja un activo sin precio o sin histórico — y un activo sin histórico vale CERO en toda la serie, así que el síntoma no es un hueco, es un porcentaje equivocado enseñado como bueno. La defensa vivía PRIVADA dentro deusePortfolioPerformance, de modo que la serie de rendimiento estaba protegida y el resto del Dashboard no: el treemap (Wallet Map), "Invertido" y el enriquecido de sectores seguían disparando a ráfaga sobre TODOS los tickers a la vez (Dashboard.jsx, dos sitios). Ahora hay UNA definición y la comparten las tres superficies. Vale igual para EODHD (1000/min): el patrón de ráfaga no se arregla cambiando de proveedor. Tests:asyncPool.test.js(fija que la concurrencia nunca supera N y que el orden de los resultados se conserva, para que sea sustituible por unPromise.allsin tocar al llamante). - ⚠️ Antes de reducir la frescura de un dato, elimina la petición DESPERDICIADA. Auditoría de consola del 2026-09-12: una sola carga del Dashboard gastaba ~25 peticiones que no podían funcionar NUNCA, y cada una acercaba el 429 que sí tumba a un activo real. Cuatro clases, cuatro defensas, ninguna toca la frescura de Wallet Map ni del seguimiento de cartera: (a) símbolos incotizables — se pedía histórico de
CASH_EUR/CASH_USD/CASH_CAD/CASH_GBP(¡liquidez!), deInterés(una descripción de comisión de DeGiro que acabó de "ticker") y deNLFLATEXACNT(el identificador de cuenta de flatex); lo cubrelib/tickerGuard.jscon DOS capas, una heurística pura (isQuotableTicker: liquidez, espacios, acentos, charset) y una caché negativa — un 404 de Yahoo es información PERMANENTE y se recuerda 7 días, que es lo único que caza lo que ninguna heurística adivina. Un 429 NUNCA se marca: es transitorio y confundirlos dejaría un activo real sin precio una semana. (b) Reintento de lo permanente: un 404 se reintentaba, duplicando el gasto; ahora el error va tipado (err.status) y el 404 ni reintenta ni ensucia la consola. (c) Peticiones duplicadas simultáneas: el calendario de resultados y su monitor piden los MISMOS tickers a la vez (se veían AMZN/GOOGL/META/MSFT/CSU.TO dos veces); lo resuelvelib/inflight.js(coalesce), que NO es caché —la entrada muere al asentarse la promesa, así que no congela nada—. (d) Cortacircuitos de EODHD: sin API key el calendario responde 403 y el código reseteaba la promesa en cada fallo, así que reintentaba por CADA ticker (doce 403 idénticos en una carga); un 403 ahí es CONFIGURACIÓN, no un fallo transitorio, y se aprende una vez por sesión. Las ráfagas restantes (EarningsCalendar) pasaron arunPooled; el 2026-10-04 tambiénDividendCalendar,PortfolioNewsWidget, las betas de CarteraPage y las cotizaciones de FavoritesPage (runPooledSettledpara los que necesitan la forma deallSettled). Ese día se BORRÓ la descarga del histórico 1y/1mo de cada ticker y divisa que hacía el Dashboard: se guardaba en un estado que no leía nadie. Tests:tickerGuard.test.js,inflight.test.js. - Los calendarios de Nasdaq los monta el SERVER, no el navegador (2026-10-04). Antes cada carga del Dashboard pedía un día cada vez desde el navegador: ~86 peticiones de dividendos y ~43 de resultados, por usuario, con los mismos datos para todo el mundo. Ahora
GET /api/market-calendar/:kind(dividends|earnings,server/routes/marketCalendar.js) los monta una vez confetchDividendRows/fetchEarningsRows(server/lib/marketCalendar.js, las mismas que usan el cron y el informe semanal) y los guarda 6 h en memoria; el cliente hace UNA petición por calendario (lib/serverCalendar.js) y solo si falla cae al día a día por/api/nasdaq. Reglas de la caché (createCalendarStore, testeada): peticiones simultáneas comparten una construcción; un calendario VACÍO no se guarda —medido: tras dos pasadas seguidas Nasdaq devolvió 0 dividendos, estrangulando— sino que responde 503 y recuerda el fallo 5 min; si una renovación falla se sirven los datos anteriores. La respuesta va comprimida desde el propio Express porque nginx no comprime JSON (gzip_typesestá comentado en elnginx.confcomún a todas las webs): resultados = 739 KB planos frente a 71 KB con gzip. Las ventanas (30/90 días dividendos, 14/45 resultados) son las del cliente: si cambian enbuildCalendarde un servicio, cámbialas también en el server.
Fondos: el NAV de Yahoo llega con 1-2 días de retraso (2026-10-15)
Comparado con MyInvestor el 15-oct-2026: el coste cuadraba al céntimo en 8 de 9 fondos y el valor no, porque el último NAV de Yahoo era del 13 y el broker ya tenía uno posterior (+7,61 € sobre 1.748 €, con diferencias de los dos signos). No es un fallo de cálculo. getQuote devuelve type (instrumentType) y marketTime; stalePriceDate (services/quotePricing, con tests) da la fecha cuando un FONDO tiene NAV de un día anterior y usePositions la deja en _priceDate: la tabla rotula "VL 13 oct" con la explicación al pasar el ratón. Las acciones no se rotulan (cotizan en vivo). EODHD (con clave) suele tener NAVs más al día.
usePositions.refreshPrices cotiza por runPooledSettled (era un Promise.allSettled sobre toda la cartera). La ficha del activo desde brokers abre el MISMO símbolo que valora la tabla (resolveQuoteSymbol en openAssetOverlay; antes miraba solo el mapa del import).