backtest_portfolio
ChatGPTSimula (backtesting) la cartera personalizada de un cliente a partir de su composición: una lista de posiciones (fondos, ETFs y/o acciones) con su ref y su peso en %. Devuelve la evolución de la rentabilidad acumulada (con pestañas de periodo), la rentabilidad histórica por año y por mes, la composición actual (clase de activo y geografía), las métricas de riesgo (volatilidad, máxima caída, Sharpe) y la lista de posiciones con su peso. Modelo: PESOS CONSTANTES (rebalanceo) — el cliente mantiene la asignación objetivo en el tiempo. Las rentabilidades reflejan el valor liquidativo / precio (neto del TER del fondo o ETF) y NO incluyen comisiones de cartera ni de custodia. El periodo simulado se limita al histórico común de los instrumentos (máximo 5 años, acotado por el más joven). Las carteras multidivisa se convierten a EUR con tipos de cambio históricos. Cada ref es el ISIN exacto de un fondo, o el TICKER (con sufijo de mercado, p.ej. 'SXR8.DE') / ISIN de un ETF o acción. Si el usuario nombra las posiciones por texto, resuélvelas antes con resolve_funds (fondos) o search_etfs / search_stocks (instrumentos) y pasa los identificadores confirmados — la herramienta NO adivina por nombre: un ref que no reconozca hace fallar toda la simulación. Si un instrumento no tiene histórico de precios se excluye y se renormalizan los pesos; si la parte simulable no supera el 90% del peso, devuelve un error pidiendo sustituir los que no tienen datos.
compare_instruments
ChatGPTCompara entre 2 y 3 productos de inversión lado a lado: fondos, ETFs y/o acciones, del mismo tipo o mezclados. El gráfico muestra la rentabilidad por período (YTD/1A/3A/5A); las filas comunes añaden volatilidad, TER, composición por clase de activo y geografía por bloques. Cuando todos los productos son del mismo tipo se muestran además sus métricas específicas (fondo: SRRI, años naturales, sectores; ETF: patrimonio, sectores; acción: PER, rentabilidad por dividendo, capitalización). Incluye botón para contratar cada uno en MyInvestor. Acepta SOLO identificadores exactos: ISIN de fondo, o ticker con sufijo de mercado ('SXR8.DE') / ISIN de ETF o acción. NO resuelve nombres — si el usuario los nombra por texto, resuélvelos antes con resolve_funds, search_etfs o search_stocks y pasa aquí los identificadores exactos. No es para las carteras automatizadas (usa compare_portfolios).
compare_portfolios
ChatGPTCompara 2-3 productos donde al menos uno es una cartera automatizada: carteras entre sí, o una cartera mezclada con fondos/ETFs/acciones (por ISIN de fondo o ticker). Vista sin curva: rentabilidad por año, composición, coste. Para comparar solo fondos/ETFs/acciones usa compare_instruments.
get_funds
ChatGPTHerramienta INTERNA de consulta: obtén la ficha COMPLETA de uno o varios fondos por su ISIN exacto (TER, rentabilidades por período y por año natural, volatilidad, riesgo SRRI, rating Morningstar, asset allocation, top regiones/sectores, AUM, NAV). NO muestra ninguna vista al usuario — sirve para que analices los fondos antes de responder. Úsala cuando ya tienes los ISIN (p.ej. tras resolve_funds, o tras la selección del usuario en el selector) y necesitas examinar las fichas para razonar sobre solapamientos, exposición geográfica o costes ANTES de hacer una recomendación. Es el camino correcto para 'déjame ver las fichas completas': NO uses search_funds por nombre para esto — re-buscar por nombre pinta un carrusel innecesario y puede devolver el fondo equivocado. Si quieres mostrar al usuario una comparativa visual de 2-3 productos, usa compare_instruments (esa sí pinta vista). get_funds es solo para tu análisis interno.
get_instruments
ChatGPTHerramienta INTERNA: obtén la ficha COMPLETA de uno o varios ETFs/acciones por su TICKER exacto. NO muestra vista al usuario — sirve para analizar antes de responder. Para mostrar comparativas visuales usa compare_instruments (fondos, ETFs y/o acciones).
list_facets
ChatGPTDevuelve los valores que existen DE VERDAD en el catálogo MyInvestor por dimensión, con cuántos fondos hay en cada uno (recuentos EXACTOS, en una sola llamada). No muestra ninguna vista al usuario — es para tu análisis. Dimensiones: asset_class, category, geographic_zone, product_type, management_company (gestora), currency, sector, region. Úsala PRIMERO, antes que search_funds, en estos casos: (1) preguntas de CONTEO o catálogo ('¿cuántos fondos indexados hay?', '¿cuántas gestoras?') — responde con esta herramienta, NO infieras el total desde un search_funds con tope 10; (2) DESCUBRIMIENTO ('¿qué gestoras hay?', '¿qué categorías de renta fija existen?'); (3) FUNDAMENTAR un filtro — antes de pasar a search_funds un category/sector/geographic_zone que no tengas seguro, consúltalo aquí y usa el valor literal devuelto, no lo inventes; (4) VALIDAR que una temática existe antes de buscarla (cripto/blockchain, cannabis, defensa…): si no aparece ninguna categoría ni sector relacionado, no lances search_funds con un valor inventado. La gestora NO es un filtro propio: para acotar por gestora usa su nombre exacto (el que devuelve esta herramienta) dentro del query libre de search_funds. Cada dimensión trae total (cuántos valores distintos existen) y values (los más frecuentes, hasta top). Para enseñar fondos al usuario usa search_funds; para fichas completas por ISIN, get_funds.
list_instrument_facets
ChatGPTDevuelve los valores que existen DE VERDAD en el catálogo de ETFs/acciones por dimensión, con cuántos instrumentos hay en cada uno (recuentos EXACTOS, en una sola llamada). No muestra ninguna vista al usuario — es para tu análisis. Dimensiones: geography, sector, currency, asset_type, management_type, management_company (gestora, solo aplica a ETFs). Úsala PRIMERO, antes que search_etfs/search_stocks, en estos casos: (1) preguntas de CONTEO o catálogo ('¿cuántos ETFs indexados hay?', '¿cuántas divisas hay?') — responde con esta herramienta, NO infieras el total desde una búsqueda con tope 10; (2) DESCUBRIMIENTO ('¿qué sectores hay?', '¿qué geografías existen?'); (3) FUNDAMENTAR un filtro — antes de pasar a search_etfs/search_stocks un geography/sector/asset_type/management_type que no tengas seguro, consúltalo aquí y usa el valor literal devuelto; (4) tras una búsqueda de ETFs/acciones con 0 resultados, para ver qué valores existen de verdad antes de reintentar. Usa product_type ('etf' o 'stock') para acotar los recuentos a un solo tipo. Cada dimensión trae total (cuántos valores distintos existen) y values (los más frecuentes, hasta top). Para enseñar ETFs/acciones al usuario usa search_etfs/search_stocks; para fichas completas por ticker, get_instruments.
resolve_funds
ChatGPTResuelve uno o varios nombres de fondo (en una sola llamada) a candidatos verificados del catálogo MyInvestor, con ISIN exacto. Úsala ANTES de compare_instruments cuando el usuario nombra fondos por texto (p.ej. 'compara el vanguard global stock con el emerging markets'). Devuelve, por cada nombre, los mejores candidatos y un veredicto: confidence: "high" (un único fondo claro → compara directamente con su ISIN) o confidence: "ambiguous" con ambiguity_reason (share_class, asset_class, multiple_matches, manager_only, no_match). Cuando algún nombre es ambiguo, la herramienta MUESTRA un selector de candidatos en la interfaz para que el usuario elija; tú añade una frase breve ('¿Cuál de estos te refieres?'). Cuando el usuario elige, su selección llega como contexto (marcador de fondo activo) y entonces puedes continuar (p.ej. comparar). No expongas ISINs ni nombres de parámetros — habla de los fondos por nombre/gestora.
search_etfs
ChatGPTBusca ETFs (fondos cotizados) del bróker de MyInvestor. Devuelve hasta 10 ETFs con ficha: TER, AUM, nº de posiciones, gestión activa/indexada, top sectores/regiones/asset allocation, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, geografía, divisa y descripción. El identificador es el TICKER (p.ej. 'CSPX', 'SXR8.DE'). Para acciones individuales usa search_stocks. Para fondos de inversión (no cotizados) usa search_funds. Por defecto se excluyen los ETPs apalancados/inversos (2x, 3x, inverse); usa include_leveraged para incluirlos.
search_funds
ChatGPTBusca fondos de inversión de MyInvestor (gestión activa e indexados). Devuelve hasta 10 fondos con ficha completa por fondo: TER, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, riesgo SRRI, rating Morningstar, asset allocation, top sectores/regiones, fees, NAV y descripción. Filtros combinables con AND: category (filtro principal por geografía/estilo/tema), asset_class, geographic_zone, sector, product_type, max_ter, max_risk, min_aum… más un query libre con ranking BM25 para buscar por nombre/gestora ('vanguard nasdaq', 'iShares emergentes'). Por defecto ordena por rentabilidad 3A anualizada descendente; con query y sin order_by explícito, usa relevancia. Para MOSTRAR fondos concretos cuyo ISIN ya conoces (p.ej. tras resolve_funds), pasa isins: búsqueda exacta, sin match por nombre. Para comparar 2-3 productos (fondos, ETFs y/o acciones, del mismo tipo o mezclados), usa compare_instruments con sus identificadores EXACTOS (ISIN de fondo, o ticker/ISIN de ETF o acción); resuelve antes los nombres con resolve_funds. Para carteras automatizadas (robo-advisor) usa search_portfolios / compare_portfolios.
search_portfolios
ChatGPTBusca y filtra el catálogo de 13 carteras automatizadas (robo-advisor): 6 indexadas de MyInvestor y 7 de Finanbest (incluida la Sostenible). Filtros componibles: query libre, profile, risk_max, family (myinvestor|finanbest), management, order_by. El payload de cada cartera ya contiene composición, fondos subyacentes con ISIN, comisiones e histórico anual — es la ficha completa, no un resumen. Para comparar 2-3 carteras por name_id, usa compare_portfolios.
search_stocks
ChatGPTBusca acciones (renta variable cotizada) del bróker de MyInvestor. Devuelve hasta 10 acciones con ficha: capitalización, PER, rentabilidad por dividendo, rentabilidades (YTD/1A/3A/5A y por año natural), volatilidad, sector, geografía, divisa y descripción. El identificador es el TICKER (p.ej. 'AAPL', 'DMP.DE'). Para ETFs usa search_etfs. Para fondos de inversión usa search_funds.