API v1 do myFund.pl
Compatibilidade: API v1 do myFund.pl, URL base https://myfund.pl/API/v1.
Fonte: snapshot da documentação em pacote datado de 2026-11-03. 3.1.0 é a versão do formato OpenAPI e 1.0.0 é a versão do skill; nenhum deles é a versão da API.
A API é descrita como beta. Não assuma compatibilidade com outras versões.
Escolha uma operação
| Necessidade | Método e caminho |
|---|---|
| Listar portfólios | GET /getPortfele.php |
| Posições, performance, histórico, dividendos, contas, passivos | GET /getPortfel.php |
| Transações ou fluxos de caixa como JSON | POST /importOperacji.php |
| Arquivo de exportação da corretora | POST /importOperacjiPlik.php |
| Exportação PPK com detalhamento de contribuições | POST /importOperacjiPPKPlik.php |
Antes de construir uma requisição, leia o endpoint relevante e seus esquemas em references/openapi.yaml. Orientações práticas e exemplos estão em references/workflows.md. Não invente endpoints, nomes de fontes de importação ou parâmetros não documentados.
Autenticação e execução
Obtenha a chave em Menu > Conta > Configurações da conta > Chave API.
Regenerá-la invalida a chave anterior. Use um segredo do ambiente
(por exemplo, MYFUND_API_KEY); não o armazene no skill ou nos exemplos.
Não registre URLs completas contendo a chave, cabeçalhos de diagnóstico ou dados privados.
Não leia e exiba um arquivo .env inteiro para encontrar um único segredo.
Leituras exigem apiKey na query. Para importações, use o corpo JSON ou campos multipart.
Codifique parâmetros na URL, preservando caracteres poloneses e o nome exato do portfólio, não seu ID.
Para requisições multipart, deixe o cliente gerar Content-Type com seu boundary.
Verifique tanto o HTTP quanto status.code: "0" significa sucesso, "1" erro,
e "7" portfólio não encontrado. HTTP 200 sozinho não confirma sucesso.
Se a resposta não tiver o status ou dados esperados, informe um resultado incompleto.
Leituras são armazenadas em cache por 5 minutos; importações não. Não prometa atualizações
imediatas dos dados recuperados após uma importação.
Leitura e interpretação
Recupere a lista de portfólios primeiro se o nome for desconhecido. Ao restringir
scope, inclua sempre status; selecione apenas os campos necessários.
scope se aplica apenas ao nível superior e diferencia maiúsculas de minúsculas.
Campos desconhecidos são omitidos; um campo ausente não significa zero.
Preserve moeda, datas e unidades. Valores numéricos são frequentemente strings,
às vezes com +; trate valores vazios, --- e como dados ausentes.
Não converta cegamente o objeto inteiro para números. Use aritmética decimal para dinheiro.
tickers e histórico são mapas, não arrays; séries temporais são mapas indexados por data.
Não confunda valores monetários em struktura com cotas em strukturaWalory.
Importações alteram o portfólio
Preparar dados sozinho não autoriza o envio de uma importação. Execute uma importação quando o usuário solicitar; não peça novamente por autorização já concedida. Antes de enviar, estabeleça o portfólio, dados, contas, fonte do arquivo e política de duplicatas. Se faltar informação que afete a escrita, prepare uma visualização e peça por ela. Não preencha preços, quantidades, datas ou impostos desconhecidos.
Mantenha duplikaty=1 e sprawdzCene="true" como padrão.
duplikaty=2 pode duplicar operações; use apenas sob instrução explícita.
Não assuma que importações são atômicas ou idempotentes. Após um timeout ou perda de conexão,
não tente novamente o POST automaticamente: verifique o histórico e o status da importação, levando em conta o cache.
Não há modo dry-run documentado; uma visualização local não é validação do servidor.
Após a conclusão, informe o status, número de operações, omissões e data mais antiga
quando presente na resposta. Distinga preparação de requisição de uma importação executada.