Renoun Mcp

ReNoUn

加密市场结构风险遥测

对加密市场结构状态进行分类——有界、活跃或不稳定——有界状态准确率达 100%（已评估 128 次以上预测，零误报）。估算状态稳定半衰期：当前结构可能发生转变前预计还有多少分钟。每项预测都会公开、标注时间戳并接受评估——没有其他加密信号服务会这样做。

一次 GET 请求。一个 action 字段。为交易机器人、自主 Agent 和量化系统提供交易前风险关卡。

快速开始

1. 获取密钥（免费，无需信用卡）

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"}'

返回一个 rn_agent_ 密钥。每天免费调用 50 次。超出后每次调用收费 $0.02。

2. 检查状态

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

3. 阅读响应

{
  "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. 使用

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 trade
elif regime["stability"]["urgency"] == "exit_now":
    close_position()  # regime degrading fast
elif regime["stability"]["urgency"] == "prepare_exit":
    set_tight_stop()  # regime softening
elif regime["action"] == "reduce":
    execute(size=intended * regime["exposure"])
else:
    execute(size=intended)  # structure healthy, full size

状态类型

状态	操作	含义
bounded	proceed	预计价格将在区间内。按完整仓位交易。
active	reduce	市场条件动态变化。按 exposure 系数缩减仓位。
unstable	avoid	结构正在瓦解。跳过这笔交易。

稳定半衰期

每个响应都包含一个 stability 区块，用于估算当前状态将持续多久。

字段	含义
halflife_minutes	状态转变概率达到 50% 前的分钟数
stability_score	0.0–1.0 的综合稳定性（1.0 = 最稳定）
instability_risk	low / moderate / elevated / high
time_horizon	易读时间范围：“2-4 小时”“15-30 分钟”等
urgency	none / watch / prepare_exit / exit_now
exit_window_minutes	安全退出窗口（仅当 urgency 为 prepare_exit 或 exit_now 时提供）

没有半衰期时，Agent 只知道“状态有界，可以继续”。有了半衰期，同一个 Agent 就能知道“状态有界，可以继续，而且这种结构可能会稳定持续 4 小时”。或者：“状态活跃，应缩减仓位，而且应在 15 分钟内退出”。

API 端点

基础 URL：https://web-production-817e2.up.railway.app

端点	方法	身份验证	描述
/v1/regime/live/{symbol}	GET	Bearer	获取 Binance 交易对的实时状态和稳定性
/v1/regime	POST	Bearer	根据你自己的 OHLCV K 线数据获取状态
/v1/regime/batch	POST	Bearer	获取多资产状态和投资组合汇总（最多 10 个）
/v1/keys/provision	POST	无	自助创建 API 密钥
/v1/usage	GET	Bearer	今日调用次数，以及免费与计费调用次数
/v1/webhooks/register	POST	Bearer	注册状态变更通知
/v1/webhooks	GET	Bearer	列出已注册的 Webhook
/v1/agents/leaderboard	GET	无	Agent 使用量排行榜
/v1/status	GET	无	存活状态和版本信息
/docs	GET	无	交互式 OpenAPI 浏览器

响应头

每个状态响应都包含机器可读的响应头：

X-ReNoUn-Regime: bounded
X-ReNoUn-Action: proceed
X-ReNoUn-Stability: 0.82
X-ReNoUn-Halflife: 240
X-ReNoUn-Urgency: none
X-ReNoUn-Cache: HIT
X-RateLimit-Remaining: 47

定价

	Agent 层级（默认）	Pro 层级
每日免费调用次数	50	1,000
超出免费额度后的每次调用价格	$0.02	已包含
速率限制	1,000/hr, 10,000/day	1,000/hr
密钥前缀	rn_agent_	rn_live_
开通方式	自助开通（POST）	通过 Stripe 订阅

Agent 层级无需信用卡。Agent 可自行开通密钥。

准确性

在 128+ 次经过评分的预测中，受限状态下的准确率为 100%。当 ReNoUn 将某个状态判定为受限（可继续交易）时，价格每次都保持在预测范围内。零误报。每次预测都会公开、标注时间戳并接受评分：X 上的 @98lukehall。没有其他加密货币信号服务会公开每次调用并给出通过/未通过评分。

活跃状态（CONVERGENCE、PATTERN_BREAK）依据更严格的阈值评分，准确率较低——它们通过敞口系数建议调整仓位，而非进行满仓交易。

**这意味着：**当 ReNoUn 表示“受限”时，你可以放心满仓交易。当它表示“活跃”时，请按敞口系数缩小仓位。当它表示“不稳定”时，请离场观望。

**这并不意味着：**ReNoUn 不会预测价格涨跌。它衡量的是结构稳定性。请将其用作风险闸门，而非交易信号。

工作原理

ReNoUn 是一个包含 17 个通道的结构分析引擎。它将 OHLCV K 线数据映射到三个测量维度：

重复性（Re₁–Re₅）——市场是否在重复已知模式？价格节奏、成交量分布、波动率持续性、时段结构、均值回归特征。

新颖性（No₁–No₆）——是否有真正的新情况发生？状态突变、资金流逆转、波动率激增、时段中断、行为变化、跨信号罕见性。

统一性（Un₁–Un₆）——市场是否保持整体性？趋势凝聚度、波动率与价格的协调性、时段连续性、参考系稳定性、结构对称性。

引擎根据这 17 个信号计算辩证健康评分（DHS：0.0–1.0），并检测 8 种星座模式：

星座	状态	描述
CLOSED_LOOP	bounded	区间震荡，预计波动幅度 <2%
HIGH_SYMMETRY	bounded	紧密均衡，预计波动幅度 <1.5%
CONVERGENCE	active	趋势活跃，波动幅度最高可达 2.5%
SURFACE_VARIATION	bounded	震荡但受限，净波动幅度 <2.5%
DIP_AND_RECOVERY	active	复苏状态，波动幅度最高可达 2.5%
PATTERN_BREAK	active	状态转换正在进行，波动范围扩大
SCATTERING	unstable	结构正在瓦解，风险升高
REPEATED_DISRUPTION	unstable	状态不稳定，风险升高

稳定性半衰期根据 DHS 动量、统一性通道趋势、新颖性压力、星座持续性，以及已知的 destabilizing/stabilizing 序列计算得出。

Agent 发现

AI Agent 可通过标准协议发现 ReNoUn：

• harrisoncollab.com/llms.txt 上的 llms.txt
• harrisoncollab.com/.well-known/mcp.json 上的 .well-known/mcp.json
• 每个 API 响应中的 _meta 块，包含开通 URL 和文档
• 每个响应上的 X-Agent-Compatible: true 标头

MCP 服务（Claude Desktop / Claude Code）

{
  "mcpServers": {
    "renoun": {
      "command": "python3",
      "args": ["-m", "server"],
      "env": { "RENOUN_API_KEY": "rn_agent_YOUR_KEY" }
    }
  }
}

claude mcp add renoun python3 -m server

面向 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.

批量 / 投资组合

通过一次调用检查多个资产，并汇总投资组合级别的风险：

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"}'

返回每种资产的状态，以及 portfolio_action、portfolio_exposure 和 unstable_count。

Webhook

在状态发生变化时接收通知：

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 负载采用 HMAC 签名。每个密钥最多可配置 5 个 Webhook。

对话分析

ReNoUn 还会分析基于轮次的对话，检测陷入停滞的循环、表层变化、收敛情况和结构健康度。对话工具使用相同的 17 通道引擎，分析对象是说话人／文本轮次，而非 OHLCV 蜡烛图。

工具	用途
renoun_analyze	完整的 17 通道结构分析
renoun_health_check	快速分诊——一个分数、一种模式
renoun_compare	对对话进行结构性 A/B 测试
renoun_pattern_query	长期会话历史

请参阅API 文档，了解对话分析端点。

版本

• 服务端：1.3.1
• 引擎：4.1
• 架构：1.1
• 协议：MCP 2024-11-05

专利声明

核心计算引擎为专有技术，正在申请专利（#63/923,592）。MCP 服务将其封装为黑盒——Agent 调用 API 并接收结构化结果。

许可证

MCP 服务和 API 封装：MIT。核心引擎：专有。

---

Harrison Collab · API 文档 · X 上的实时预测