SolGlider.net
FR EN
Documentation

Docs

Documentation technique — concepts, sécurité, API (aperçu) et fonctionnement.

Aperçu

SolGlider est une plateforme orientée exécution et contrôle: un moteur de trading, des stratégies modulaires (templates), et un dashboard qui expose l’état, les métriques et les événements.

  • Exchange cible: NDAX (SOL/CAD).
  • Architecture: séparation présentation / logique / données.
  • Principe: décisions sur bougies clôturées + exécution contrôlée (state machine).
  • Traçabilité: journalisation structurée (trades, erreurs, événements).
NDAX SOL/CAD State Machine Logs structurés

Démarrage

But: comprendre le flux de bout en bout (données → signal → ordre → suivi → métriques).

Créer un compte / se connecter

L’auth sécurise l’accès au dashboard et aux paramètres de stratégie.

Choisir un template de stratégie

Ex.: Dip Rebound / Mean Reversion / Semi-auto (selon disponibilité).

Configurer les paramètres

Quantité, limites de risque, filtres d’entrée/sortie, cadence, etc.

Activer un mode

Live / Dry-run / Backtest (selon disponibilité).

Surveiller

État runtime (idle/armed/in-position/paused), logs, et résumé PnL.

Mode: Live Mode: Dry-run Mode: Backtest

Astuce: privilégie des paramètres conservateurs au début; l’objectif est d’obtenir une exécution stable et mesurable.

Concepts

Le vocabulaire SolGlider est volontairement technique pour éviter les ambiguïtés en exécution.

State Machine

États typiques: idle → armed → in-position → paused. Évite les ordres incohérents et verrouille les transitions.

Order Lifecycle

Création → placement → (open/partial/filled/canceled) → clôture. Chaque étape génère un événement journalisé.

Data Sources

Ticker (intrabar) pour suivi; bougies clôturées pour signaux. Réduit le bruit et stabilise les décisions.

Risk Layer

Limites de pertes, kill-switch, pauses, max stop-loss/jour, et garde-fous d’exécution.

Templates

Stratégies sous forme de modules paramétrables, versionnées et comparables via métriques.

Observability

Logs structurés + métriques: drawdown, winrate, slippage estimée, latence, stabilité.

API (aperçu)

Aperçu des endpoints typiques (format sujet à changement). L’objectif est de standardiser les échanges UI ↔ moteur.

GET /api/v1/price?symbol=SOL/CAD

Retourne le dernier prix et métadonnées (source, timestamp).

Response
{ "ok": true, "symbol": "SOL\/CAD", "last": 173.21, "ts": 1710000000, "source": "ndax" }

GET /api/v1/bot/status

Retourne l’état runtime et le résumé d’exécution.

Response
{ "ok": true, "state": "idle", "mode": "dry_run", "in_position": false, "last_event": "startup" }

POST /api/v1/bot/start

Démarre l’exécution avec la config active (validation + verrouillage).

Request
{ "mode": "live", "strategy": "dip_rebound" }
Response
{ "ok": true, "state": "armed" }

POST /api/v1/bot/stop

Stoppe proprement (cancel ordres ouverts + état stable).

Response
{ "ok": true, "state": "paused" }

POST /api/v1/config/validate

Valide la configuration: types, bornes, cohérence des paramètres.

Request
{ "qty": 1, "risk": { "kill_dd_pct": 10 } }
Response
{ "ok": true, "warnings": [] }

Codes d’erreur

  • 400: paramètres invalides (validation).
  • 401/403: non autorisé / permissions insuffisantes.
  • 409: conflit d’état (ex.: start quand déjà in-position).
  • 429: rate limit (protection).
  • 500: erreur interne (journalisée).

Sécurité

SolGlider vise des standards de sécurité pratiques: minimiser l’exposition, isoler l’exécution, et tracer chaque action sensible.

  • Secrets: stockés côté serveur (env/keystore), jamais exposés côté client.
  • Sessions: cookies sécurisés (HTTPS recommandé), expiration, invalidation à la déconnexion.
  • Isolation: exécution isolée (conteneurs) lorsque disponible.
  • Garde-fous: validation config + limites d’exécution (rate limits, timeouts, retries contrôlés).
  • Audit: événements clés journalisés (login, start/stop, erreurs d’ordres).

Fiabilité

Une plateforme de trading doit privilégier la stabilité: reprise, cohérence d’état, et observabilité.

  • Reprise: redémarrage contrôlé + reconstruction d’état (si applicable).
  • Tolérance réseau: timeouts, retries limités, backoff, et dégradation contrôlée.
  • Cohérence: transitions d’état strictes (state machine).
  • Logs: rotation + format stable; événements utiles au debugging.
  • Métriques: drawdown, net PnL, fréquence, erreurs, latences (selon disponibilité).

FAQ

Est-ce que SolGlider est un conseil financier?

Non. SolGlider est un outil technique d’exécution. Les décisions et risques appartiennent à l’utilisateur.

Pourquoi NDAX uniquement?

Réduction de surface et meilleure fiabilité: une intégration solide avant d’étendre.

Est-ce que vous stockez mes clés?

Le design vise à garder les secrets côté serveur et à limiter l’exposition. Les détails dépendent du mode et de l’infrastructure.

C’est live maintenant?

Certaines fonctionnalités peuvent être en cours de déploiement. La roadmap décrit les étapes d’industrialisation.