API de myFund.pl v1
Compatibilidad: API v1 de myFund.pl, URL base https://myfund.pl/API/v1.
Fuente: instantánea de documentación empaquetada con fecha 2026-11-03. 3.1.0 es la
versión del formato OpenAPI y 1.0.0 es la versión del skill; ninguna es la versión de la API.
La API se describe como beta. No asumas compatibilidad con otras versiones.
Elige una operación
| Necesidad | Método y ruta |
|---|---|
| Listar carteras | GET /getPortfele.php |
| Tenencias, rendimiento, historial, dividendos, cuentas, pasivos | GET /getPortfel.php |
| Transacciones o flujos de efectivo como JSON | POST /importOperacji.php |
| Archivo de exportación del bróker | POST /importOperacjiPlik.php |
| Exportación PPK con desglose de aportaciones | POST /importOperacjiPPKPlik.php |
Antes de construir una solicitud, lee el endpoint correspondiente y sus esquemas en references/openapi.yaml. La orientación práctica y ejemplos se encuentran en references/workflows.md. No inventes endpoints, nombres de fuentes de importación ni parámetros no documentados.
Autenticación y ejecución
Obtén la clave desde Menú > Cuenta > Configuración de cuenta > Clave API.
Regenerarla invalida la clave anterior. Usa un secreto del entorno
(p. ej. MYFUND_API_KEY); no lo almacenes en el skill ni en los ejemplos.
No registres URLs completas que contengan la clave, cabeceras de diagnóstico ni datos privados.
No leas ni muestres un archivo .env completo para encontrar un solo secreto.
Las lecturas requieren apiKey en la consulta. Para importaciones, usa el cuerpo JSON o campos multipart.
Codifica los parámetros en URL, conservando caracteres polacos y el nombre exacto de la cartera, no su ID.
Para solicitudes multipart, deja que el cliente genere Content-Type con su límite.
Verifica tanto HTTP como status.code: "0" significa éxito, "1" un error,
y "7" una cartera faltante. HTTP 200 por sí solo no confirma éxito.
Si la respuesta carece del estado o datos esperados, informa un resultado incompleto.
Las lecturas se almacenan en caché durante 5 minutos; las importaciones no. No prometas actualizaciones
inmediatas a los datos recuperados después de una importación.
Lectura e interpretación
Recupera primero la lista de carteras si se desconoce el nombre. Al restringir
scope, incluye siempre status; selecciona solo los campos necesarios.
scope solo se aplica en el nivel superior y distingue entre mayúsculas y minúsculas.
Los campos desconocidos se omiten; un campo faltante no significa cero.
Conserva moneda, fechas y unidades. Los valores numéricos suelen ser cadenas,
a veces con +; trata los valores vacíos, --- y como datos faltantes.
No conviertas ciegamente todo el objeto a números. Usa aritmética decimal para el dinero.
tickers y el historial son mapas, no arreglos; las series temporales son mapas claveados por fecha.
No confundas valores monetarios en struktura con acciones en strukturaWalory.
Las importaciones modifican la cartera
Preparar datos por sí solo no autoriza a enviar una importación. Ejecuta una importación cuando el usuario lo solicite; no vuelvas a preguntar por una autorización ya otorgada. Antes de enviar, establece la cartera, datos, cuentas, fuente del archivo y política de duplicados. Si falta información que afecte la escritura, prepara una vista previa y pregúntala. No completes precios, cantidades, fechas o impuestos desconocidos.
Mantén duplikaty=1 y sprawdzCene="true" por defecto.
duplikaty=2 puede duplicar operaciones; úsalo solo con instrucción explícita.
No asumas que las importaciones son atómicas o idempotentes. Después de un tiempo de espera o pérdida de conexión,
no reintentes automáticamente POST: verifica el historial y el estado de importación, teniendo en cuenta la caché.
No hay modo de prueba en seco documentado; una vista previa local no es validación del servidor.
Después de completar, informa el estado, número de operaciones, omisiones y la fecha más temprana
cuando esté presente en la respuesta. Distingue la preparación de la solicitud de una importación ejecutada.