myFund.pl API v1
兼容性：myFund.pl API v1，基础 URL https://myfund.pl/API/v1。
来源：捆绑文档快照，日期 2026-11-03。3.1.0 是 OpenAPI 格式版本，1.0.0 是技能版本；两者均非 API 版本。该 API 被描述为 beta 版。不保证与其他版本的兼容性。
选择操作
| 需求 | 方法和路径 |
|---|---|
| 列出投资组合 | GET /getPortfele.php |
| 持仓、业绩、历史、股息、账户、负债 | GET /getPortfel.php |
| 交易或现金流动（JSON 格式） | POST /importOperacji.php |
| 券商导出文件 | POST /importOperacjiPlik.php |
| 含缴款明细的 PPK 导出 | POST /importOperacjiPPKPlik.php |
在构造请求之前，请阅读 references/openapi.yaml 中的相关端点及其模式。实用指南和示例请参见 references/workflows.md。 请勿发明端点、导入源名称或未记录的参数。
身份验证与执行
从 菜单 > 账户 > 账户设置 > API 密钥 获取密钥。重新生成密钥将使之前的密钥失效。从环境中使用密钥（例如 MYFUND_API_KEY）；请勿将其存储在技能或示例中。不要记录包含密钥的完整 URL、诊断标头或私有数据。不要读取并显示整个 .env 文件来查找单个密钥。
读取操作需要在查询中使用 apiKey。对于导入，请使用 JSON 正文或 multipart 字段。对参数进行 URL 编码，保留波兰语字符和确切的投资组合名称，而不是其 ID。对于 multipart 请求，让客户端生成带有其边界的 Content-Type。
请同时检查 HTTP 状态和 status.code："0" 表示成功，"1" 表示错误，"7" 表示投资组合不存在。仅凭 HTTP 200 不能确认成功。如果响应缺少预期的状态或数据，请报告不完整的结果。读取操作缓存 5 分钟；导入操作不缓存。不要承诺导入后检索的数据会立即更新。
读取与解释
如果投资组合名称未知，请先检索投资组合列表。在限制 scope 时，始终包含 status；仅选择所需的字段。scope 仅适用于顶层，且区分大小写。未知字段将被忽略；缺少字段并不表示值为零。
保留货币、日期和单位。数值通常是字符串，有时带有 +；将空值、--- 和 视为缺失数据。不要将整个对象盲目转换为数字。对货币使用十进制算术。tickers 和历史记录是映射，而不是数组；时间序列是按日期键控的映射。不要混淆 struktura 中的货币值与 strukturaWalory 中的股份。
导入会改变投资组合
仅准备数据并不授权提交导入。当用户请求时才执行导入；不要再询问已授予的授权。在提交之前，请确定投资组合、数据、账户、文件来源和重复策略。如果影响写入的信息缺失，请准备预览并要求提供。不要填写未知的价格、数量、日期或税费。
默认保持 duplikaty=1 和 sprawdzCene="true"。duplikaty=2 可能会重复操作；仅在明确指示时使用。不要假设导入是原子性的或幂等的。超时或连接丢失后，请勿自动重试 POST：检查历史记录和导入状态，并考虑缓存。没有文档化的试运行模式；本地预览并非服务器验证。完成后，报告响应中存在的状态、操作数量、遗漏项和最早日期。区分请求准备与已执行的导入。