What is NORT?
Polymarket is a prediction market platform where people bet on real-world outcomes. NORT focuses on two market categories: crypto and sports. At any given moment there are hundreds of active markets across these categories — browsing them manually to find an opportunity is impractical. NORT automates that entire process.
It fetches active markets, scores and ranks them by momentum and volume, exposes structured AI advice via OpenClaw, and presents everything through a web dashboard and a Telegram bot.
What NORT does in v1:
- Fetches and caches active crypto and sports markets from Polymarket (auto-synced every 15 minutes)
- Scores and ranks markets by momentum and volume spike via the Signals Engine
- Provides AI market analysis via the OpenClaw agent
- Supports paper trades, wallet balances, P&L tracking, and a leaderboard
- Accessible via the web dashboard at nortapp.online and through Telegram
Paper Trading Only
NORT v1 runs exclusively in paper trading mode. No real funds are ever moved. All trades are simulated with a virtual starting balance and are intended purely for analysis and practice.
Supported Market Categories
NORT v1 currently tracks crypto and sports prediction markets only. Other Polymarket categories are not included in this version.
Architecture Overview
NORT is built in three distinct layers. User interfaces — both the web dashboard and Telegram bot — never talk to the database or the AI directly. All requests flow through a central backend API, which acts as the single source of truth for all data and logic.
At the top layer sit the user interfaces: the Telegram bot for quick commands and the Next.js dashboard at nortapp.online for a full visual experience. Both connect to the same backend.
The middle layer is the backend API, which handles all market data, signal scoring, paper trade management, wallet tracking, and AI advice routing. It exposes structured endpoints that both interfaces consume.
The bottom layer is data and intelligence. Market data is stored in a Neon PostgreSQL database (cloud-hosted) and kept fresh via a background sync from Polymarket. The OpenClaw agent connects to OpenRouter to deliver AI-powered analysis — but only when explicitly requested via the advice commands.
Neon PostgreSQL
NORT v1 uses Neon as its cloud database. Neon provides a serverless PostgreSQL environment — there is no local SQLite file in production. All data is stored securely in the cloud.
The Two Command Paths
Every request in NORT takes one of two paths. This distinction determines cost, speed, and whether the AI is involved at all.
| Fast Path |
Used for market browsing, signals, portfolio checks, and paper trades. These requests go directly from the interface to the backend and return immediately — no AI is involved, no extra cost, near-instant response. |
| Agent Path |
Used only when requesting AI advice. The request goes through the backend to OpenClaw, which queries the AI model via OpenRouter and returns a structured analysis. This path is slower and consumes AI tokens, so it is reserved exclusively for advice requests. |
AI Is Not Always Running
OpenClaw is only triggered when you explicitly request advice. Browsing markets, checking signals, viewing your portfolio, and placing paper trades all use the fast path with no AI involvement.
Accessing NORT
The NORT dashboard is available at nortapp.online. Open it in any modern browser — no installation, no setup, no local environment required.
To get started, connect a wallet using the login button on the dashboard. NORT uses Privy for authentication, which supports wallet login as well as social sign-in options. Once connected, your paper wallet and trading history are tied to your account.
No setup required
NORT is fully hosted. Visit nortapp.online, connect your wallet, and start exploring markets immediately.
Using via Telegram
NORT has a Telegram bot for quick access to markets, signals, and paper trading directly from your chat. To get started, find the NORT bot on Telegram and send /start.
Basic commands to try first:
- Send
/trending to see the most active markets right now
- Send
/signals to get the top-ranked signals with scores and reasons
- Send
/portfolio to check your paper wallet balance and open trades
Placing a paper trade via Telegram:
Use the /papertrade command followed by the market ID, your prediction, and your stake amount. For example, to bet $50 on YES for a market:
/papertrade <market-id> YES 50
The bot will confirm the trade and update your paper wallet immediately.
Getting AI advice via Telegram:
Send /advice <market-id> to get OpenClaw's analysis for any market. The bot will reply with a structured breakdown including a summary, why the market is trending, key risk factors, and a suggested position.
Finding Market IDs
Market IDs appear in the output of /trending and /signals. Copy the ID from those results to use with /market, /papertrade, and /advice.
Using the Dashboard
The NORT dashboard at nortapp.online can also be launched directly inside Telegram as a Mini App (WebApp). When opened from Telegram, the dashboard loads in a full-screen view within the Telegram app — no external browser required.
To open the Mini App, tap the menu button in your chat with the NORT bot. This launches the full dashboard experience — including the Feed, Signals, Leaderboard, Trade, Achievements, and Profile pages — within Telegram itself.
Dashboard pages:
- Feed — Live trending signals with category filters for crypto and sports markets
- Signals — Full ranked list of scored markets with reasons
- Trade — Your paper wallet, open positions, and trade history
- Leaderboard — Rankings across all NORT users by portfolio performance
- Achievements — Earned badges and XP progress
- Profile — Your stats, wallet address, and account settings
Markets
GET /markets/ |
Returns all active markets. Supports filtering by category (crypto, sports). Response includes market ID, question, category, current odds, and volume. |
GET /markets/{id} |
Returns full detail for a single market by ID. Returns a not-found response if the market does not exist or is no longer active. |
GET /markets/refresh |
Triggers a manual sync from the Polymarket API. The backend also syncs automatically on startup and every 15 minutes. Only syncs crypto and sports categories. |
Signals
GET /signals/ |
Returns ranked market signals ordered by composite score. Each signal includes a market ID, score, plain-English reason, current odds, volume, and category label. |
AI Advice
POST /agent/advice |
Triggers OpenClaw for a specific market. Requires a market ID. Returns a structured analysis including summary, trend explanation, risk factors, a suggested position, and a confidence indicator. |
The advice response always includes one of three suggested positions: BUY YES, BUY NO, or WAIT. Every response also includes a disclaimer confirming this is paper trading and not financial advice.
Paper Trading
POST /api/papertrade |
Logs a new paper trade against a market. Requires a market ID, outcome direction (YES or NO), and a stake amount. Deducts from the user's paper balance and records the trade. |
POST /api/trade/commit |
Optional demo feature. Submits a trade receipt to Polygon testnet and returns a transaction hash. No real funds involved. |
Wallet & Leaderboard
GET /api/wallet/summary |
Returns the user's paper wallet — current balance, net P&L, total trade count, and a list of individual trades. |
GET /api/leaderboard |
Returns the full ranked leaderboard. Each entry includes rank, display name, portfolio value, net P&L, win rate, streak, XP, and badge. |
GET /api/leaderboard/me |
Returns the current user's own leaderboard entry and rank position. |
GET /api/user/stats |
Returns XP, level, streak, rank, and progress to next level for a user. |
GET /api/user/achievements |
Returns all achievements with earned status and associated XP values, computed from trade history. |
Liquidity Filter
Before any scoring happens, markets go through a hard liquidity gate. Any market that does not meet a minimum volume threshold is dropped entirely. This prevents low-activity markets from ranking highly just because they had one unusual trade — that's noise, not a signal.
Only markets with meaningful trading volume proceed to the scoring stage.
Scoring Criteria
Each market that passes the liquidity filter is evaluated on two dimensions, then combined into a single composite score.
Momentum
Momentum measures how much a market's price (odds) has shifted since the last snapshot. A significant price movement indicates that new information has entered the market and informed participants are actively reacting. Markets with larger recent price movements score higher on this dimension.
Volume Spike
Volume spike measures how unusual the current trading volume is relative to that market's typical baseline. A market trading far above its normal volume confirms broad participant activity — not just a single large bet. Markets with volume well above their average score higher on this dimension.
Composite Score
Both scores are combined with equal weighting. A market must show meaningful activity across both dimensions to rank near the top. This dual requirement reduces false positives — a market needs both price movement and volume confirmation to be considered a strong signal.
Signal Labels
Every scored market receives a label based on its composite score. These labels give an immediate at-a-glance sense of signal strength.
| ◆ HOT |
Strong momentum combined with an unusual volume spike. This is the highest priority signal — the market is moving fast and has broad participation. Worth immediate attention. |
| ◆ WARM |
Notable activity on at least one dimension. The market is showing signs of interest but hasn't hit the threshold for a high-confidence signal. Worth monitoring. |
| ◆ COOL |
Low activity on both dimensions. The market passed the liquidity filter but shows no meaningful momentum or volume spike at this time. Listed but deprioritised. |
Every signal also comes with a plain-English reason string — for example, a market might show "Price moved significantly with well above average volume." This explanation is always present so you understand why the market ranked, not just how it scored.
Reason strings are mandatory
Every signal in NORT must include a human-readable explanation. A score without context is not enough — NORT always tells you why a market ranked, not just that it did.
How It Works
When you request advice for a market, OpenClaw gathers context from multiple sources before calling the AI. It pulls the full market data, the current signal snapshot for that market, and recent news search results related to the market's question. All of this is assembled into a structured prompt before the AI model is consulted.
OpenClaw routes through OpenRouter, which acts as a unified gateway to various AI models. This means the underlying model can be swapped without changing how OpenClaw works — the output format and behaviour remain consistent regardless of which model is running underneath.
Context-aware advice
Before calling the AI, OpenClaw enriches its analysis with the market's current data, the signal score, and real-time news. This means advice is grounded in what's actually happening — not just a generic response to a market name.
Advice Output
OpenClaw always returns a structured analysis with the same fields every time. The backend validates the response and enforces the output format — invalid or incomplete AI responses are handled gracefully and never surface broken data to the user.
| Summary | A plain-English overview of the current market situation. |
|---|
| Why Trending | An explanation of the momentum and volume signals driving the market's ranking. |
|---|
| Risk Factors | A list of key uncertainties or risks that could affect the outcome. |
|---|
| Suggested Plan | One of three positions: BUY YES, BUY NO, or WAIT. |
|---|
| Confidence | A normalised indicator of how confident the model is in its suggested plan. |
|---|
Always a disclaimer
Every OpenClaw response includes: "This is not financial advice. Paper trading only." This is enforced by the backend and cannot be omitted.
Pages & Features
| Feed |
The home page. Shows trending signals across crypto and sports with filter tabs (All / Hot / Warm / Cool). Each card shows the market question, signal score, odds, and quick-bet buttons. OpenClaw advice is accessible from individual market cards. |
| Signals |
The full ranked signal list. Same data as the Feed, presented as a scrollable table with links to individual market detail pages. |
| Market Detail |
Full view for a single market — current odds, volume history, category, expiry, and an AI advice panel powered by OpenClaw. |
| Trade |
Your paper trading hub. Shows current wallet balance, net P&L, and total trade count at the top. Below that, open positions and full trade history with the option to commit a trade to testnet. |
| Leaderboard |
Podium display for the top three users, a full ranked table below, and your own rank card with XP progress bar. |
| Achievements |
Badge grid showing earned and locked achievements, an XP ring indicator, and current streak display. |
| Profile |
Your user profile — avatar, trading stats, level and XP, wallet address, username, and logout. |
Design System
The dashboard uses a glassmorphism design system with a deep navy background, teal as the primary accent colour, and glass-effect cards with blur and translucency. All interactive elements use teal for active states, glows, and hover effects.
Colour palette:
| ■ Teal #2DD4BF | Primary accent — CTAs, active states, glow effects |
|---|
| ■ Blue #60A5FA | Secondary accent — odds bars, info states |
|---|
| ■ Green #34D399 | Positive P&L, win states, live indicator |
|---|
| ■ Red #F87171 | Negative P&L, loss states |
|---|
| ■ Navy #0a1628 | Page background |
|---|
Typography:
- Syne 700/800 — headings, logo, large display numbers
- DM Mono 400/500 — labels, metadata, stats, data values
- Plus Jakarta Sans 300–600 — body text, descriptions, UI copy
Authentication
Authentication is handled by Privy. Users can sign in with a crypto wallet or via social login. Once authenticated, the wallet address is synced with the backend to associate paper trades, XP, and achievements with the user's account.
When the dashboard is opened as a Telegram Mini App, user identity from the Telegram session is also available and can be used to connect the Telegram experience with the web experience seamlessly.
Command Reference
/start |
Starts the bot and registers your account. Shows an overview of available commands and links to the dashboard Mini App. |
/trending |
Returns the top markets by current volume. Fast path — no AI involved. Shows crypto and sports markets only. |
/market <id> |
Returns full detail for a single market — question, odds, volume, category, and expiry. Fast path. |
/signals |
Returns the top-ranked signals with scores and plain-English reason strings. Fast path. |
/portfolio |
Returns your paper wallet summary — balance, net P&L, and open trades. Fast path. |
/papertrade <id> <YES|NO> <amount> |
Logs a paper trade. Example: /papertrade market-001 YES 50 places a $50 paper bet on YES. Fast path. |
/advice <id> |
Requests OpenClaw AI analysis for the specified market. Agent path — slightly slower as it calls the AI. |
No business logic in the bot
The Telegram bot only formats requests and responses. All scoring, trading, and advice logic lives in the backend. This means the bot and dashboard always show identical, consistent data.
Mini App (WebApp)
In addition to text commands, NORT supports the Telegram Mini App standard. This means the full NORT dashboard at nortapp.online can be launched directly inside Telegram as an embedded WebApp — giving users the complete visual dashboard experience without leaving the Telegram app.
To open the Mini App, tap the menu or app button within your NORT bot chat. The dashboard will load in a full-screen overlay inside Telegram. All features — Feed, Signals, Trade, Leaderboard, Achievements, and Profile — are fully accessible from within the Mini App.
Two ways to use NORT via Telegram
You can use the bot with text commands for quick queries, or open the full Mini App for the complete visual dashboard — both are available from the same Telegram chat.
General
Is any real money involved?
No. NORT v1 is paper trading only. No real Polymarket trades are ever placed. No real funds are moved at any point. All trades are simulated using a virtual balance.
What markets does NORT cover?
NORT v1 covers crypto and sports prediction markets on Polymarket. Other market categories are not included in this version.
Where do I access NORT?
The dashboard is live at nortapp.online. You can also access NORT via Telegram — either through text commands or by opening the full Mini App from the bot chat.
What does NORT stand for?
NORT is the product name — it's a brand, not an acronym.
How often does market data update?
Markets are synced from Polymarket on startup, then automatically every 15 minutes. You can also trigger a manual sync via the API.
Can I use the dashboard without Telegram?
Yes. The dashboard at nortapp.online is fully standalone. Telegram is optional — the web dashboard has the full feature set.
Paper Trading
What is my starting balance?
Every new user starts with $1,000 in paper USDC. This balance is tracked against all your paper trades and is used to compute your P&L and leaderboard ranking.
How is P&L calculated?
P&L is recorded when a trade closes, based on the final market outcome versus your entry price. For open trades, an estimated P&L is shown using the current market odds. The dashboard and Telegram both read this from the same backend.
What is the Commit button in the dashboard?
The Commit button is a demo feature that optionally logs a trade receipt to Polygon testnet and returns a transaction hash. No real money is involved — it's purely to demonstrate on-chain logging capability.
Can I trade from both the dashboard and Telegram?
Yes. Paper trades placed via Telegram commands and via the dashboard are both recorded to the same account. Your portfolio, balance, and history are consistent across both interfaces.
AI Advice
Is AI advice free?
Yes, in v1 AI advice via /advice is available to all users at no cost. Premium gating is planned for a future version.
Why does every advice response include a disclaimer?
It's a hard rule. Every OpenClaw response must include: "This is not financial advice. Paper trading only." This is enforced by the backend and cannot be omitted.
How accurate is the AI advice?
OpenClaw bases its analysis on current market data, signal scores, and recent news. It provides a structured perspective — not a guarantee. Always treat it as one input among many, not a definitive prediction.
Can OpenClaw see my trade history?
Yes. When generating advice, OpenClaw has access to your paper wallet summary. This allows it to factor in whether you already have an open position in the market being analysed.