À propos du projet

Ce dépôt fournit une métrique prospective du risque de liquidation pour les contrats perpétuels BTC sur Hyperliquid, conçue comme une preuve de concept pour un défi de leadership en données. Au lieu de rapporter les liquidations déjà exécutées, il cartographie la pression de liquidation latente des positions encore ouvertes, placées aux prix où elles se déclencheraient. Les principaux résultats sont un indice de fragilité en cascade (CFI, 0–100), qui mesure la concentration pondérée par la proximité du notionnel liquidable près du prix de référence actuel, et un score d'asymétrie long/short (−1 à +1) indiquant quel côté concentre le plus de carburant près du prix. Le projet est explicite sur ses limites de données : il échantillonne les ~2 000 principaux portefeuilles par activité récente plutôt que le carnet de positions complet, rapporte la couverture par rapport à l'intérêt ouvert, filtre les prix de liquidation nuls et résiduels, et note que la métrique n'est pas rétro-remplissable car l'API n'expose que l'état actuel des comptes. Le pipeline est implémenté sous forme de package Python avec des modules pour l'accès à l'API, la sélection des portefeuilles, le calcul des métriques, le stockage, la reconstruction de la carte thermique et la génération du site. Il peut être exécuté localement comme pipeline ponctuel, planifié via un DAG Airflow, ou mis à jour automatiquement via un workflow GitHub Actions qui reconstruit et déploie un livrable d'une seule page sur GitHub Pages. Les tests couvrent les mathématiques du CFI et de l'asymétrie, les filtres de nettoyage et le comportement d'historique en ajout seul. Le projet indique explicitement qu'il ne s'agit pas d'une prévision de prix ni d'un déclencheur de timing, mais d'une géographie conditionnelle du risque sur un échantillon de portefeuilles.