Documentation

Nexora Usage Guide

Complete guide to understand Nexora architecture, data flow, decision logic, and how to operate the dashboard APIs.

1) What Nexora Does

Fetches live market signals from CoinGecko, Fear & Greed, and Polymarket.
Builds normalized signal objects (direction + strength + note).
Runs weighted decision logic to produce BUY / SELL / HOLD / NO_ACTION.
Supports execution timeline for paper mode and onchain queue mode.
Shows source health, latency, strategy settings, and portfolio simulation.

2) Core Dashboard Areas

Live Signal Feed
Displays real-time signals with direction and strength.

Decision Engine
Latest action, score, confidence, and reason.

Strategy Builder
Adjust thresholds and confidence gates.

Execution & Portfolio
Paper performance and action log.

3) API Endpoints

GET /api/health — Service health check.

GET /api/signals — Current signals.

GET /api/signals?refresh=1 — Force live refresh.

GET /api/decisions — Decision history.

POST /api/decisions/evaluate — Run new decision cycle.

POST /api/actions/execute — Execute current decision (paper/onchain queue).

GET /api/state — Market, source health, settings, portfolio, execution log.

GET/PUT /api/settings — Read/update strategy settings.

GET /api/crypto/markets — Ranked top-50 crypto recommendations.

4) Example API Usage

# 1) refresh signals
curl -s https://nexoraonchain.online/api/signals?refresh=1 | jq .

# 2) evaluate decision
curl -s -X POST https://nexoraonchain.online/api/decisions/evaluate | jq .

# 3) execute in paper mode
curl -s -X POST https://nexoraonchain.online/api/actions/execute   -H 'content-type: application/json'   -d '{"mode":"paper"}' | jq .

5) Strategy Settings Meaning

buyThreshold: minimum score needed to emit BUY.
sellThreshold: maximum score (negative) to emit SELL.
minConfidence: confidence gate before any action is allowed.
cooldownMinutes: waiting period between actions (next phase use).
maxPositionEth: paper position cap.

6) Notes & Limitations

Onchain mode is currently queue simulation unless signer/executor is wired.
Data source outages may degrade decision quality; monitor Source Health panel.
This project is educational/operational tooling, not financial advice.