User Guide

Overview

Solnexus is a DeFi analytics command centre built on live Solana on-chain data. It aggregates protocol-level metrics from Raydium, Orca, Meteora, Kamino, Phoenix, and more, cross-references them against curated "smart money" wallet cohorts (sharks and whales), and surfaces actionable signals — without you needing to query a single on-chain account directly.

What you can do on Solnexus:

• Track real-time pool performance, APR, TVL, and fee revenue across every major Solana DEX.
• Monitor institutional-grade wallets (sharks and whales) to see where smart money is moving.
• Place predictions on market outcomes and compete on the global leaderboard.
• Swap tokens via Jupiter with embedded best-price routing.
• Receive live alerts via email or WhatsApp when notable on-chain events occur.
• Pro users: access all data programmatically via the REST API using personal API keys.

Logging In

Solnexus uses wallet-based authentication — there is no username or password.

1. Navigate to the Solnexus homepage and click Login in the navbar.
2. Your wallet will be prompted to sign a one-time message (a nonce). This proves ownership of the address without exposing your private key or making any on-chain transaction.
3. Once verified, your session is established. Your tier is resolved automatically from your subscription status.
4. Pro and Overmind subscribers unlock smart money wallet tracking, full PnL data, predictions, custom alerts, and API key access.

Session timeout: For security, inactive sessions expire after 60 minutes. You will be redirected to the login page automatically.

Supported wallets: Any Ed25519-compatible Solana wallet — Phantom, Backpack, Solflare, or Ledger via Phantom.

Dashboard

The dashboard is the main analytical surface. It is divided into three vertical sections:

Pool Analytics

All charts in this section pull data aggregated across every tracked protocol. Use the Download CSV button under any chart to export the underlying dataset.

Wallet Analytics (Smart Money)

Two wallet cohorts are tracked:

• Sharks — Wallets $10k–$500k AUM. Nimble, often early to new opportunities.
• Whales — Wallets $500k+ AUM. Slower to move but signal high-conviction positioning.

Live Operations

Key Charts Explained

Opportunity Score

Opportunity Score = APR × log₁₀(TVL + 1)

This formula rewards high APR but penalises illiquid pools. A pool with 900% APR but $5k TVL scores poorly. A pool with 45% APR and $12M TVL scores highly.

Tier Token Divergence

Computed from the top 50 holdings per tier. For each token:

• Red bar — % of the Shark tier's total portfolio in that token
• Green bar — % of the Whale tier's total portfolio in that token

A token where sharks have 12% allocation and whales 1% is a speculative pick without institutional buy-in. Watch it — if whales move, momentum follows.

Prediction Markets

Prediction Markets let you stake SOL on the outcome of on-chain and macro events. Winnings are distributed proportionally to correct predictors from the losing pool.

1. Navigate to Prediction Markets in the navbar.
2. Accept the Prediction Market Terms and confirm your jurisdiction eligibility.
3. Connect your wallet via the picker modal (Phantom, Backpack, or Solflare).
4. Browse the market grid and click a card to place your prediction.
5. Review the question, resolution date, and current odds, then enter your stake in SOL.
6. Confirm the on-chain transaction in your wallet.

Markets resolve automatically on-chain or via oracle feed. Winnings are claimable from the Portfolio tab within 10 minutes of resolution. In the event of a null or disputed resolution, stakes are returned in full minus gas.

Jupiter Swap

The Swap page is powered by Jupiter — Solana's leading DEX aggregator — and routes swaps across all available liquidity sources for best price.

1. Navigate to Swap in the navbar and connect your wallet.
2. Select input and output tokens and enter the amount. Estimated output and price impact are shown.
3. Adjust slippage tolerance if needed (default: 0.5%).
4. Click Swap and confirm in your wallet.

Swaps are executed on-chain and irreversible. Always verify the output amount before confirming.

Live Alerts

Solnexus can notify you when tracked conditions are met. From the dashboard, scroll to Live Operations and click Manage Alerts. Choose a condition type:

• TVL Threshold — alert when a pool's TVL moves by X%.
• Volume Spike — alert when a pool's 1h volume exceeds Y SOL.
• Wallet Movement — alert when a tracked shark or whale moves above Z SOL.

Select a notification channel:

• Email — enter and verify your email address.
• WhatsApp — enter your number in international format (e.g. +1234567890) and verify via OTP.

Alerts fire within the next polling cycle (typically under 5 minutes). From the alerts panel you can pause, edit, or delete any active alert.

Tier System

Navigate to Pricing to view current prices and upgrade. Waitlist cohorts can lock early-access Pro pricing at 0.1 SOL where offered.

Pro API

Pro and Overmind subscribers have access to a REST API for programmatic access to all Solnexus data. All endpoints are under /api/v1/.

Authentication

Two auth methods are supported — use whichever fits your context:

1. Session (browser users)
If you are already logged in via your wallet, session-authenticated requests to /api/v1/ work automatically — no extra header needed.

2. API Key (programmatic access)
Include your key in the Authorization header:

Authorization: Bearer snx_<your_key_here>

API keys are tied to your wallet's subscription status. If your subscription lapses, the key stops working until renewed.

Managing Your API Key

Example — issue a key (browser session):

curl -X POST https://solnexus.io/api/v1/keys/issue \
  -H "Cookie: session=<your_session_cookie>"

Response:

{
  "status": "ok",
  "api_key": "snx_AbCdEf...",
  "message": "Store this key securely — it will not be shown again.",
  "auth_header": "Authorization: Bearer snx_AbCdEf..."
}

Example — use the key:

curl https://solnexus.io/api/v1/smart-money/holdings \
  -H "Authorization: Bearer snx_AbCdEf..."

Endpoint Reference

Smart Money

Wallet PnL

Alerts & Signals

Prediction Markets API

Prediction markets are available via Pro API. Write actions require terms acceptance and jurisdiction confirmation first.

Terms acceptance payload:

{
  "accepted": true,
  "jurisdiction_confirmed": true,
  "policy_version": "2026-03-21"
}

Place prediction payload:

{
  "market_id": "<market_id>",
  "predicted_outcome": "0",
  "amount_wagered": 1000000000,
  "tx_hash": "mock_123"
}

Prediction Markets API Quickstart

Set your key and base URL once:

export BASE_URL="https://solnexus.io"
export API_KEY="snx_your_key_here"

1) Get terms policy version

curl "$BASE_URL/api/v1/prediction-markets/compliance/terms-policy" \
  -H "Authorization: Bearer $API_KEY"

2) Accept terms

curl -X POST "$BASE_URL/api/v1/prediction-markets/compliance/terms-acceptance" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accepted": true,
    "jurisdiction_confirmed": true,
    "policy_version": "2026-03-21"
  }'

3) List active markets

curl "$BASE_URL/api/v1/prediction-markets?limit=20" \
  -H "Authorization: Bearer $API_KEY"

4) Place a prediction

curl -X POST "$BASE_URL/api/v1/predictions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "market_id": "<market_id>",
    "predicted_outcome": "0",
    "amount_wagered": 1000000000,
    "tx_hash": "mock_123"
  }'

Response Format

All endpoints return JSON. Successful responses always include "status": "ok". Errors return a JSON body with an "error" key and an appropriate HTTP status code.

// Success
{ "status": "ok", "data": { ... } }

// Pro tier required
{ "error": "Pro subscription required.", "upgrade_url": "/pricing" }

// Not found
{ "error": "Wallet not found in tracked smart-money set." }

Rate Limits

API keys share the rate limits of their tier. Most snapshots update every 15–30 minutes — cache responses on your side to avoid unnecessary calls. Excessive burst traffic may result in temporary throttling.

Data Freshness

All times are UTC. Data timestamps are shown in the footer of each chart card where applicable.

FAQ

Why does my chart show "No data available"?

The underlying API has not returned data for that metric yet. This usually resolves on the next data refresh cycle. If it persists beyond 30 minutes, try a hard refresh (Cmd+Shift+R / Ctrl+Shift+R).

My wallet shows as detected but fails to connect. What do I do?

Ensure your wallet extension is unlocked (enter your password in the extension popup). If Phantom and Backpack are both installed, disable one temporarily — extension conflicts can block the connection request.

Can I use a hardware wallet (Ledger)?

Yes. Ledger is supported via Phantom's Ledger integration. Connect Ledger to Phantom first, then select Phantom from the Solnexus wallet picker.

How is the smart money wallet list curated?

Shark and whale wallets are selected through on-chain heuristics (consistent yield-generating activity, protocol interaction patterns) and periodic manual review. Wallets are anonymised — no personal data is associated with any address.

What happens if a prediction market resolves in a draw or is disputed?

Stakes are returned in full to all participants minus the protocol gas fee. Disputed resolutions are escalated to the Solnexus oracle committee within 24 hours.

Is my wallet private key ever accessed?

No. Solnexus only reads your wallet's public key and requests a signature through your wallet extension. Private keys remain exclusively in your wallet at all times.

My alert fired but I don't see the notification. What should I check?

For email: check your spam folder and ensure alerts@solnexus.io is whitelisted. For WhatsApp: confirm your number is in international format and that you have not blocked the alerting number.

How do I cancel my Pro or Overmind subscription?

Navigate to Pricing → Manage Subscription and follow the cancellation flow. Your access remains active until the end of the current billing period.

My API key stopped working. Why?

API keys are deactivated when the associated subscription lapses. Check /api/v1/me for your current tier and subscription status. Renew your subscription and the key will work again immediately.

Solnexus documentation · March 2026 · solnexus.io