La API de myportfolios.ai
Los mismos datos que impulsan myportfolios.ai en una API REST con JSON: señales de mercado con IA, portafolios modelo, picks con P&L en vivo, historial de resultados, noticias y termómetros del mercado.
Qué ofrece la API
Señales con IA
El Top 5 actual (COMPRAR, VENDER o MANTENER) con precio objetivo y tesis, más el historial de hasta 30 días.
Picks y track record
Picks activos con precio en vivo, gráfica y P&L, y los picks cerrados frente al SPY con tasa de acierto y alfa.
Portafolios modelo
Composición, retornos a 1M/3M/6M/1A, drawdown máximo y gráfica semanal de cada portafolio, más un simulador de inversión.
Pulso del mercado
Fear & Greed de acciones y cripto, bonos del Tesoro a 10 y 2 años, divisas, eventos y una franja de cotizaciones en vivo.
Noticias con IA
Tarjetas de noticias ilustradas y resumidas por IA de los últimos 30 días, con los tickers relacionados.
Datos del usuario
Perfil, portafolios seguidos, plan y alertas de un usuario que inició sesión en myportfolios.ai.
Acceso y autenticación
Las API keys las emite el equipo de myportfolios.ai a pedido; no hay registro automático. Escríbenos contando tu caso de uso y te enviaremos una key asociada a un plan de uso.
Escribir al equipo- Datos de mercado: header x-api-key, siempre desde tu servidor. Nunca la pongas en JavaScript del navegador, apps móviles, repositorios públicos ni URLs.
- Rutas de usuario (/me/*, /alerts): Authorization: Bearer con el ID token de Cognito del usuario que inició sesión. El usuario se identifica solo por el sub del token.
- Apps móviles (/app/*): los mismos datos de mercado con el ID token de Cognito del usuario (cliente mobile, PKCE). La app nunca lleva API key y el plan del usuario se aplica en el servidor.
- /payments/plans es público y no requiere key.
https://53e6fdizjl.execute-api.us-east-2.amazonaws.com/prod
Solo HTTPS (TLS 1.2+). JSON en UTF-8: el texto viene en español y muchos campos tienen su versión en inglés terminada en _en.
- Por API key: 5 solicitudes por segundo (ráfaga de 10) y 5.000 solicitudes al día (se reinicia a las 00:00 UTC).
- Al superarlos recibes 429. Además, el WAF permite 600 solicitudes cada 5 minutos por IP (403 hasta que termine la ventana).
- Ante un 429, reintenta con backoff exponencial y sirve tu copia en caché.
Los datos se recalculan pocas veces al día, así que guarda las respuestas en caché en tu servidor:
Tu primera solicitud
Reemplaza YOUR_API_KEY por tu key, guardada en una variable de entorno o en un gestor de secretos de tu servidor.
export MPA_BASE="https://53e6fdizjl.execute-api.us-east-2.amazonaws.com/prod"
export MPA_KEY="YOUR_API_KEY"
curl -s -H "x-api-key: $MPA_KEY" "$MPA_BASE/signals"
curl -s -H "x-api-key: $MPA_KEY" "$MPA_BASE/signals/history?days=7"Notas de seguridad
- Guarda la key en un gestor de secretos o en variables de entorno del servidor. Si pudo haberse filtrado, avísanos y la rotamos.
- La API no acepta CORS de orígenes de terceros: las llamadas desde el navegador fallan por diseño.
- No registres los headers completos de las solicitudes: contienen tu key o tokens de usuario.
- Trata los ID tokens de los usuarios como secretos: guárdalos en sesiones httpOnly del servidor, nunca en localStorage.
- Reporta vulnerabilidades en privado a security@myportfolios.ai. Por favor, no hagas pruebas de carga contra producción.
Referencia de la API
Generada a partir de la especificación OpenAPI pública. Es de solo lectura: el envío de solicitudes desde esta página está deshabilitado.