Sobre o projeto

Este repositório entrega uma métrica prospectiva de risco de liquidação para perpétuos de BTC na Hyperliquid, construída como prova de conceito para um desafio de liderança em dados. Em vez de reportar liquidações que já foram executadas, ele mapeia a pressão latente de liquidação de posições que ainda estão abertas, posicionadas nos preços em que seriam acionadas. Os principais resultados são um Índice de Fragilidade em Cascata (CFI, 0–100), que mede a concentração ponderada por proximidade do nocional liquidável perto do preço de marcação atual, e uma pontuação de Assimetria Long/Short (−1 a +1) que indica qual lado carrega mais combustível perto do preço. O projeto é explícito sobre suas limitações de dados: ele amostra as ~2.000 principais carteiras por atividade recente em vez do livro de posições completo, reporta a cobertura relativa ao open interest, filtra preços de liquidação nulos e residuais, e observa que a métrica não pode ser retroativamente preenchida porque a API expõe apenas o estado atual da conta. O pipeline é implementado como um pacote Python com módulos para acesso à API, seleção de carteiras, cálculo de métricas, armazenamento, reconstrução de heatmap e geração do site. Ele pode ser executado localmente como um pipeline de execução única, agendado por meio de uma DAG do Airflow, ou atualizado automaticamente via um fluxo de trabalho do GitHub Actions que reconstrói e implanta uma página única no GitHub Pages. Os testes cobrem a matemática do CFI e da assimetria, os filtros de limpeza e o comportamento de histórico somente anexação. O projeto declara explicitamente que não é uma previsão de preço nem um gatilho de timing, mas uma geografia condicional de risco sobre uma amostra de carteiras.