ReNoUn — Crypto Regime Classification

io.github.98lukehallPublished by GitHub account 98lukehallv1.4.0Updated Oct 24, 2026

Crypto regime classifier for trading agents. 100% bounded regime accuracy. 50 free calls/day.

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

A remote crypto market regime classifier that lets an assistant check whether market structure is bounded, active or unstable before a trade.

What you can do
Check the live structural regime and stability half-life for a Binance symbol, returning an action such as proceed, reduce or avoid plus an exposure scalar and urgency level for exits. Submit your own OHLCV candles to get a regime classification from your data. Check up to ten assets in one batch call with a portfolio-level action, exposure and unstable count. Read today's call count and free versus billable usage. Register and list HMAC-signed webhooks for regime-change notifications. Run structural analysis on turn-based conversations, including a quick health check, an A/B comparison and a pattern query.
When to use it
Useful for trading bots, autonomous agents or quant systems that want a pre-trade risk gate on crypto positions, or for anyone who wants a structural stability read on a market rather than a directional price signal.
Requirements
A remote HTTPS endpoint; no local runtime. A bearer token in the Authorization header, obtained free by provisioning a key with an email and agent name. Network access to the provider's API.
Before you install
The bearer token is a credential and should be kept private. The free tier covers 50 calls per day; further calls are billed at $0.02 each, so automated loops can incur charges. Webhook registration sends your callback URL and an HMAC secret to the provider. The service explicitly does not predict price direction and should be treated as a risk gate, not a trading signal; its accuracy claims are the provider's own.

Installation

In SourceWeft

  1. Open ReNoUn — Crypto Regime Classification in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.98lukehall%2Frenoun/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "renoun-crypto-regime-classification": {
      "type": "http",
      "url": "https://web-production-817e2.up.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

ReNoUn

Structural Risk Telemetry for Crypto Markets

[API Live] [100% bounded accuracy] [API Docs] [License] [Patent Pending #63/923,592]

Classifies crypto market structural regimes — bounded, active, or unstable — with 100% bounded regime accuracy (128+ graded predictions, zero false positives). Estimates regime stability half-life: how many minutes until the current structure is likely to transition. Every prediction is public, timestamped, and graded — no other crypto signal service does this.

One GET request. One action field. Pre-trade risk gate for trading bots, autonomous agents, and quant systems.

Quick Start

1. Get a Key (Free, No Credit Card)

bash
curl -X POST https://web-production-817e2.up.railway.app/v1/keys/provision \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "agent_name": "my-bot"}'

Returns an rn_agent_ key. 50 free calls/day. $0.02/call after that.

2. Check a Regime

bash
curl https://web-production-817e2.up.railway.app/v1/regime/live/BTCUSDT \  -H "Authorization: Bearer rn_agent_YOUR_KEY"

3. Read the Response

json
{  "regime": "bounded",  "action": "proceed",  "dhs": 0.83,  "exposure": 0.95,  "constellation": "HIGH_SYMMETRY",  "envelope_pct": 1.5,  "description": "Tight equilibrium, <1.5% move expected",  "action_detail": "Structure healthy. Position size: 95% of intended.",  "stability": {    "halflife_minutes": 240,    "stability_score": 0.82,    "instability_risk": "low",    "time_horizon": "2-4 hours",    "urgency": "none"  },  "_meta": {    "provider": "renoun",    "version": "1.4.0",    "accuracy": "100% bounded regime accuracy, 128+ graded",    "provision_url": "https://web-production-817e2.up.railway.app/v1/keys/provision",    "docs": "https://harrisoncollab.com"  }}

4. Use It

python
import requests
def check_regime(symbol="BTCUSDT", key="rn_agent_YOUR_KEY"):    r = requests.get(        f"https://web-production-817e2.up.railway.app/v1/regime/live/{symbol}",        headers={"Authorization": f"Bearer {key}"}    )    return r.json()
regime = check_regime("BTCUSDT")
if regime["action"] == "avoid":    pass  # structure fragmenting — skip tradeelif regime["stability"]["urgency"] == "exit_now":    close_position()  # regime degrading fastelif regime["stability"]["urgency"] == "prepare_exit":    set_tight_stop()  # regime softeningelif regime["action"] == "reduce":    execute(size=intended * regime["exposure"])else:    execute(size=intended)  # structure healthy, full size

Regime Types

RegimeActionWhat It Means
boundedproceedPrice expected within envelope. Trade at full size.
activereduceDynamic conditions. Scale position by exposure scalar.
unstableavoidStructure fragmenting. Skip this trade.

Stability Half-Life

Every response includes a stability block estimating how long the current regime will persist.

FieldMeaning
halflife_minutesMinutes until 50% probability of regime transition
stability_score0.0–1.0 composite stability (1.0 = maximally stable)
instability_risklow / moderate / elevated / high
time_horizonHuman-readable: "2-4 hours", "15-30 minutes", etc.
urgencynone / watch / prepare_exit / exit_now
exit_window_minutesSafe exit window (only when urgency is prepare_exit or exit_now)

Without half-life, an agent knows "the regime is bounded, proceed." With half-life, the same agent knows "the regime is bounded, proceed, AND this structure is likely stable for 4 hours." Or: "the regime is active, reduce, AND exit within 15 minutes."

API Endpoints

Base URL: https://web-production-817e2.up.railway.app

EndpointMethodAuthDescription
/v1/regime/live/{symbol}GETBearerLive regime + stability for a Binance symbol
/v1/regimePOSTBearerRegime from your own OHLCV klines
/v1/regime/batchPOSTBearerMulti-asset regime + portfolio aggregate (max 10)
/v1/keys/provisionPOSTNoneSelf-provision an API key
/v1/usageGETBearerToday's call count, free vs billable
/v1/webhooks/registerPOSTBearerRegister for regime change notifications
/v1/webhooksGETBearerList registered webhooks
/v1/agents/leaderboardGETNoneAgent usage leaderboard
/v1/statusGETNoneLiveness + version info
/docsGETNoneInteractive OpenAPI explorer

Response Headers

Every regime response includes machine-readable headers:

X-ReNoUn-Regime: boundedX-ReNoUn-Action: proceedX-ReNoUn-Stability: 0.82X-ReNoUn-Halflife: 240X-ReNoUn-Urgency: noneX-ReNoUn-Cache: HITX-RateLimit-Remaining: 47

Pricing

Agent Tier (default)Pro Tier
Daily free calls501,000
Price per call (beyond free)$0.02Included
Rate limit1,000/hr, 10,000/day1,000/hr
Key prefixrn_agent_rn_live_
ProvisioningSelf-serve (POST)Subscribe via Stripe

No credit card required for the agent tier. Agents provision their own keys.

Accuracy

100% bounded regime accuracy across 128+ graded predictions. When ReNoUn classifies a regime as bounded (proceed), price stays within the predicted envelope every time. Zero false positives. Every prediction is public, timestamped, and graded: @98lukehall on X. No other crypto signal service publishes every call with a pass/fail grade.

Active regimes (CONVERGENCE, PATTERN_BREAK) are graded against tighter thresholds and have lower accuracy — they recommend position scaling via the exposure scalar, not full-size trades.

What this means: when ReNoUn says "bounded," you can trade at full size with confidence. When it says "active," scale your position by the exposure scalar. When it says "unstable," stay out.

What this does NOT mean: ReNoUn does not predict whether price goes up or down. It measures structural stability. Use it as a risk gate, not a signal.

How It Works

ReNoUn is a 17-channel structural analysis engine. It maps OHLCV candle data onto three measurement dimensions:

Recurrence (Re₁–Re₅) — Is the market repeating known patterns? Price rhythms, volume profiles, volatility persistence, session structure, mean-reversion signatures.

Novelty (No₁–No₆) — Is something genuinely new happening? Regime breaks, flow reversals, volatility spikes, session disruptions, behavioral shifts, cross-signal rarity.

Unity (Un₁–Un₆) — Is the market holding together? Trend cohesion, volatility-price alignment, session continuity, reference-frame stability, structural symmetry.

From these 17 signals the engine computes a Dialectical Health Score (DHS: 0.0–1.0) and detects 8 constellation patterns:

ConstellationRegimeDescription
CLOSED_LOOPboundedRange-bound, <2% move expected
HIGH_SYMMETRYboundedTight equilibrium, <1.5% move expected
CONVERGENCEactiveTrend-active, moves up to 2.5%
SURFACE_VARIATIONboundedChoppy but bounded, <2.5% net move
DIP_AND_RECOVERYactiveRecovery regime, moves up to 2.5%
PATTERN_BREAKactiveRegime shift underway, elevated range
SCATTERINGunstableStructure fragmenting, risk elevated
REPEATED_DISRUPTIONunstableUnstable regime, risk elevated

The stability half-life is computed from DHS momentum, unity channel trends, novelty pressure, constellation persistence, and known destabilizing/stabilizing sequences.

Agent Discovery

ReNoUn is discoverable by AI agents through standard protocols:

MCP Server (Claude Desktop / Claude Code)

json
{  "mcpServers": {    "renoun": {      "command": "python3",      "args": ["-m", "server"],      "env": { "RENOUN_API_KEY": "rn_agent_YOUR_KEY" }    }  }}
bash
claude mcp add renoun python3 -m server

System Prompt for Your Agent

Before any crypto trade, check the structural regime:  GET /v1/regime/live/{SYMBOL}If action is "avoid" — skip the trade (structure unstable).If action is "reduce" — multiply position by the exposure scalar.If urgency is "exit_now" — close position immediately.If urgency is "prepare_exit" — set tight stop loss.If action is "proceed" — execute at intended size.ReNoUn classifies structural regimes with 100% bounded accuracy.It does not predict price direction.

Batch / Portfolio

Check multiple assets in one call with portfolio-level risk aggregation:

bash
curl -X POST https://web-production-817e2.up.railway.app/v1/regime/batch \  -H "Authorization: Bearer rn_agent_YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{"symbols": ["BTCUSDT", "ETHUSDT", "SOLUSDT"], "timeframe": "1h"}'

Returns per-asset regimes plus portfolio_action, portfolio_exposure, and unstable_count.

Webhooks

Get notified when regimes change:

bash
curl -X POST https://web-production-817e2.up.railway.app/v1/webhooks/register \  -H "Authorization: Bearer rn_agent_YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{    "url": "https://your-bot.com/webhook",    "symbols": ["BTCUSDT"],    "events": ["regime_change"],    "secret": "your_hmac_secret"  }'

Webhook payloads are HMAC-signed. Max 5 webhooks per key.

Conversation Analysis

ReNoUn also analyzes turn-based conversations — detecting stuck loops, surface variation, convergence, and structural health. The conversation tools use the same 17-channel engine applied to speaker/text turns instead of OHLCV candles.

ToolPurpose
renoun_analyzeFull 17-channel structural analysis
renoun_health_checkQuick triage — one score, one pattern
renoun_compareStructural A/B test between conversations
renoun_pattern_queryLongitudinal session history

See the API docs for conversation analysis endpoints.

Version

  • Server: 1.3.1
  • Engine: 4.1
  • Schema: 1.1
  • Protocol: MCP 2024-11-05

Patent Notice

The core computation engine is proprietary and patent-pending (#63/923,592). The MCP server wraps it as a black box — agents call the API and receive structured results.

License

MCP server and API wrapper: MIT. Core engine: Proprietary.


Harrison Collab · API Docs · Live Predictions on X

Source: README.md at commit e4047e4

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.4.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.