Documentation NuxVision

NuxVision est un tableau de bord de marché en lecture seule : il observe les marchés crypto, détecte des opportunités et les visualise pour vous. Il ne passe jamais d’ordres — vous restez entièrement aux commandes, que vous soyez débutant ou trader expérimenté.

1. Connectez-vous et vérifiez votre offre
   Connectez-vous depuis le site principal. Votre offre actuelle (Free / Pro / Expert) apparaît dans la barre du haut. Elle détermine jusqu’où vous pouvez remonter dans l’historique et combien de signaux vous voyez en temps réel. Vous pouvez la modifier à tout moment depuis Facturation.
2. Ouvrez Monitoring pour voir les signaux en direct
   Le tableau est organisé autour du rail de cycle de vie : Detected → In Position → Closed.
   • Detected : une nouvelle opportunité a été repérée.
   • In Position : la position simulée est “ouverte” et progresse vers un objectif.
   • Closed : la position simulée est terminée et le résultat est connu.
3. Apprenez les notions de base (aucune expérience de trading obligatoire)
   Vous croiserez quelques termes clés :
   • Entry : le prix où commence la position simulée.
   • Target : le prix où la position simulée vise à prendre ses profits.
   • PnL : “Profit and Loss” — le gain ou la perte en % sur cette position simulée.
   • Distance / Progress : des barres visuelles montrant la proximité de l’Entry ou du Target.
   Les traders expérimentés lisent ces chiffres directement ; les débutants peuvent s’appuyer sur les indicateurs visuels simples.
4. Utilisez le Dashboard pour voir la vue d’ensemble
   Le Dashboard vous donne un aperçu du comportement récent :
   • Avg PnL : résultat moyen des positions simulées clôturées sur la période sélectionnée.
   • Holding time : durée pendant laquelle les positions restent typiquement “In Position”.
   • Top performers & actifs les plus actifs : repérez rapidement les coins qui ont le plus bougé.
   C’est utile que vous vouliez juste un instantané du marché ou que vous analysiez le contexte pour une stratégie de trading.
5. Concentrez-vous sur votre propre watchlist
   Ajoutez une étoile aux actifs qui vous intéressent et, avec les offres Pro/Expert, utilisez les filtres et la recherche globale pour affiner votre vue. Vous pouvez copier n’importe quel prix ou pourcentage en un clic pour l’utiliser dans vos propres outils ou sur votre exchange.
6. (Optionnel — pour développeurs & quants) Connectez-vous via l’API
   Avec l’offre Expert, vous pouvez créer une clé API dans Settings → API Keys et interroger /api/v1/orders.php ou /api/v1/orders_stream.php. Cela vous permet d’intégrer les mêmes données normalisées dans vos propres bots, tableaux de bord ou scripts quantitatifs.

Monitoring est divisé en trois colonnes : Detected, In Position et Closed. Chaque carte affiche les prix, une barre de progression et des informations de temps. Voici des exemples montrant l’apparence des cartes Detected, In Position et Closed en temps réel.

• Detected : sur Free, on montre le plus petit potentiel ; Pro débloque toutes les détections en temps réel.
• In Position : progression vers le Target avec estimation de temps ; les 3 premières sont visibles sur Free, la liste complète sur Pro.
• Closed : toutes les positions passées (Free & Pro) avec le pourcentage réalisé et les horodatages.
• Affichage : les nombres sont formatés façon compteur pour garder les variations de prix/% lisibles.

Detected

Nouvelles opportunités. Les distances sont exprimées en distance à l’Entry. Les éléments passent automatiquement en In Position une fois remplis.

BTC

Entry $ 107,400.00 Target $ 108,600.00

Distance jusqu’à l’Entry

il y a 3 min +1.12%

In Position

Positions ouvertes. Les cartes affichent le prix actuel, le Target et la progression %. Vous voyez aussi une estimation du temps médian jusqu’à l’objectif basée sur l’historique.

XRP

Now $ 3.18 Target $ 3.20

Progression vers le Target

il y a 1 h 12 min +2.50%

Closed

Positions clôturées. Utile pour analyser la performance et les temps de détention médians.

ETH

Entry $ 3,700.00 Exit $ 3,820.00

Clôturée il y a 2 h (détention 7 h 22 min) +3.24%

Copier l’Entrée & la Sortie

Vous pouvez cliquer sur n’importe quel prix ou pourcentage sur les cartes pour copier la valeur numérique. Un petit message “Copied” apparaît près de votre curseur.

• Detected : copiez Entry, Target ou le potentiel en %.
• In Position : copiez Now, Target (Pro) ou le PnL actuel en %.
• Closed : copiez Entry, Exit ou le pourcentage réalisé.

Indicateurs de marché Expert

Market Indicators ajoutent du contexte autour de chaque opportunité. Ils vous aident à lire l’ambiance du marché en un coup d’œil — sans avoir besoin de bagage en trading.

Deux horizons de temps

• Court terme (1 minute) : capture les mouvements rapides et les réactions immédiates. Utile pour sentir si le momentum est en train de se construire en ce moment.
• Long terme (1 heure) : montre la direction générale et la stabilité de la tendance. Aide à éviter d’aller à contre-courant du mouvement principal.

Ce que nous regardons

• Volatilité (ATR) : indique si le prix évolue calmement ou de façon turbulente. Une volatilité plus élevée signifie des mouvements plus larges ; plus faible signifie des mouvements plus lisses.
• Bollinger Bands : met en évidence quand le prix est étiré vers le haut ou vers le bas par rapport à sa moyenne récente. Proche de la bande supérieure = marché “chauffé” ; proche de la bande inférieure = marché “plus calme”.
• RSI (momentum) : équilibre les gains et pertes récents pour identifier quand un mouvement paraît exagéré ou quand la force revient.
• MACD (énergie de tendance) : compare le momentum court terme et long terme pour voir si une tendance gagne ou perd en cohérence.
• Position journalière : situe le prix actuel dans la fourchette du jour (plus haut / plus bas) — vers le haut, le milieu ou le bas de la journée.
• Comportement du volume : compare l’activité actuelle aux niveaux habituels. Un pic soudain peut signaler une forte arrivée d’intérêt (ou de panique) sur le marché.
• Croisement de moyennes mobiles : vérifie simplement si les prix récents tirent au-dessus ou au-dessous de leur base plus longue.

Contexte de marché (Binance spot & futures)

Pour les paires liquides, nous lisons aussi le contexte environnant — utile pour juger à quel point l’environnement est “porteur” :

• Pression acheteuse/vendeuse : équilibre des ordres d’achat et de vente dans le carnet.
• Spread : distance entre meilleure offre (bid) et meilleure demande (ask) — plus il est serré, plus le marché est sain en général.
• Murs de liquidité : ordres anormalement gros pouvant ralentir ou accélérer le mouvement de prix.
• Crowding & funding (futures) : quand un côté (longs/shorts) domine et que les taux de funding sont extrêmes, les mouvements peuvent exagérer puis se retourner brutalement.
• Mouvements court terme : amplitude des variations sur les 1–5 dernières minutes et comparaison du volume récent versus le “normal”.

Disponibilité : les Market Indicators sont inclus dans l’offre Expert.

Le Dashboard vous donne une vue d’ensemble de la performance et de l’activité sur une fenêtre sélectionnable (7d sur Free ; 24h / 7d / 30d sur Pro). Il s’appuie sur un flux temps réel et agrège les métriques dans des blocs simples à comparer.

KPIs

• Avg PnL (Période) : résultat moyen en % sur les positions clôturées dans la période choisie. Les valeurs négatives sont affichées en rouge ; les positives en vert.
• Avg hold (Période) : temps médian jusqu’à l’objectif pour les positions clôturées dans la période (secondes → texte lisible).
• Top performer (Période) : meilleur actif par PnL moyen sur la période (icône + code + %).
• Most active (Période) : actif ayant le plus de signaux d’entrée dans la période (icône + code + nombre).

Rail de cycle de vie

Le rail résume le cycle de vie des positions en trois blocs :

• Detected : nouveaux signaux d’entrée détectés dans la période sélectionnée.
• In Position : positions actuellement ouvertes et suivies vers leurs objectifs.
• Closed : sorties clôturées dans la période sélectionnée.

De petites flèches animées indiquent le “flux” (en respectant le paramètre prefers-reduced-motion).

Graphique de performance

Un graphique en lignes avec deux axes :

• Avg PnL (%) par tranche (axe de gauche).
• Closed (nombre) par tranche (axe de droite).

La granularité des tranches s’adapte : horaire sur 24h, journalière sur 7d/30d. L’axe Y est auto-ajusté avec une marge pour garder les variations lisibles.

Pulse d’activité

Un graphique en barres des signaux d’entrée par tranche sur la même fenêtre. Utile pour repérer les périodes calmes vs celles plus “chaudes”.

Meilleurs performeurs (Période)

Classe les actifs par PnL moyen réalisé dans la période sélectionnée, en affichant :

• Actif : icône + code.
• Avg % : PnL moyen réalisé (coloré selon le signe).
• Exits : nombre de positions clôturées prises en compte.
• Dernière sortie : temps relatif depuis la sortie la plus récente.

Un clic sur une ligne ouvre l’actif dans Monitoring avec la période pré-sélectionnée.

Les plus actifs (Période)

Classe les actifs par nombre de signaux d’entrée sur la période. Colonnes :

• Actif (icône + code)
• Signaux d’entrée (compte)
• Dernier signal (temps relatif)

Les lignes sont cliquables et vous amènent sur Monitoring pour une analyse détaillée.

Clés API (création & gestion)

Disponibilité : l’accès API est réservé à l’offre Expert. Gérez vos clés sur Settings → API Keys.

1. Créez une clé : cliquez sur Create Key et, si vous le souhaitez, ajoutez un libellé (par ex. “Prod bot”). La clé complète est affichée une seule fois — copiez-la immédiatement ; nous ne conservons qu’un hash SHA-256.
2. Utilisez-la : envoyez la clé avec chaque requête via Authorization: Bearer <API_KEY> (ou X-API-Key).
3. Désactiver / Réactiver : suspendez temporairement le trafic sur une clé sans la supprimer. Pratique pour la maintenance ou la gestion d’incidents.
4. Supprimer : retire définitivement la clé. Vous ne pourrez pas la récupérer ; créez-en une nouvelle si nécessaire (rotation de clé).
5. Quota & utilisation : les requêtes et le volume sont suivis par jour et par clé. Les abus déclenchent un throttling.

Authentification

Envoyez votre clé API via Authorization: Bearer <API_KEY> (recommandé) ou X-API-Key. Tous les endpoints exigent HTTPS et une clé valide. L’usage est suivi par clé et par jour.

Copycurl -sS "https://nuxvision.com/api/v1/orders.php?limit=1" \
  -H "Authorization: Bearer YOUR_API_KEY" | jq .

REST — GET /api/v1/orders.php

Retourne une liste JSON d’ordres. La sortie est normalisée :
Conservés / renommés : entry (depuis price), exit (depuis sell_price), profit (depuis profit_percentage)
Masqués : quantity, potential_profit, opportunity_signal

Copycurl -sS "https://nuxvision.com/api/v1/orders.php?pair_symbol=USDT_EUL&status=completed&min_profit_percentage=2&limit=5&sort=newest&fields=id,pair_symbol,entry,exit,profit,created_at,completed_at" \
  -H "Authorization: Bearer YOUR_API_KEY" | jq .

SSE — GET /api/v1/orders_stream.php

Flux temps réel des ordres correspondant à vos filtres. Le serveur envoie des paquets avec event: detected et un tableau JSON dans data:. La connexion dure ~60 s ; le client doit se reconnecter (le serveur recommande retry: 2000).

Copycurl -N "https://nuxvision.com/api/v1/orders_stream.php?status=pending&order_type=buy&fields=id,pair_symbol,entry,profit" \
  -H "Accept: text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY"

Copy# resume after last seen id=7990
curl -N "https://nuxvision.com/api/v1/orders_stream.php?since_id=7990&status=pending&order_type=buy" \
  -H "Accept: text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY"

Outils CLI

Deux scripts CLI sont fournis pour plus de confort :

• /opt/nuxvision_monitoring_cli.php — client REST (filtres, tri, export CSV/NDJSON, fields)
• /opt/nuxvision_monitoring_sse.php — client SSE (reprise avec état, export CSV/NDJSON, affichage par paquets)

Copyphp /opt/nuxvision_monitoring_cli.php \
  --api-key=YOUR_API_KEY \
  --pair=USDT_EUL \
  --status=completed \
  --min-profit=2 \
  --limit=20 \
  --csv=/opt/orders_report.csv \
  --fields=id,pair_symbol,order_type,status,entry,exit,profit,created_at,completed_at

Copyphp /opt/nuxvision_monitoring_sse.php \
  --api-key=YOUR_API_KEY \
  --status=pending --type=buy \
  --state=/tmp/nux_sse.state \
  --csv=/opt/stream.csv \
  --fields=id,pair_symbol,status,entry,exit,profit,created_at

Warning: Undefined array key "source_title" in /var/www/html/docs.php on line 919

Copy<?php
/**
 * /opt/nuxvision_monitoring_cli.php — REST client for NuxVision /api/v1/orders.php
 *
 * Examples:
 *  php nuxvision_monitoring_cli.php --api-key=YOUR_API_KEY --pair=USDT_EUL --status=completed --min-profit=2 --limit=5
 *  php nuxvision_monitoring_cli.php --status=pending --watch --interval=5 --ndjson=/opt/pending.ndjson
 *  php nuxvision_monitoring_cli.php --since=2025-11-08T20:00:00Z --csv=/opt/orders_24h.csv
 *
 * Auth:
 *  export NUXVISION_API_KEY=YOUR_API_KEY   # or pass --api-key
 */

Copy<?php
/**
 * /opt/nuxvision_monitoring_sse.php — SSE client for /api/v1/orders_stream.php
 *
 * Examples:
 *  php nuxvision_monitoring_sse.php --api-key=YOUR_API_KEY --status=pending --type=buy --fields=id,pair_symbol,entry,profit
 *  php nuxvision_monitoring_sse.php --state=/tmp/nux_sse.state --csv=/opt/stream.csv --ndjson=/opt/stream.ndjson
 *
 * Auth:
 *  export NUXVISION_API_KEY=YOUR_API_KEY   # or pass --api-key
 */

• Streaming : les pages utilisent Server-Sent Events (SSE) pour des mises à jour quasi temps réel.
• Priorité : l’offre Pro bénéficie d’une priorité de rafraîchissement plus élevée et de fenêtres de retry/backoff plus serrées.
• UI : les barres de progression sont animées en douceur ; les compteurs utilisent un formatage type “odometer” pour plus de lisibilité.
• Activité : un menu cloche liste les événements récents du cycle de vie ; sur Free, certains détails sont floutés.

• Detected : entrées potentielles repérées par des heuristiques/statistiques.
• In Position : position ouverte suivie jusqu’à son objectif.
• Closed : position clôturée ; le PnL réalisé est connu.
• Target : prix prévu pour la prise de profit.
• Distance to Entry : proximité du prix courant avec l’Entry (barre plus haute = plus proche).
• Progress to Target : % du chemin parcouru entre l’Entry et le Target.
• Median time to target : temps de détention typique pour des configurations similaires.

• Analytics en lecture seule : Monitoring et Dashboard sont purement informatifs ; aucun ordre de trading n’est exécuté.
• Icônes & métadonnées : les icônes et noms des coins proviennent d’assets statiques ou de caches internes.
• Sécurité de session : sessions signées avec vérifications périodiques ; les conflits déclenchent une reconnexion sécurisée.
• Exports : l’export CSV (Pro) reflète la période et les filtres que vous avez sélectionnés.

Voir aussi la Politique de confidentialité et les Conditions d’utilisation.

• Favoris : cliquez sur l’étoile des cartes pour construire une watchlist rapide ; filtrez par favoris avec l’offre Pro.
• Recherche globale (Pro) : recherchez par symbole (ex. BTC) depuis la barre du haut.
• Info-bulles : survolez les libellés pour des explications sur les barres et les nombres (Entry/Target/Now, PnL, temps écoulé).
• Teasers (Free) : les pastilles “Pro” indiquent ce qui se débloque avec une montée en offre.

• Pas de mises à jour live ? Vérifiez votre connexion ; rechargez la page pour rétablir le flux SSE.
• Ctrl-C ne coupe pas curl ? Utilisez timeout 65s … ou le client SSE CLI (gère proprement SIGINT).
• Session perdue ? Vous serez redirigé vers la page de connexion ; reconnectez-vous pour restaurer le flux.
• Icônes manquantes ? Les assets statiques basculent sur un fallback ; les icônes cassées sont retirées automatiquement.

• Gérez votre offre depuis Facturation (upgrade, annulation, factures).
• Tous les prix sont affichés hors TVA ; la TVA est appliquée au paiement lorsque nécessaire.
• L’offre annuelle inclut “3 mois offerts” (facturation unique à l’avance).

NuxVision exécute-t-il des ordres ?
Non. C’est uniquement de l’analytique. Vous restez entièrement responsable de vos actions.

Ai-je besoin d’une clé API d’exchange ?
Non. Vous pouvez utiliser NuxVision sans connecter aucun exchange.

Comment les “targets” et le PnL sont-ils calculés ?
Les signaux sont classés selon leur comportement historique. Les métriques de PnL reflètent des points d’entrée/sortie simulés, pas votre portefeuille personnel.

Quel est le pricing ?
Commencez gratuitement. L’offre Pro ajoute une priorité de rafraîchissement plus élevée, plus d’historique et davantage de données au fur et à mesure de leur déploiement.

Besoin d’aide ou envie de signaler un problème ? Rendez-vous sur Support ou envoyez-nous un email depuis l’adresse liée à votre compte.