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 被描述為測試版。請勿假設與其他版本相容。
選擇操作
| 需求 | 方法與路徑 |
|---|---|
| 列出投資組合 | 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 主體或多部分欄位。
對參數進行 URL 編碼，保留波蘭文字元與確切的投資組合名稱（而非其 ID）。
對於多部分請求，讓用戶端自行生成包含邊界的 Content-Type。
同時檢查 HTTP 狀態碼與 status.code："0" 表示成功，"1" 表示錯誤，
而 "7" 表示投資組合不存在。僅 HTTP 200 並不能確認成功。
如果回應缺少預期的狀態或資料，請報告不完整的結果。
讀取請求會快取 5 分鐘；匯入請求則不會。請勿承諾匯入後檢索的資料會立即更新。
讀取與解讀
如果投資組合名稱未知，請先擷取投資組合清單。當限制
scope 時，務必包含 status；僅選擇所需的欄位。
scope 僅適用於頂層，且區分大小寫。
未知欄位會被省略；缺少欄位不代表數值為零。
保留貨幣、日期與單位。數值通常為字串，
有時帶有 +；將空值、--- 和 視為遺失資料。
請勿盲目地將整個物件轉為數字。對貨幣使用十進位算術。
tickers 與歷史紀錄是映射（map），而非陣列；時間序列是以日期為鍵的映射。
請勿混淆 struktura 中的貨幣值與 strukturaWalory 中的股份。
匯入會改變投資組合
僅準備資料並不等於授權提交匯入。當使用者要求時才執行匯入； 請勿對已授予的授權再次提問。在提交之前，請先確定投資組合、資料、帳戶、檔案來源與重複政策。 如果影響寫入操作的資訊缺失，請準備預覽並向使用者詢問。 請勿填寫未知的價格、數量、日期或稅款。
預設保持 duplikaty=1 與 sprawdzCene="true"。
duplikaty=2 可能會重複操作；僅在明確指示下使用。
請勿假設匯入操作是原子性（atomic）或冪等（idempotent）的。
逾時或連線中斷後，請勿自動重試 POST：檢查歷史紀錄與匯入狀態，並考慮到快取。
沒有文件支援的試執行模式（dry-run）；本地預覽並非伺服器驗證。
完成後，報告回應中的狀態、操作數量、遺漏項目以及最早日期。
區分請求準備與已執行的匯入。