Guia de Utilização do Mercado de Extensões

Aviso de risco: O Mercado de Extensões distribui estratégias e ferramentas, mas não garante qualquer retorno. Antes de negociar em real, faça sempre backtest da extensão, execute-a em simulação e só depois considere negociação real com capital reduzido. Não active permissões de levantamento nas chaves API das bolsas.

Depois de abrir a aplicação, aceda a Extensões na navegação superior.

A página está dividida em duas áreas:

Pode arrastar o separador entre as áreas esquerda e direita para ajustar a largura do painel As Minhas Extensões.

O painel As Minhas Extensões serve para gerir e consultar as extensões relacionadas com o seu ambiente actual.

Podem aparecer aqui dois tipos de conteúdo:

• Extensões já transferidas e instaladas neste computador.
• Extensões que a conta actualmente autenticada possui ou adicionou na nuvem.

Importante: a aplicação determina se uma extensão está "instalada" principalmente verificando se existe localmente o ficheiro de blueprint de mercado correspondente, e não apenas consultando a lista da conta na nuvem. Assim, uma extensão pode pertencer-lhe na nuvem, mas se ainda não tiver sido transferida para este computador, pode continuar a aparecer como não instalada.

Etiquetas comuns:

Acções comuns:

A página inicial do mercado apresenta a lista de extensões instaláveis. Por predefinição, extensões com mais transferências e melhores avaliações aparecem primeiro.

Pode reduzir a lista destas formas:

• Pesquisa por palavra-chave: introduza o nome da extensão, autor, resumo, categoria, tipo de mercado ou outra palavra-chave e clique em Pesquisar ou prima Enter.
• Filtro por categoria: veja extensões por categoria, por exemplo estratégia, controlo de risco, sinal ou ferramenta. As categorias disponíveis são devolvidas pelo backend do mercado.
• Filtro por tipo de mercado: filtre pelo mercado suportado, como Spot ou Futures.

Se não houver resultados, limpe a palavra-chave e coloque a categoria e o tipo de mercado em Todos.

Cada cartão na lista do mercado mostra informação essencial:

As extensões de blueprint são normalmente adequadas para fluxos directos de estratégia. Para scripts ou ferramentas, leia a página de detalhe para saber como usar.

Clique num cartão de extensão para abrir a página de detalhe. A página inclui informação de cabeçalho, área de documentação, comentários e um painel lateral de informação.

Preste atenção a estas áreas:

Se a página de detalhe mostrar "sem detalhes" ou "sem registo de alterações", significa que o publicador não forneceu esse conteúdo. Nesse caso, use com maior prudência e faça backtests suficientes.

Passos de instalação:

1. Aceda a Extensões.
2. Pesquise ou filtre a extensão pretendida na lista do mercado.
3. Clique no cartão da extensão para abrir a página de detalhe.
4. Leia Detalhes, Registo de alterações, comentários e informação de backtest.
5. Clique em Instalar.
6. Se a extensão exigir um código de acesso, introduza-o na janela apresentada e confirme.
7. Aguarde a mensagem de instalação concluída.
8. Aceda a Blueprint ou à Gestão de Recursos para ver o novo blueprint de mercado instalado.

Ao instalar uma extensão de blueprint, a aplicação transfere o pacote para o directório local de blueprints de mercado e actualiza o espaço de trabalho de blueprints. Depois da instalação, a extensão mantém informação de origem do mercado, informação de versão, informação de verificação do pacote e hora de transferência, para que a aplicação consiga identificar o estado de instalação e futuras actualizações.

A instalação pode exigir a permissão correspondente. Se a conta actual não tiver permissão de transferência, a aplicação apresentará um aviso de permissão.

O Mercado de Extensões suporta vários modos de transferência:

Para extensões protegidas por código, aparece uma caixa de introdução durante a instalação. A instalação não prossegue se o código estiver vazio ou incorrecto. Verifique maiúsculas/minúsculas, espaços adicionais e validade.

As extensões de blueprint suportam Pré-visualização de backtest. Esta função ajuda a avaliar rapidamente, antes da instalação, se a extensão merece análise adicional.

Comportamento da pré-visualização de backtest:

• Apenas extensões de blueprint suportam pré-visualização de backtest.
• A pré-visualização obtém um blueprint remoto do mercado e não o grava directamente nos ficheiros locais de blueprint.
• A aplicação verifica se o blueprint compila antes de abrir a janela de backtest.
• A janela de backtest inicia automaticamente.
• O par predefinido usa primeiro a configuração existente no blueprint; se não existir, usa BTCUSDT.

O intervalo predefinido de backtest é decidido pelo intervalo de execução do blueprint:

O resultado da pré-visualização representa apenas um teste em dados históricos. Antes de usar formalmente, instale a extensão e volte à página Blueprint para testar com o seu próprio par, intervalo, comissões, slippage, capital, alavancagem e um período mais longo.

Depois de instalada, uma extensão de blueprint entra no espaço de trabalho local de blueprints. Fluxo recomendado:

1. Abra Blueprint.
2. Encontre o blueprint de mercado instalado na lista de blueprints ou na Gestão de Recursos.
3. Abra o blueprint e verifique a estrutura dos nós, parâmetros, intervalo de execução, tipo de mercado e nós de controlo de risco.
4. Execute backtests históricos e reveja lucros/prejuízos, drawdown, taxa de acerto, número de operações e registos de ordens.
5. Na página Negociação, monte o blueprint no gráfico ou conta alvo.
6. Execute primeiro em modo de simulação e observe disparos de sinais, intenções de ordem e rejeições por controlo de risco.
7. Depois de confirmar comportamento estável, considere negociação real com capital reduzido.

Antes de negociar em real, verifique:

• Se a conta actual está correcta.
• Se o par e o tipo de mercado correspondem, por exemplo spot ou futures.
• Se a alavancagem, modo de margem e dimensionamento de posição estão dentro da sua tolerância ao risco.
• Se a estratégia inclui controlos como limite de frequência, posição máxima, stop loss, cooldown e kill switch.
• Se a chave API tem apenas as permissões necessárias e não permite levantamentos.

Quando uma extensão instalada mostra a etiqueta Actualização disponível, pode clicar em Actualizar na página de detalhe ou no painel As Minhas Extensões.

Antes de actualizar, faça três coisas:

1. Leia o Registo de alterações para perceber o que mudou.
2. Pare todos os mounts de blueprint em execução.
3. Registe os parâmetros principais e resultados de backtest da versão actual para comparação.

Regras de actualização:

• Só extensões de blueprint suportam detecção de actualização de versão no fluxo de instalação actual.
• Se a versão actual já for a mais recente, a aplicação indica que não é necessária actualização.
• Se esta extensão de blueprint tiver um mount em execução, a aplicação recusa a actualização até que o mount seja parado.
• Se existirem mounts parados, a janela de confirmação mostra a quantidade; após confirmar, a aplicação sincroniza o snapshot da versão do blueprint nesses mounts.
• A actualização mantém o ID local do blueprint e remove ficheiros de versões antigas da mesma extensão de mercado.

Depois de actualizar, não retome imediatamente a negociação real. Faça primeiro backtest da nova versão e depois execute em simulação para confirmar que o comportamento corresponde ao esperado.

A desinstalação remove o ficheiro local de blueprint de mercado correspondente e remove a relação da extensão com o utilizador actual.

Passos de desinstalação:

1. Encontre a extensão em As Minhas Extensões ou na página de detalhe.
2. Clique em Desinstalar.
3. Leia a janela de confirmação.
4. Confirme e aguarde a conclusão da desinstalação.

Regras de desinstalação:

• Se a extensão tiver um mount em execução, a aplicação recusa a desinstalação. Pare primeiro o mount.
• Se a extensão tiver mounts parados, confirmar a desinstalação também remove esses mounts.
• Depois de desinstalar, o espaço de trabalho de blueprints é actualizado e a extensão deixa de aparecer como instalada localmente.

Se apenas pretende impedir temporariamente que a estratégia negocie, pare primeiro o mount ou desligue a negociação automática. Desinstale apenas quando tiver a certeza de que já não precisa da extensão.

Extensões instaladas podem ser avaliadas na página de detalhe através de Avaliar.

Regras de avaliação:

• Deve seleccionar de 1 a 5 estrelas.
• Deve introduzir o conteúdo do comentário.
• Após submissão bem-sucedida, a secção de comentários é actualizada.
• Se a API de comentários tiver um pequeno atraso, a aplicação mostra temporariamente o seu novo comentário localmente e substitui a lista por dados do servidor numa actualização posterior.

A secção de comentários pode mostrar utilizadores comuns, autores e administradores. As etiquetas de autor ou administrador apenas identificam a origem do comentário e não garantem retornos da estratégia.

Verifique a rede e o estado de autenticação, depois clique no botão de actualizar junto de As Minhas Extensões ou volte a entrar em Extensões. Se a API do mercado estiver temporariamente indisponível, a lista pode ficar vazia.

Limpe a palavra-chave e volte a colocar a categoria e o tipo de mercado em Todos. A pesquisa só corresponde a campos disponíveis na lista actual do mercado, como nome, autor, resumo, categoria, modo de transferência e tipo de mercado.

Normalmente isto significa que o computador actual ainda não tem o ficheiro local de instalação. Clique em Transferir e instalar; só depois de a instalação terminar passa a Instalada.

As causas possíveis incluem URL de transferência indisponível, problemas de rede, código de acesso incorrecto, falta de permissão de transferência na conta, formato de pacote inválido ou falha de validação de compilação do blueprint. Actualize o mercado e tente novamente; para extensões protegidas por código, confirme que o código está correcto.

Mude primeiro para Blueprint e actualize a Gestão de Recursos. Se continuar a não aparecer, volte a Extensões e actualize. O estado de instalação depende dos ficheiros locais de blueprint de mercado; ficheiros removidos ou directórios sem permissão de escrita podem afectar a apresentação.

Pode ter falhado a obtenção do blueprint remoto, a compilação do blueprint, a preparação da janela de backtest ou a disponibilidade de dados de mercado. Tente novamente Pré-visualização de backtest na página de detalhe, ou instale a extensão e faça backtest manualmente na página de blueprint.

Se não houver etiqueta Actualização disponível, a versão actual já é a mais recente ou o número de versão não pode ser comparado de forma fiável. Se existir um mount em execução, pare-o antes de actualizar.

Se a extensão tiver um mount em execução, a aplicação bloqueia a desinstalação. Pare o mount correspondente em Negociação ou na Gestão de Recursos, depois volte ao Mercado de Extensões e desinstale.

Confirme que a conta actual tem permissão de avaliação e verifique a rede. Tem de seleccionar uma classificação por estrelas e introduzir um comentário.

Na primeira utilização do Mercado de Extensões, siga esta ordem:

1. Pesquise ou filtre a extensão pretendida no Mercado de Extensões.
2. Abra os detalhes e leia a documentação, registo de alterações, comentários e informação de backtest.
3. Para extensões de blueprint, execute primeiro Pré-visualização de backtest.
4. Instale a extensão.
5. Aceda a Blueprint, volte a fazer backtest e verifique parâmetros e controlos de risco.
6. Monte em modo de simulação.
7. Observe registos, ordens, rejeições por controlo de risco e alterações na conta.
8. Após várias validações, considere negociação real com capital reduzido.
9. Pare os mounts em execução antes de actualizar e volte a fazer backtest após actualizar.
10. Quando já não precisar da extensão, pare primeiro os mounts e depois desinstale-a.