Usage

Hell Track a pour objectif de tracker les stratégies (successions de positions) de liquidity providing.

Là où les outils habituels track les positions une par une, Hell Track groupe les positions sous-jacentes sous un tracking unique bien plus pertinent.

Actuellement Hell Track se base uniquement sur Krystal : à la fois en ce qui concerne l'identification des stratégies, mais aussi en ce qui concerne la collecte des données (transactions au sein des positions sous-jacente).

Le Tracker n'est pas encore disponible publiquement mais c'est un objectif à horizon fin 2025. Si vous commencez déjà à mettre en place des stratégies long terme et que vous projetez d'utiliser le Tracker quand il sera dispo : je vous conseille vivement de ne pas activer l'option Compound dans vos Auto Rebalance. Cela améliorera la qualité du tracking.

Commande --help

L'outil dispose d'une commande --help dont voici l'output :

 ---------------------------------------
|============ HELL TRACKER =============|
 ---------------------------------------
usage: hell_tracker [-h] -s STRATEGY_ID_OR_FILE [-c] [-l] [--dump | --local]

Hell Tracker — Export and track the performance of Krystal liquidity strategies.

Usage modes:
  • Default (fetch and display metrics from Krystal API).
  • --dump   → Fetch from API and write data locally.
  • --local  → Read data from local files (CSV/JSON).

options:
  -h, --help            show this help message and exit
  -s, --strategy STRATEGY_ID_OR_FILE
                        The Krystal strategy ID to track, or a filepath to a list of IDs.
                        Use with --list-mode when providing a file.
  -c, --confidential    Enable confidential mode (masks sensitive financial data).
  -l, --list-mode       Enable strategy list mode (read multiple strategy IDs from file).
  --dump                Enable dump mode: fetch data from Krystal API and write to disk.
                        Can't be used with --local.
  --local               Enable local mode: read data from local files (data/*.json).
                        Can't be used with --dump.

Exemples d'utilisation

1. Tracker une liste de stratégies depuis un fichier et les enregistrer en local :

./main.py -s sl_tctk.txt -l --dump

1. Affiner votre monitoring global en trackant une seule stratégie (en retirant le mode liste, l'outil vous affiche également l'historique des transactions) :

./main.py -s 6167

1. Tracker une liste de stratégies depuis un --dump précédemment effectué :

./main.py -s sl_tctk.txt -l --local

1. Exemple d'un fichier sl_tctk.txt :

6167
5916

Exemple d'output

Pour comprendre les métriques qui vous sont retournées, jetez un oeil à la page Métriques.