NuxVision Documentation

NuxVision is a read-only market dashboard: it observes crypto markets, detects opportunities, and visualises them for you. It never places trades — you stay fully in control, whether you’re a beginner or an experienced trader.

1. Log in and check your plan
   Sign in from the main site. Your current plan (Free / Pro / Expert) appears in the top bar. It controls how far back you can look and how many signals you see in realtime. You can change it anytime from Billing.
2. Open Monitoring to see live signals
   Open Monitoring. The board is organised into the lifecycle rail: Detected → In Position → Closed.
   • Detected: a new opportunity has been spotted.
   • In Position: the simulated trade is “open” and moving toward a target.
   • Closed: the simulated trade is finished; the result is known.
3. Learn the basic terms (no trading background required)
   You’ll encounter a few key terms:
   • Entry: the price where the simulated trade starts.
   • Target: the price where the simulated trade aims to take profit.
   • PnL: “Profit and Loss” — the % gain or loss on that simulated trade.
   • Distance / Progress: visual bars showing how close we are to Entry or Target.
   Experienced traders can interpret these metrics directly; beginners can rely on the simple visual cues.
4. Use the Dashboard to understand the bigger picture
   The Dashboard provides an overview of recent behaviour:
   • Avg PnL: average result of closed simulated trades for the selected timeframe.
   • Holding time: how long trades typically stay “In Position”.
   • Top performers & most active assets: quickly identify which coins have been moving the most.
   It’s useful whether you just want a market snapshot or you’re analysing conditions for a trading strategy.
5. Focus on your own watchlist
   Star the assets that matter to you and, on Pro/Expert plans, use filters and Global search to refine your view. You can copy any price or % in one click for use in your own tools or exchange.
6. (Optional — for developers & quants) Connect via API
   On the Expert plan, you can create an API key in Settings → API Keys and query /api/v1/orders.php or /api/v1/orders_stream.php. This lets you integrate the same normalised data into your own bots, dashboards, or quantitative scripts.

Monitoring is split into three columns: Detected, In Position, and Closed. Each card shows prices, a progress bar, and timing info. Here are example cards showing how Detected, In Position, and Closed trades look in real-time.

• Detected: we show the smallest potential on Free; Pro unlocks all detections in realtime.
• In Position: progress to target with ETA; top 3 shown on Free, full list on Pro.
• Closed: all past trades (Free & Pro) with realised % and timestamps.
• Numbers: odometer-style formatting keeps price/% changes readable.

Detected

New opportunities. Distances are expressed as to Entry. Items transition automatically to In Position once filled.

BTC

Entry $ 107,400.00 Target $ 108,600.00

Distance to Entry

3 min ago +1.12%

In Position

Open trades. Cards show current price, Target, and progress %. You’ll also see a median time-to-target estimate based on historicals.

XRP

Now $ 3.18 Target $ 3.20

Progress to Target

1 h 12 min ago +2.50%

Closed

Completed exits. Useful to review performance and median holding times.

ETH

Entry $ 3,700.00 Exit $ 3,820.00

Closed 2 h ago (held 7 h 22 min) +3.24%

Copy Entry & Exit

You can click on any price or % on cards to copy the numeric value. A small “Copied” hint appears near your cursor.

• Detected: copy Entry, Target, or potential %.
• In Position: copy Now, Target (Pro), or current PnL %.
• Closed: copy Entry, Exit, or realised %.

Market Indicators Expert

Market Indicators give extra context around each opportunity. They help you read the market’s mood at a glance — no trading background required.

Two time horizons

• Short-term (1 minute): captures rapid moves and immediate reactions. Useful to feel if momentum is building right now.
• Long-term (1 hour): shows the broader direction and stability of the trend. Helpful to avoid going against the bigger picture.

What we look at

• Volatility (ATR): shows whether price action is calm or turbulent. Higher volatility means larger swings; lower volatility means smoother moves.
• Bollinger Bands: highlights when price is stretched high or low relative to its recent average. Near the upper band = heat; near the lower band = chill.
• RSI (momentum): balances recent gains and losses to spot when a move looks overextended or when strength is returning.
• MACD (trend energy): compares short vs long momentum to see if a trend is gaining or losing consistency.
• Daily position: shows where the current price sits between today’s high and low — near the top, middle, or bottom of the day’s range.
• Volume behavior: compares current activity to typical levels. Sudden spikes can signal strong interest (or panic) entering the market.
• Moving average crossover: a simple health check on whether recent prices are pulling above or below their longer baseline.

Market context (Binance spot & futures)

For liquid pairs, we also read the surrounding context — useful to judge how “supportive” the environment is:

• Buy/Sell pressure: balance between bids and asks in the order book.
• Spread: distance between best bid and best ask — tighter is usually healthier.
• Liquidity walls: unusually large orders that can slow or accelerate price.
• Crowding & funding (futures): when one side (longs/shorts) dominates and paying rates are skewed, moves may overshoot and snap back.
• Short-term swings: how much price has moved over the last 1–5 minutes, and whether the latest volume is a “spike” vs normal.

Availability: Market Indicators are included in the Expert plan.

The Dashboard gives you an overview of performance and activity over a selectable window (7d on Free; 24h / 7d / 30d on Pro). It reads a realtime stream and aggregates metrics into simple, comparable blocks.

KPIs

• Avg PnL (Range): average realised % across closed positions within the selected range. Negative values are tinted red; positive green.
• Avg hold (Range): median time-to-target across closed positions in range (seconds → humanized).
• Top performer (Range): best asset by average PnL in range (icon + code + %).
• Most active (Range): asset with most entry signals in range (icon + code + count).

Lifecycle rail

The rail summarizes the trading lifecycle in three blocks:

• Detected: new entry signals detected in the selected range.
• In Position: currently-open positions being tracked to their targets.
• Closed: completed exits within the selected range.

Arrows subtly animate to indicate “flow” (respects prefers-reduced-motion).

Performance chart

A dual-axis line chart plotting:

• Avg PnL (%) per bucket (left axis).
• Closed (count) per bucket (right axis).

Bucket granularity adapts: hourly in 24h, daily in 7d/30d. The Y-range auto-scales with padding to keep variations readable.

Activity pulse

A bar chart of entry detections per bucket over the same window. Useful to spot quiet vs hot periods.

Top performers (Range)

Ranks assets by average realised PnL within the selected range, showing:

• Asset: icon + code.
• Avg %: average realised PnL (colored by sign).
• Exits: number of closed positions considered in the average.
• Last exit: relative timestamp since the most recent exit.

Click any row to open the asset in Monitoring with the range pre-selected.

Most active (Range)

Ranks assets by entry signals in the selected range. Columns:

• Asset (icon + code)
• Entry signals (count)
• Last signal (relative time)

Rows are clickable and take you to Monitoring for a deeper dive.

API Keys (create & manage)

Availability: API access is exclusive to the Expert plan. Manage your keys at Settings → API Keys.

1. Create a key: Click Create Key and optionally set a label (e.g., “Prod bot”). The full key is shown once — copy it now; we only store a SHA-256 hash.
2. Use it: Send the key with each request via Authorization: Bearer <API_KEY> (or X-API-Key).
3. Disable / Enable: Temporarily stop traffic on a key without deleting it. Useful for incidents or maintenance.
4. Delete: Permanently removes the key. You can’t recover it; create a new one if needed (key rotation).
5. Quota & usage: Requests and bytes are tracked per day and per key. Abuse triggers throttling.

Authentication

Send your API key via Authorization: Bearer <API_KEY> (preferred) or X-API-Key. All endpoints require HTTPS and a valid key. Usage is tracked per key/day.

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

REST — GET /api/v1/orders.php

Returns a JSON list of orders. Output is normalized:
Kept/renamed: entry (from price), exit (from sell_price), profit (from profit_percentage)
Hidden: 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

Realtime stream of orders that match your filters. Emits batches with event: detected and JSON array in data:. Connection lasts ~60s; clients should reconnect (server advises 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"

CLI tools

Two CLI scripts are provided for convenience:

• /opt/nuxvision_monitoring_cli.php — REST client (filters, sort, CSV/NDJSON export, fields)
• /opt/nuxvision_monitoring_sse.php — SSE client (resume with state, CSV/NDJSON export, prints batches)

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 932

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: pages use Server-Sent Events (SSE) for near-realtime updates.
• Priority: Pro has higher refresh priority and tighter retry/backoff windows.
• UI: progress bars animate smoothly; counters use odometer formatting for readability.
• Activity: a bell menu lists recent lifecycle events; Free blurs details.

• Detected: potential entries spotted by heuristics/statistics.
• In Position: open trade being tracked to its target.
• Closed: position exited; realised PnL is known.
• Target: planned take-profit price.
• Distance to Entry: proximity of current price to entry (higher bar = closer).
• Progress to Target: % of path covered from entry to target.
• Median time to target: typical holding time for similar setups.

• Read-only analytics: Monitoring and Dashboard are informational; no trading is executed.
• Icons & metadata: coin icons and names are loaded from static assets or caches.
• Session security: signed sessions with periodic guard pings; conflicts trigger a safe re-login.
• Exports: CSV export (Pro) reflects your selected range and filters.

See also Privacy Policy and Terms.

• Favorites: click the star on cards to build a quick watchlist; filter favorites on Pro.
• Global search (Pro): search by symbol (e.g., BTC) from the top bar.
• Tooltips: hover labels explain bars and numbers (Entry/Target/Now, PnL, time since).
• Teasers (Free): “Pro” pills indicate what unlocks with upgrade.

• No live updates? Check connectivity; reload the page to re-establish SSE.
• Ctrl-C doesn’t stop curl? Use timeout 65s … or the SSE CLI (handles SIGINT cleanly).
• Session lost? You’ll be redirected to login; sign back in to restore your stream.
• Icons missing? Static assets will fallback; broken icons are removed automatically.

• Manage your plan on Billing (upgrade, cancel, invoices).
• All prices are shown excluding VAT; VAT is applied at checkout when required.
• Annual plan includes “3 months free” (billed once upfront).

Does NuxVision execute trades?
No. It’s analytics only. You stay fully in control of any actions you take.

Do I need an exchange API key?
No. You can use NuxVision without connecting an exchange.

How are “targets” and PnL computed?
Signals are ranked by historical behavior. PnL metrics reflect simulated entry/exit points, not your personal wallet.

What’s the pricing?
Start free. Pro adds higher refresh priority, longer history, and data as they roll out.

Need help or want to report an issue? Visit Support or email us from your account email.