ReNoUn MCP Server

Observabilidade estrutural para conversas de IA. Detecta loops, estados travados e padrões de convergência em 17 canais sem analisar conteúdo.

Documentação

ReNoUn

Telemetria de Risco Estrutural para Mercados de Criptomoedas

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

Classifica regimes estruturais do mercado de criptomoedas — limitado, ativo ou instável — com 100% de precisão em regimes limitados (128+ previsões avaliadas, zero falsos positivos). Estima a meia-vida de estabilidade do regime: quantos minutos até a estrutura atual provavelmente transicionar. Cada previsão é pública, carimbada com data/hora e avaliada — nenhum outro serviço de sinais de criptomoedas faz isso.

Uma requisição GET. Um campo de ação. Portão de risco pré-negociação para bots de trading, agentes autônomos e sistemas quantitativos.

Início Rápido

1. Obtenha uma Chave (Grátis, Sem Cartão de Crédito)

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

Retorna uma chave rn_agent_. 50 chamadas grátis/dia. $0,02/chamada após isso.

2. Verifique um Regime

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

3. Leia a Resposta

{
  "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

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

Tipos de Regime

RegimeAçãoO Que Significa
boundedproceedPreço esperado dentro do envelope. Negocie com tamanho total.
activereduceCondições dinâmicas. Dimensione a posição pelo escalar exposure.
unstableavoidEstrutura fragmentando. Pule esta negociação.

Meia-Vida de Estabilidade

Cada resposta inclui um bloco stability estimando por quanto tempo o regime atual persistirá.

CampoSignificado
halflife_minutesMinutos até 50% de probabilidade de transição de regime
stability_scoreEstabilidade composta 0,0–1,0 (1,0 = maximamente estável)
instability_risklow / moderate / elevated / high
time_horizonLegível para humanos: "2-4 horas", "15-30 minutos", etc.
urgencynone / watch / prepare_exit / exit_now
exit_window_minutesJanela de saída segura (somente quando a urgência é prepare_exit ou exit_now)

Sem a meia-vida, um agente sabe "o regime é limitado, prossiga." Com a meia-vida, o mesmo agente sabe "o regime é limitado, prossiga, E esta estrutura provavelmente está estável por 4 horas." Ou: "o regime é ativo, reduza, E saia dentro de 15 minutos."

Endpoints da API

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

EndpointMétodoAutenticaçãoDescrição
/v1/regime/live/{symbol}GETBearerRegime ao vivo + estabilidade para um símbolo Binance
/v1/regimePOSTBearerRegime a partir de seus próprios candles OHLCV
/v1/regime/batchPOSTBearerRegime multi-ativo + agregado de portfólio (máx. 10)
/v1/keys/provisionPOSTNenhumAuto-provisionamento de chave de API
/v1/usageGETBearerContagem de chamadas de hoje, grátis vs. cobráveis
/v1/webhooks/registerPOSTBearerRegistrar para notificações de mudança de regime
/v1/webhooksGETBearerListar webhooks registrados
/v1/agents/leaderboardGETNenhumRanking de uso de agentes
/v1/statusGETNenhumInformações de atividade + versão
/docsGETNenhumExplorador OpenAPI interativo

Cabeçalhos de Resposta

Cada resposta de regime inclui cabeçalhos legíveis por máquina:

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

Preços

Nível Agente (padrão)Nível Pro
Chamadas grátis diárias501.000
Preço por chamada (além do grátis)$0,02Incluído
Limite de taxa1.000/hora, 10.000/dia1.000/hora
Prefixo da chavern_agent_rn_live_
ProvisionamentoAutoatendimento (POST)Assine via Stripe

Sem cartão de crédito necessário para o nível agente. Agentes provisionam suas próprias chaves.

Precisão

100% de precisão em regimes limitados em 128+ previsões avaliadas. Quando o ReNoUn classifica um regime como limitado (prossiga), o preço permanece dentro do envelope previsto todas as vezes. Zero falsos positivos. Cada previsão é pública, carimbada com data/hora e avaliada: @98lukehall no X. Nenhum outro serviço de sinais de criptomoedas publica cada chamada com uma nota de aprovado/reprovado.

Regimes ativos (CONVERGENCE, PATTERN_BREAK) são avaliados contra limites mais rígidos e têm menor precisão — eles recomendam dimensionamento de posição via o escalar de exposição, não negociações de tamanho total.

O que isso significa: quando o ReNoUn diz "limitado," você pode negociar com tamanho total com confiança. Quando diz "ativo," dimensione sua posição pelo escalar de exposição. Quando diz "instável," fique de fora.

O que isso NÃO significa: o ReNoUn não prevê se o preço sobe ou desce. Ele mede estabilidade estrutural. Use-o como um portão de risco, não como um sinal.

Como Funciona

O ReNoUn é um motor de análise estrutural de 17 canais. Ele mapeia dados de candles OHLCV em três dimensões de medição:

Recorrência (Re₁–Re₅) — O mercado está repetindo padrões conhecidos? Ritmos de preço, perfis de volume, persistência de volatilidade, estrutura de sessão, assinaturas de reversão à média.

Novidade (No₁–No₆) — Algo genuinamente novo está acontecendo? Quebras de regime, reversões de fluxo, picos de volatilidade, interrupções de sessão, mudanças comportamentais, raridade de sinais cruzados.

Unidade (Un₁–Un₆) — O mercado está se mantendo coeso? Coesão de tendência, alinhamento volatilidade-preço, continuidade de sessão, estabilidade de referencial, simetria estrutural.

A partir desses 17 sinais, o motor calcula um Índice de Saúde Dialética (DHS: 0,0–1,0) e detecta 8 padrões de constelação:

ConstelaçãoRegimeDescrição
CLOSED_LOOPlimitadoEm faixa, movimento <2% esperado
HIGH_SYMMETRYlimitadoEquilíbrio apertado, movimento <1,5% esperado
CONVERGENCEativoTendência ativa, movimentos até 2,5%
SURFACE_VARIATIONlimitadoOscilante mas limitado, movimento líquido <2,5%
DIP_AND_RECOVERYativoRegime de recuperação, movimentos até 2,5%
PATTERN_BREAKativoMudança de regime em andamento, faixa elevada
SCATTERINGinstávelEstrutura fragmentando, risco elevado
REPEATED_DISRUPTIONinstávelRegime instável, risco elevado

A meia-vida de estabilidade é calculada a partir do momentum do DHS, tendências do canal de unidade, pressão de novidade, persistência da constelação e sequências conhecidas de desestabilização/estabilização.

Descoberta por Agentes

O ReNoUn é descoberto por agentes de IA através de protocolos padrão:

Servidor 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

Prompt de Sistema para Seu Agente

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.

Lote / Portfólio

Verifique múltiplos ativos em uma única chamada com agregação de risco em nível de portfólio:

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

Retorna regimes por ativo mais portfolio_action, portfolio_exposure e unstable_count.

Webhooks

Seja notificado quando os regimes mudarem:

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

Os payloads dos webhooks são assinados com HMAC. Máximo de 5 webhooks por chave.

Análise de Conversas

O ReNoUn também analisa conversas baseadas em turnos — detectando loops travados, variação de superfície, convergência e saúde estrutural. As ferramentas de conversação usam o mesmo motor de 17 canais aplicado a turnos de falante/texto em vez de candles OHLCV.

FerramentaPropósito
renoun_analyzeAnálise estrutural completa de 17 canais
renoun_health_checkTriagem rápida — uma pontuação, um padrão
renoun_compareTeste A/B estrutural entre conversas
renoun_pattern_queryHistórico longitudinal de sessão

Consulte a documentação da API para endpoints de análise de conversas.

Versão

  • Servidor: 1.3.1
  • Motor: 4.1
  • Esquema: 1.1
  • Protocolo: MCP 2024-11-05

Aviso de Patente

O motor de computação central é proprietário e com pedido de patente pendente (#63/923,592). O servidor MCP o envolve como uma caixa preta — agentes chamam a API e recebem resultados estruturados.

Licença

Servidor MCP e wrapper da API: MIT. Motor central: Proprietário.


Harrison Collab · Documentação da API · Previsões ao Vivo no X