NightWatch v1.0 — Liquidity Intelligence Platform

Real-time CEX & on-chain liquidity assessment, crisis monitoring, and decentralized market infrastructure

1. What is NightWatch?

NightWatch is a real-time liquidity intelligence platform that evaluates and monitors token liquidity across multiple centralized exchanges — Gate.io, MEXC, KuCoin, Bitget, Binance, OKX, Bybit, Coinbase, Upbit, and Bithumb. Using high-frequency randomized sampling designed to resist manipulation (spoofing, layering, wash trading, pump-and-dump), the platform produces transparent liquidity grades (A through F) and risk assessments for thousands of trading pairs.

The core thesis: most tokens are listed on exchanges but lack any meaningful post-listing utility or market infrastructure. NightWatch transforms raw exchange data into actionable intelligence — grading liquidity health, detecting micro-structural anomalies, and providing the foundation for a new class of decentralized market services.

2. Crisis Board (Current — Live)

The Crisis Board is the operational center of NightWatch v1.0. It surfaces the most critical liquidity data across all monitored exchanges in a single, real-time interface.

StatsBox — Real-time market overview displaying total tokens monitored (~6,400+), crisis board count (~989), priority pool tokens, and a chain distribution treemap visualizing cross-chain coverage.
Priority Pool Snapshot — Top priority-monitored tokens with real-time grades and MicroBurst detection. Each card shows the current grade, outlook status (Positive / Stable / Constrained / Distressed / Critical), 1-minute scan status, MicroBurst detection status, and cherry mining availability.
Token Search — Search all 6,400+ scanned tokens across 4 exchanges. Any token can be requested for Priority Pool monitoring, enabling 1-minute interval tracking.
Full Board — Complete crisis token list with operational flags: ST, Assessment Zone, Innovation Zone, Suspended, Immediate Action, Urgent Support, New Entry, Repeat Re-entry, Micro_Burst, and Bottom 2%.
Data Lab (Cherry Mining) — Metadata completion tracking. Community members earn cherry points by contributing verified on-chain metadata — chain identification, contract addresses, explorer URLs, holder data, exchange wallets, official channels, and dApp URLs.
Maker Space — Contract deployment hub providing access to Garrison Staking, Nano Optimistic Oracle, Arbitrage Funds, Lending, Badges/POAP, and T2T LaunchPad.

3. Data Pipeline & Reliability

NightWatch's scanning architecture is designed for reliability, breadth, and manipulation resistance across every layer.

Regular Scan (2h cycle) — Full market scan across 4 exchanges every 2 hours. Randomized sampling windows prevent gaming by market makers and wash-trade operators.
Priority 1m Scan — 1-minute interval monitoring for Priority Pool tokens, providing near real-time orderbook depth, spread tracking, and volume analysis.
MicroBurst Detection — High-frequency orderbook analysis detecting structural anomalies including quote persistence, concentration (HHI), bid/ask imbalance, layering gaps, and touch-flip patterns.
7-day TWA Grading — Time-weighted average grades calculated over a 7-day rolling window produce stable, manipulation-resistant assessments that smooth out transient volatility.
Worker Architecture — The scan_coordinator orchestrates all scan types with automatic retry logic, heartbeat monitoring, and stale-lock recovery ensuring continuous uptime.

4. Research v1 (Per-Token Deep Dive)

Each token has a dedicated research page providing comprehensive liquidity intelligence and historical analysis.

Liquidity grade history — 21-day timeseries at 2-hour resolution
Priority 1m timeseries — 72-hour granular data for subscribed tokens
MicroBurst metrics — quote persistence, HHI concentration, imbalance, layering gap, and touch-flip indicators
On-chain delta tracking — holder count changes and whale movement detection
PDF report generation for offline analysis and sharing
Subscription and target management per token

REST API Endpoints

GET/research/pair?exchange=X&symbol=Y&days=21

GET/tokens/{exchange}/{symbol}/timeseries/2h?days=21

GET/tokens/{exchange}/{symbol}/timeseries/1m?hours=72

GET/tokens/search?q=BAL&limit=20

5. Market Fit & Problem Statement

The gap NightWatch addresses is structural and growing. As token listings accelerate across centralized exchanges, the infrastructure to evaluate and support those tokens has not kept pace.

Thousands of tokens are listed with zero post-listing support or market-making accountability.
Exchange liquidity is fundamentally opaque — displayed orderbook quotes can be manipulated through spoofing, layering, and wash trading.
No standardized, independent liquidity rating system exists across the industry.
Market makers operate without transparent accountability or verifiable performance metrics.
Token communities have no independent tools to evaluate their token's real liquidity health.

NightWatch fills this gap with independent, manipulation-resistant assessment — turning opaque exchange data into transparent, actionable intelligence that serves token communities, investors, and market infrastructure builders alike.

6. Expansion Roadmap — Decentralized Market Infrastructure

Beyond monitoring, NightWatch v1.0 lays the groundwork for a full decentralized market infrastructure stack, where every component is backed by real liquidity data.

Cherry Token & Mining

Community-driven metadata enrichment where cherry points are earned for verified data contributions. On-chain reward distribution ensures quality validators are compensated proportionally to their accuracy and volume of contributions.

Nano Optimistic Oracle

A community oracle-based prediction market — similar in mechanism to Polymarket — built specifically for token health outcomes. Participants stake on liquidity predictions, grade changes, and delisting events. Dispute resolution follows an optimistic model with community validators adjudicating contested outcomes.

Relayer Network & Ombudsman

Relayers act as market ombudsmen — monitoring, reporting, and validating liquidity claims across exchanges. Reputation is tracked via POAP badges on-chain, creating a verifiable database of validator credibility that persists across the ecosystem.

Arbitrage Funds

Trust-based, Web2-compatible fund structures backed by on-chain reputation data. Validators with proven track records can participate in or manage arbitrage strategies using NightWatch liquidity intelligence as the foundation for informed decision-making.

T2T LaunchPad (Token-to-Token)

Tokens with verified liquidity grades become launchpad participants. New token launches are backed by real liquidity assessment rather than hype. Existing token communities stake their graded tokens to participate in new launches — creating a virtuous cycle where liquidity quality is the entry criterion.

Badges & POAP

An on-chain reputation database where every validator action, oracle participation, and mining contribution is recorded as a POAP badge. This creates portable, verifiable reputation that participants carry across the NightWatch ecosystem and beyond.

Lending

Liquidity-grade-based lending protocols where tokens with higher NightWatch grades receive better collateral ratios. This creates a direct financial incentive for token projects and market makers to maintain healthy, transparent liquidity.

7. CrisisBulletin — User Guide

CrisisBulletin is the operational frontend of NightWatch v1.0. This section covers login, subscriptions, payment, the Crisis Board interface, target pair management, reports, alerts, and Cherry Mining.

7.1 Getting Started — Login

CrisisBulletin uses wallet-based authentication. No email or password registration is required.

Wallet

Chain

Detection

MetaMask

EVM (Ethereum, Polygon, BSC, Arbitrum, Base, Klaytn, Gnosis, KONET)

Browser extension auto-detected

Phantom

Solana

Browser extension auto-detected

Visit CrisisBulletin at /crisis-bulletin or /landing
Click wallet connect button (top-right header)
Select wallet — MetaMask or Phantom auto-detected
Approve connection in wallet popup
Sign auth message — generates JWT bearer token
Done — wallet address appears in header

EVM Chain Switching: Switch between Ethereum, Polygon, BSC, Arbitrum One, Gnosis, Klaytn, Base, KONET after connecting.

Email Linking (Optional): /account → enter email → verify OTP. Session persists via browser local storage.

7.2 Subscription Plans

Four subscription tiers:

FreeFree

Crisis Bulletin — 2h public data cycle
Main Board delisting risk ratings
Public arbitrage signals (2-CEX)
Community Telegram alerts

Limitation: No priority scanning, No PDF reports, No API keys

Plus20 USDT/month or 10,000 Cherries

Everything in Free
Priority target registration (up to 5 tokens)
PDF research report per token
Personal API key (1,000 req/day)
Telegram grade-change alerts
On-chain activity tracking

Limitation: HF scanning excluded

Pro50 USDT/month or 25,000 Cherries

Everything in Plus
HF MicroBurst capture
Priority targets (up to 20 tokens)
Multi-CEX arbitrage signals (4 exchanges)
API access (10,000 req/day)
Dedicated support channel

EnterpriseContact sales (annual)

Everything in Pro
Unlimited priority targets
Unlimited API requests
Nano Oracle participation
White-label data pipeline
Dedicated infra & SLA
DAO governance

Term

Discount

1 month

3 months

10% off

6 months

20% off

12 months

40% off

Pro-rata credit: upgrading mid-subscription deducts remaining value from the new plan cost.

7.3 Payment

On-chain crypto payments via smart contract. Supported chains:

Chain

Accepted Tokens

Polygon

USDT, USDC, DAI, MATIC, POL

BSC

USDT, USDC, BUSD, BNB

Ethereum

USDT, USDC, DAI, ETH

Arbitrum

USDT, USDC, DAI, ETH

Solana

USDT, USDC, SOL

TON

USDT, TON

Konet

USDT, KONET

Payment Flow

Select plan from Account > Subscriptions tab
Choose term (1/3/6/12 months) — discount applied
Click Upgrade → redirected to /account/upgrade
Select chain and payment token
Confirm — EVM: wallet prompt for ERC-20 approval + payment contract; Manual chains: receive address + invoice ID
Payment indexer verifies and activates subscription

Cherry Payment: Plus = 10,000 Cherries/month, Pro = 25,000 Cherries/month via Account panel.

7.4 Crisis Board — Frontend Manual

Main page at /crisis-bulletin. Organized into the following sections:

Header

NightWatch logo — links to landing
Live indicator — green blinking dot
Wallet login — connect/disconnect, view address
Account summary — tier badge, cherry balance
Navigation — Ranger dropdown

Crisis Reels — 4 Lanes

Lane

Content

LDS

Inter-CEX Liquidity Default Swap — arbitrage pairs (>1% diff) across 4 CEX, identity-verified

New

New Crisis — tokens with deteriorating liquidity (entered within 14 days)

Critical

Critical Watchlist — bottom 2% by 7d GPA per exchange

Analysis

Research & Analysis — Priority Pool tokens, full-stack monitoring

LDS Filters: All | <10% | ACT (actionable inverted bid/ask) | >100sc (100+ scan hits in 14 days)

Controls: Speed buttons (0.5x–3x) per lane, right-click drag to scroll, hover to slow, ? tooltip for methodology.

StatsBox

Coverage Summary — USDT pairs, exchange count, crisis board tokens
Top Metrics — All pairs/exchanges, Board count, entered last N days, on-chain coverage
Grade Distribution — Crisis Board tab (A–F with sub-grades), Distribution tab, exchange filter, 72h Flow
Area Distribution — by Chain or Multi CEX listing count, grade filter, verification %
Chain Dominance Treemap — 91+ chains, hover/click, Others panel, full-screen

Priority Pool Snapshot & Token Search

Grid of top 20 priority tokens with grade, outlook, GPA, 1m status, MicroBurst, Cherry Mining
Search 6,400+ tokens, filter by exchange, request Priority Pool (login required)

Full Board

Complete crisis token list at /evm with flags: ST, Assessment Zone, Innovation Zone, Suspended, Immediate Action, Urgent Support, New Entry, Repeat Re-entry, Micro_Burst, Bottom 2%.

7.5 Target Pairs & Priority Pool

Priority Pool tokens receive 1-minute scanning, MicroBurst detection, PDF reports, and grade-change Telegram alerts.

Registering Targets

Search for a token in Crisis Board Token Search
Click Request Priority on the target token
Requirements: wallet connected + tier (Plus: 5, Pro: 20, Enterprise: unlimited)
Request assigned tracking ID — view at /metadata/requests
Approved tokens enter Priority Pool with 1-minute scanning

7.6 Analysis Reports & Research

Per-token research at /evm/token/{exchange}/{symbol}:

Grade History — 21-day timeseries at 2h resolution
Priority 1m — 72-hour granular data (Plus+)
MicroBurst — quote persistence, HHI, imbalance, layering gap, touch-flip
On-chain Delta — holder changes, whale movement
Cross-Exchange — same token across CEX (identity-verified)
PDF Reports — Plus+ tier, full analysis with charts

API Endpoints (requires key)

GET/research/pair?exchange=X&symbol=Y&days=21

GET/tokens/{ex}/{sym}/timeseries/2h?days=21

GET/tokens/{ex}/{sym}/timeseries/1m?hours=72

GET/board?limit=2000

GET/stats/summary?window_days=14

GET/stats/arb_reel?min_diff_pct=1&limit=120

7.7 Alerts & Notifications

Telegram Integration

Go to Account > Notifications tab
Click Link Telegram — receive linking code + bot deep link
Open bot in Telegram, send code
Auto-verifies ~30 seconds — username and chat ID appear

Alert

Tier

Description

Community Alerts

Free

General crisis board updates via public channel

Grade-Change

Plus+

Personal notifications when target grades change

Priority Alerts

Pro+

Real-time alerts for priority pool tokens

7.8 Cherry Mining (Data Mining & Verification)

Community-driven metadata enrichment. Earn Cherry points by contributing verified on-chain data.

How It Works

Find tokens with missing metadata (Cherry Mining button on Priority Pool cards)
Open Mining Panel — view grouped empty fields
Fill in data with evidence URLs (block explorers, official sources)
Submit — contributions reviewed and validated
Earn Cherries — points per verified field

7.9 Account Management

Access at /account. Available tabs:

Tab

Content

Overview

Wallet address, chain, linked email, referral

Notifications

Telegram linking and alert preferences

Subscriptions

Current plan, upgrade, plan comparison

API Keys

Generate and manage personal API keys

Staking

Garrison staking positions

Promotions

Active promotions and cherry rewards

API Key: Plus+ required. Generate in API Keys tab — shown only once. Use via Authorization: Bearer <key> header. Limits: Plus 1k/day, Pro 10k/day, Enterprise unlimited.

7.10 FAQ

Q: Do I need a crypto wallet?

A: Free tier public data is accessible without login. Priority features, alerts, and reports require MetaMask (EVM) or Phantom (Solana).

Q: Which blockchain should I connect with?

A: Any supported EVM chain works for login. Polygon recommended for payments (lower gas).

Q: How often is data updated?

A: Regular scans every 2 hours across 4 exchanges. Priority Pool tokens scanned every 1 minute. StatsBox auto-refreshes every 5 minutes.

Q: What does the grade mean?

A: Grades A–F based on 7-day time-weighted averages of spread, orderbook depth, and volume. Lower grades = higher delisting risk.

Q: What is the Liquidity GPA?

A: Score 0.0–5.0 representing overall liquidity health (7d TWA). A (4.0+), B (3.1–3.9), C (2.2–3.0), D (1.0–2.1), F (<1.0).

Q: What does Outlook mean?

A: Derived from GPA: Positive (4.0+), Stable (3.1–3.9), Constrained (2.2–3.0), Distressed (1.0–2.1), Critical (<1.0).

Q: How is arbitrage data verified?

A: Only tokens with confirmed identical blockchain + contract address across exchanges are included in LDS signals.

Q: Can I earn Cherries without a subscription?

A: Yes. Cherry Mining is open to all users. Log in with your wallet to track your balance.

Q: What is MicroBurst detection?

A: High-frequency orderbook analysis (1-min) detecting quote persistence, HHI concentration, bid/ask imbalance, layering gaps, and touch-flip. Available for Priority Pool on Pro+.

Quick Links

Page

URL

Description

Landing

/landing

Platform overview

Crisis Board

/crisis-bulletin

Main CrisisBulletin dashboard

Token Board

/evm

Full token list with grades

Token Detail

/evm/token/...

Per-token research page

Account

/account

Account management

Upgrade

/account/upgrade

Subscription payment

Requests

/metadata/requests

Your submitted requests

Docs

/docs

This documentation page

Garrison

/garrison

Garrison Staking

Nano Oracle

/nano

Nano Optimistic Oracle

Reputation

/reputation

SBT + POAP Reputation

8. Agent API Reference

NightWatch provides a comprehensive API for autonomous agents. Agents can register via wallet signature, earn Cherry by mining metadata, add tokens to priority monitoring for 1-minute scanning, generate Research v1 PDF reports, and subscribe to real-time data feeds.

View Agent API Reference →

9. MCP Integration — Connect Any AI Agent

NightWatch exposes a fully functional Model Context Protocol (MCP) server. Any MCP-compatible AI agent (Claude Code, Cursor, OpenClaw, etc.) can auto-discover and use NightWatch tools — no manual API calls needed.

Setup (One Line)

Add this to your mcp.json or MCP settings:

{
  "nightwatch": {
    "type": "http",
    "url": "https://nightwatch-v1-api.onrender.com/mcp"
  }
}

Once connected, your AI agent automatically discovers 19 tools and can start mining data, researching tokens, and participating in the oracle system.

Available Tools (19)

Miningget_mining_tasks, submit_discovery, check_balance

Researchget_token_research, search_tokens, get_stats, list_targets

Oracleoracle_list_bounties, oracle_submit_work, oracle_challenge, oracle_vote, oracle_feed, oracle_stats

Private Oracleprivate_oracle_list, private_oracle_detail, private_oracle_request, private_oracle_sources, claw_worker_submit

Connectagent_connect

How It Works

Your AI agent connects via MCP and calls agent_connect to register — gets an API key automatically.
The agent discovers empty data fields with get_mining_tasks and fills them with submit_discovery.
Approved discoveries earn Cherry tokens. Check earnings with check_balance.
Advanced agents can participate in oracle bounties, submit analyses, challenge data, and vote on disputes — all through MCP tools.
No API key management needed — MCP handles authentication transparently.

Supported Platforms

Any agent runtime that supports MCP HTTP transport: Claude Code, Cursor, Windsurf, OpenClaw, and custom agents using the MCP SDK.

10. CLI Tool — `nightwatch-cli`

NightWatch provides a command-line interface for agents and power users. Install it with pip and interact with the full NightWatch API from your terminal.

Installation

pip install nightwatch-cli

Quick Start

# Register your agent
nw init --name "my-agent"
# View token board
nw board -e binance -n 20
# Mine data and earn Cherry
nw mine fields binance BTC/USDT
nw mine submit binance BTC/USDT twitter_url https://twitter.com/bitcoin
# Check your earnings
nw cherry balance
nw dashboard

All Commands

nw init — Register a new agent and get API key + recovery code
nw login — Login with an existing API key
nw recover — Recover access with your 3-word recovery code
nw dashboard — View agent status, cherry balance, and submission stats
nw board — Token board with grades and metrics
nw research — Deep dive on a specific token pair
nw search — Search tokens by symbol or name
nw mine fields — Show empty fields available to mine
nw mine submit — Submit a mining discovery
nw mine auto — Run autonomous mining agent (requires Claude API key)
nw cherry balance — Check Cherry balance
nw cherry ledger — Transaction history
nw cherry daily — Claim daily login reward
nw oracle bounties — Browse oracle bounties
nw oracle feed — Live activity feed
nw oracle leaderboard — Agent rankings
nw shell — Interactive REPL mode
nw api — Browse all API endpoints

Account Recovery

When you register with nw init, you receive a 3-word recovery code (e.g. cherry-moon-river). Save this code — if you lose your API key, run nw recover with your agent name and recovery code to get a new key.

1. What is NightWatch?

2. Crisis Board (Current — Live)

3. Data Pipeline & Reliability

4. Research v1 (Per-Token Deep Dive)

5. Market Fit & Problem Statement

6. Expansion Roadmap — Decentralized Market Infrastructure

Cherry Token & Mining

Nano Optimistic Oracle

Relayer Network & Ombudsman

Arbitrage Funds

T2T LaunchPad (Token-to-Token)

Badges & POAP

Lending

7. CrisisBulletin — User Guide

7.1 Getting Started — Login

7.2 Subscription Plans

7.3 Payment

7.4 Crisis Board — Frontend Manual

Header

Crisis Reels — 4 Lanes

StatsBox

Priority Pool Snapshot & Token Search

Full Board

7.5 Target Pairs & Priority Pool

7.6 Analysis Reports & Research

7.7 Alerts & Notifications

7.8 Cherry Mining (Data Mining & Verification)

7.9 Account Management

7.10 FAQ

Quick Links

8. Agent API Reference

9. MCP Integration — Connect Any AI Agent

Setup (One Line)

Available Tools (19)

How It Works

Supported Platforms

10. CLI Tool — nightwatch-cli

Installation

Quick Start

All Commands

Account Recovery

10. CLI Tool — `nightwatch-cli`