Referencia de la API

Inicio rápido

1. Crea una cuenta — obtén tu API key al instante
2. Establece la cabecera X-API-Key en cada solicitud
3. Llama a GET /signals — listo

curl -H "X-API-Key: intel_sk_your_key" https://api.n0brains.com/signals

¿Quieres ver cómo rinden las señales? Nuestro forward-test en vivo está en /proof.

Para agentes

¿Con prisa? El Quickstart tiene prompts para copiar y pegar — un one-liner del plan gratuito y un agente Pro/MCP completo. O sigue leyendo para los detalles.

n0brains es una API HTTP sencilla — sin SDK, sin paso de instalación. Apunta cualquier agente (Claude Code, OpenClaw, LangChain, un orquestador propio) hacia ella pasándole la URL base y tu clave. Una línea en las instrucciones del agente:

Use the n0brains API at https://api.n0brains.com with X-API-Key intel_sk_your_key

Sustituye tu clave real y esa es toda la integración — el agente descubre los endpoints implícitamente a partir de la forma de la API (referencia completa abajo). URL base https://api.n0brains.com, cabecera de auth X-API-Key.

Opcional: un archivo de skill estructurado

Algunos runtimes prefieren un archivo de skill estructurado a una instrucción de una línea. n0brains-signals.md empaqueta lo mismo — frontmatter, cada herramienta con ejemplos, auth, manejo de errores, reglas de comportamiento — como un único archivo Markdown que colocas. La instrucción de una línea funciona igual de bien; esto es para cuando quieres dejarlo codificado.

curl -O https://n0brains.com/openclaw/n0brains-signals.md

Descargar n0brains-signals.md ↓

Runtime	Dónde va	Auth
OpenClaw	coloca n0brains-signals.md en el directorio de skills de tu agente	env NB_API_KEY
Claude Code	copia a ~/.claude/skills/n0brains-signals/SKILL.md	env NB_API_KEY
Orquestador propio	carga el .md como contexto de sistema, o simplemente usa la instrucción de una línea	tu almacén de secretos, clave n0brains_api_key
Cliente HTTP / TS directo	sáltate la skill — usa los endpoints de abajo o el n0brains-ts cliente	cabecera X-API-Key

¿Prefieres llamadas tipadas? El cliente opcional de TypeScript n0brains-ts (@n0brains/client) envuelve cada endpoint. O la CLI para el shell, y el MCP server para Claude Desktop / Cursor / Cline.

Planes y créditos

Gratis y Pro son los dos planes de suscripción (límites de tasa arriba). Más allá de la tasa incluida en tu plan, tienes dos opciones de pago por uso:

Opción	Cómo funciona	¿Cuenta?
Créditos de pago por llamada	Packs de un solo uso (desde $5). Un crédito se gasta solo en una llamada de datos hecha más allá del límite de tasa incluido en tu plan — dentro de tu tasa, las llamadas siguen siendo gratis. Cómpralos y contrólalos en tu cuenta.	Sí — tarjeta vía Stripe
x402	Paga por solicitud en USDC sobre Base, sin registro. Ver /docs/x402.	No — sin wallet

Cuando te quedas sin créditos y superas tu límite de tasa, los endpoints de datos devuelven 402 con un enlace para comprar más. Dentro de tu límite de tasa, no se cobra nada.

Autenticación

Todos los endpoints autenticados requieren una API key en la cabecera X-API-Key. Las claves se generan al registrarse y pueden rotarse vía POST /auth/api-keys.

El login también devuelve un token JWT usable vía Authorization: Bearer.

Método	Cabecera	Ejemplo
API Key	X-API-Key	intel_sk_a1b2c3...
JWT Token	Authorization	Bearer eyJhbGci...

Límites de tasa

Plan	Solicitudes/min	Retraso de señal	Acceso
El	60	15 minutos	Solo API REST, campos limitados. MCP tools/list abierto para descubrimiento de catálogo.
Pro	600	Tiempo real	REST + WebSocket + Webhooks + servidor MCP, campos completos

Superar el límite de tasa devuelve 429 con un mensaje que apunta a la página de mejora.

Endpoints

Método	Ruta	Auth	Descripción
GET	/health	Ninguna	Comprobación de vida
GET	/signals	API Key	Lista las señales activas. Filtra con ?asset=, ?signal_type=, ?urgency=, ?direction=, y ?asset_class= (crypto · stock · metal · commodity · index) para acotar a cripto o al mercado bursátil tokenizado
GET	/signals/{id}	API Key	Detalle de una sola señal
GET	/signals/similar	Pro	Búsqueda semántica del vecino más cercano
GET	/narrative/{coin}	Pro	Mapa de calor narrativo del activo
GET	/manipulation/{coin}	Pro	Puntuación de manipulación del activo
GET	/trust/{coin}	Pro	Puntuación de confianza y estafa del token
GET	/levels/{coin}	API Key	Niveles S/R de Hyperliquid
GET	/indicators/{coin}	API Key	Indicadores técnicos — RSI, MACD, SMA/EMA (20/50/200 + 200 semanas), Estocástico, Fibonacci, lectura de tendencia/momentum
GET	/state/{coin}/brief	Pro	Análisis en prosa escrito por LLM — lectura actual, niveles clave + estructurales, macro/on-chain, técnicos, perspectiva. La capa narrativa sobre /state, fundamentada solo en nuestros datos
GET	/liquidation-map/{coin}	API Key	Zonas estimadas de clústeres de liquidación en CEX (modeladas a partir de OI + tramos de apalancamiento)
GET	/liqmap/{coin}	API Key	Mapa de liquidación on-chain real en DEX — posiciones reales con precios de liquidación exactos. Cripto (Hyperliquid + GMX) y el mercado bursátil tokenizado vía Hyperliquid HIP-3 (/liqmap/SP500, /liqmap/NVDA, /liqmap/GOLD, …)
GET	/liquidation-heatmap/{coin}	API Key	Mapa de calor de liquidaciones en CEX — cuadrícula de intensidad precio×tiempo. ?days= (1–180), ?rows=, ?cols=
GET	/liq-heatmap/{coin}	API Key	Mapa de calor de liquidaciones de posiciones reales en DEX — cuadrícula precio×tiempo (BTC/ETH)
GET	/charts/options-walls/{symbol}	Ninguna	Muros de interés abierto de opciones listadas + max pain agregado (CBOE, con retraso) para una acción/índice — el análogo bursátil de los clústeres de liquidación. Los muros de strike actúan como imanes/pins hacia el vencimiento.
GET	/charts/stock-candles/{symbol}	Ninguna	Velas de sesión de exchange real (Yahoo, con retraso) para el subyacente de un activo tokenizado — superpón contra el precio tokenizado 24/7. ?days=
GET	/charts/hip3-estimate-heatmap/{symbol}	Ninguna	Mapa de calor modelado de densidad de liquidación para una acción/metal/índice tokenizado — proyección por tramos de apalancamiento a partir del interés abierto en vivo de Hyperliquid HIP-3 sobre la trayectoria de precio real (densidad estilo Coinglass donde el libro on-chain es escaso). ?days=
GET	/correlation	API Key	Matriz de correlación de retornos entre activos (7d). ?vs=BTC, ?coins=…
GET	/correlation/{coin}	API Key	Correlación + beta de una moneda frente a BTC/ETH + pares
GET	/rotation	API Key	Lectura de altseason/rotación — into_alts / into_btc / neutral
GET	/options/{coin}	API Key	Analítica de opciones (BTC/ETH): IV ATM, skew, estructura temporal, max-pain
GET	/sentiment/{coin}	API Key	Sentimiento agregado — sesgo neto, volumen, velocidad (fuentes curadas)
GET	/mindshare	API Key	Ranking de atención — cuota de cada activo + velocidad (subiendo/bajando)
GET	/mindshare/{coin}	API Key	Cuota de mindshare, ranking y velocidad de una moneda
GET	/market-opens	API Key	Precios de apertura de sesión
GET	/price/{coin}	Ninguna	Precio spot/medio actual de una moneda (Hyperliquid)
GET	/prices?coins=BTC,ETH,SOL	Ninguna	Precios actuales por lotes en una sola llamada
GET	/market-state/{coin}	Pro	Consenso de señales probadas por moneda — dirección, confianza, régimen, principales drivers
GET	/state	Pro	Estado de mercado unificado — régimen + compuesto, pack macro, tipos probados, resumen por moneda en una sola llamada
GET	/state/{coin}	Pro	Vista por moneda en una sola llamada — precio, market-state, régimen + compuesto, niveles, indicadores técnicos, objetivo de liqmap
GET	/plan/{coin}	Pro	Plan de trading ensamblado — dirección, entrada, objetivo más fuerte (ponderado por fuerza, no el más cercano), stop, riesgo/beneficio, sugerencia de tamaño, contexto de opciones (put/call + skew) y advertencias (timing de max-pain en contra de la operación, entrada cerca de un clúster de liquidación). La capa de síntesis sobre /state + /levels + /options
GET	/rank?coins=BTC,ETH,SOL	Pro	Ranking entre activos — planes de trading ensamblados para las monedas dadas, ordenados por setup_score (mejor primero). Responde «¿qué moneda es la mejor operación ahora mismo?»
POST	/check	API Key	Pregunta primero a n0brains — comprobación previa a la operación. Envía una operación (asset, side, opcionalmente entry/stop/target/leverage/horizon_hours) → una evaluación de condiciones calificada de A–F con cada motivo: aglomeración, riesgo de eventos, distancia de liquidación frente a volatilidad, extensión del momentum, posicionamiento y una comprobación estructural de stop fatal. Devuelve grade, score, engine_version, asset_class, flags, supports, falsifiers, terrain, unchecked. Funciona para cripto y para el mercado bursátil tokenizado (NVDA, SP500, XYZ100, GOLD…). Cada veredicto queda registrado de forma duradera y se resuelve en su horizonte. El rendimiento entre grados se mantiene retenido mientras se acumula la puerta de calibración desplegada. Gratis 3/día, Pro ilimitado. Pasa "chart": true para un PNG con marca.
POST	/check/anon	Ninguna	Una comprobación previa anónima por día por IP (con puerta Turnstile). Misma respuesta calificada que /check.
GET	/checks/history	API Key	Tus comprobaciones pasadas + resultados resueltos (retorno ajustado por lado en el horizonte, o el stop si se alcanzó primero).
GET	/check/assets	Ninguna	El universo de activos comprobables — perps de cripto + acciones/metales/índices tokenizados.
POST	/check/chart-parse	API Key	Lee el ticker + marco temporal de una captura de gráfico (visión) para que un agente pueda pasar una imagen en bruto a una comprobación. Solo identidad — nunca precios desde píxeles.
POST	/check/levels	API Key	Califica tus propios niveles horizontales dibujados frente a nuestras zonas S/R + clústeres de liquidación on-chain (imán en la línea / riesgo de mecha más allá de la línea).
GET	/macro	API Key	Condiciones/régimen macro diarios; sesgo por activo cuando está disponible
GET	/macro?history=N	Pro	Instantáneas históricas de Macro Pulse (últimos N informes, máx 30)
GET	/regime	API Key	Apetito de riesgo del mercado en su conjunto — risk-on / risk-off / squeeze + una puntuación de riesgo con signo y un market_bias direccional, mezclado a partir del compuesto macro, la amplitud transversal, el régimen de funding y la volatilidad. Responde «¿favorecen las condiciones el riesgo ahora mismo?» Descriptivo, candidato.
GET	/liquidity	API Key	Mapa de liquidez neta entre activos — liquidez neta de la Fed, dry-powder de stablecoins multi-cadena (DefiLlama), OI total de perps, concentración de apalancamiento entre venues (fragilidad de cascada), presión de liquidación, flujo neto de takers. Responde «¿dónde está la liquidez?»
GET	/flows	API Key	Flujos entre activos — rotación cripto, reparto de OI cripto-vs-tradfi por clase de activo, y postura institucional (ETF / COT / 13F, descriptivo). Responde «¿hacia dónde va el dinero y está el mercado comprando algo distinto de cripto?»
GET	/market-map	API Key	Compuesto de /regime + /liquidity + /flows en una sola llamada — la imagen completa del mercado entre activos.
GET	/discovery	API Key	Descubrimiento de edge emergente — combinaciones de clases de corroboración extraídas del ledger en la sombra frente a retornos futuros realizados, clasificadas por edge medido (con puerta de honestidad). Aflora patrones que nadie programó a mano. status=accruing hasta que el ledger se llene.
GET	/performance	Ninguna	Estadísticas públicas de tasa de acierto / PnL
GET	/proof	Ninguna	Marcador de retorno futuro — tasa de acierto por tipo, exceso vs BTC, IC, flag de probado (impulsa /proof)
GET	/proof/equity	Ninguna	Curva de equity de acumulación de edge sobre señales de tipos probados
GET	/public/feed	Ninguna	Feed público de señales con retraso (el stream del plan gratuito con 15 min de retraso)
GET	/status/uptime	Ninguna	Instantánea de tiempo de actividad / estado del servicio
POST	/auth/register	Ninguna	Crear cuenta
POST	/auth/login	Ninguna	Iniciar sesión
GET	/auth/me	API Key	Perfil de usuario
POST	/auth/api-keys	API Key	Generar nueva API key
DEL	/auth/api-keys/{id}	API Key	Revocar API key
POST	/billing/checkout	API Key	Checkout de suscripción de Stripe (Pro)
POST	/billing/buy-credits	API Key	Pago único de Stripe por un pack de créditos
GET	/billing/credit-packs	API Key	Lista los packs de créditos comprables
GET	/credits	API Key	Saldo de créditos + historial de transacciones
POST	/billing/portal	API Key	Portal de cliente de Stripe
POST	/webhooks	Pro	Registrar webhook
DEL	/webhooks/{id}	Pro	Eliminar webhook
WS	/stream	Pro	Stream de señales en tiempo real
POST	/mcp/	Pro (tools/call); open (tools/list)	Servidor MCP — herramientas de solo lectura para Claude Desktop, Cursor, Cline. Ver /docs/mcp.

¿Prefieres la línea de comandos? La n0brains CLI envuelve cada endpoint como un comando sin dependencias que imprime JSON — hecho para agentes de trading y pipelines de shell. Los agentes sin cuenta también pueden paga por llamada en USDC sobre Base (x402) — sin clave, sin registro.

GET /signals

Devuelve las señales activas, opcionalmente filtradas. El plan gratuito recibe las señales con 15 minutos de retraso.

Parámetros de consulta

Param	Tipo	Descripción
asset	string	Filtra por ticker (p. ej. BTC)
signal_type	string	regulatory, whale, whale_position, sentiment, price, hack, listing, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, unlock, research, other.
direction	string	bullish, bearish, neutral
urgency	string	high, medium, low
limit	int	1-200 (default 50)
offset	int	Desplazamiento de paginación (por defecto 0)
include_opens	bool	Incluir precios de apertura de mercado (por defecto true)
min_confidence	float	Puntuación mínima de confianza (0.0–1.0, por defecto 0.0)
min_score	float	Puntuación mínima de señal (por defecto 0.0)
band	string	Filtra por banda de calidad de trading: A+, A, B, C, D
min_trade_quality	float	Puntuación mínima de calidad de trading (0.0–1.0, por defecto 0.0)
proven_only	bool	Solo tipos de señal probados que baten a BTC (alpha) y son rentables por dirección (por defecto false)
tradeable_only	bool	Solo señales con conviction=strong (por defecto false)

Respuesta - Plan gratuito

{
  "count": 3,
  "signals": [
    {
      "id": 195,
      "asset": null,
      "signal_type": "regulatory",
      "direction": "neutral",
      "urgency": "medium",
      "summary": "Senate Banking Committee scheduled to vote on the Clarity Act crypto bill.",
      "confidence": 0.15,
      "conviction": "watch",
      "action_hint": "monitor",
      "corroborated": false,
      "score": 0.27,
      "trade_quality_score": 0.61,
      "trade_quality_band": "B",
      "expected_move_pct": null,
      "regime_at_signal": "risk-off",
      "timestamp": 1778555605,
      "expires_at": 1778570005,
      "type_performance": {
        "excess_pct": 0.3,
        "hit_rate": 0.08,
        "proven": false,
        "n": 398
      },
      "disclaimer": "Analytical data only. Not financial advice."
    },
    {
      "id": 196,
      "asset": "ETH",
      "signal_type": "sentiment",
      "direction": "bearish",
      "urgency": "high",
      "summary": "Sharp negative social shift on ETH as funding flips and large holders trim.",
      "confidence": 0.71,
      "conviction": "strong",
      "action_hint": "trade_signal",
      "corroborated": true,
      "score": 1.38,
      "trade_quality_score": 0.74,
      "trade_quality_band": "A",
      "regime_at_signal": "risk-off",
      "timestamp": 1778555800,
      "expires_at": 1778570200,
      "reference_price": 3210,
      "invalidation_level": 3274.2,
      "target_level": 3081.6,
      "levels_basis": "model",
      "type_performance": {
        "excess_pct": 4.96,
        "hit_rate": 0.61,
        "proven": true,
        "n": 1016
      },
      "historical_edge": {
        "cell": "sentiment|bearish|risk-off",
        "sample_n": 36,
        "win_rate": 0.97,
        "avg_pnl_pct": 7.19,
        "median_pnl_pct": 6.9,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "disclaimer": "Analytical reference levels for informational purposes only. Not a recommendation to buy or sell, and not financial advice."
    },
    {
      "id": 197,
      "asset": "BTC",
      "signal_type": "regulatory",
      "direction": "bullish",
      "urgency": "medium",
      "summary": "Industry group endorses ETF approval extension; broader institutional access expected.",
      "confidence": 0.45,
      "conviction": "notable",
      "action_hint": "alert",
      "corroborated": true,
      "score": 0.81,
      "trade_quality_score": 0.52,
      "trade_quality_band": "C",
      "regime_at_signal": "squeeze",
      "timestamp": 1778556100,
      "expires_at": 1778570500,
      "type_performance": {
        "excess_pct": -2.1,
        "hit_rate": 0.04,
        "proven": false,
        "n": 352
      },
      "historical_edge": {
        "cell": "regulatory|bullish|squeeze",
        "sample_n": 128,
        "win_rate": 0,
        "avg_pnl_pct": -4.91,
        "median_pnl_pct": -4.65,
        "as_of": "2026-05-27T02:09:02+00:00"
      },
      "paired_inverse": {
        "direction": "bearish",
        "basis": "historical_anti_predictive_cell",
        "implied_avg_pnl_pct": 4.91,
        "flipped_cell_stats": {
          "n": 14,
          "win_rate": 0.93,
          "avg_pnl_pct": 3.92
        },
        "advisory_text": "Historical 0% win rate (128 samples) on bullish regulatory in squeeze regime suggests fade. Not a recommendation — informational only.",
        "citation": "De Bondt & Thaler 1985 JoF; Tetlock 2007 JoF; Chan 2003. Short-term overreaction to dramatic news reverses on horizon of days–weeks. Crypto: PLOS One 2024."
      },
      "disclaimer": "Analytical data only. Not financial advice."
    }
  ],
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

Añadidos del plan Pro

Cada objeto de señal incluye estos campos adicionales:

{
  "sources": [
    "news",
    "whale"
  ],
  "source": "news",
  "channel": "google_crypto"
}

Campos de señal

Campo	Tipo	Descripción
id	int	ID único de la señal
asset	string|null	Símbolo de ticker o null si es de todo el mercado
signal_type	string	regulatory, whale, whale_position, sentiment, price, hack, listing, unlock, research, macro, macro_flow, macro_pulse, liquidation, funding, deleverage, other
direction	string	bullish, bearish, neutral
urgency	string	high, medium, low
summary	string	Descripción de máx. 100 caracteres
confidence	float	0.0-1.0, P(ganar) calibrada — tasa de acierto empírica por tipo de señal, agrupada en tramos, a partir de resultados de operaciones cerradas (no una puntuación LLM en bruto). Se actualiza semanalmente.
conviction	string	strong, notable, watch, none — nuestra valoración analítica de la fuerza de una señal (no una instrucción de trading). strong se basa en datos: solo aplica a los tipos de señal cuyo registro medido de retorno futuro supera nuestro umbral estadístico (ver /proof), en la parte alta de la distribución de puntuación de ese tipo, y solo cuando el movimiento esperado supera el coste de ida y vuelta (un movimiento demasiado pequeño para batir comisiones + slippage se degrada a notable). Usa este campo.
action_hint	string	Obsoleto — el nombre anterior de conviction (trade_signal↔strong, alert↔notable, monitor↔watch, ignore↔none). Aún se emite en esta versión por compatibilidad; se eliminará. Migra a conviction.
corroborated	bool	True cuando múltiples fuentes confirman el activo Y las lecturas recientes no contradicen netamente la dirección (consciente de la dirección — una llamada bullish no se confirma con charla bearish sobre la misma moneda)
score	float	Compuesto ponderado por IC: source_weight x urgency x calibrated_confidence x coeficiente de información del tipo de señal
timestamp	int	Epoch Unix (segundos)
expires_at	int	Cuándo expira esta señal
sources	array	Solo Pro - Nombres de las fuentes que contribuyeron
source	string	Solo Pro - Nombre de la fuente primaria
channel	string	Solo Pro - Canal/feed específico
trade_quality_score	float	calidad de señal compuesta de 0.0–1.0 (régimen + confianza + corroboración)
trade_quality_band	string	banda de calidad A+/A/B/C/D — A+ ≥ 0.85, A ≥ 0.70, B ≥ 0.55, C ≥ 0.40
expected_move_pct	float|null	Tamaño de movimiento estimado como % del precio, basado en el delta S/R más cercano + ATR
type_performance	object	El registro medido de este tipo de señal: {excess_pct, hit_rate, proven, n} — retorno futuro frente a BTC (alpha) a 1h, tasa de acierto, flag de probado, tamaño de muestra
reference_price	float	solo trade_signal — precio de referencia algorítmico (analítico, no una recomendación de entrada)
invalidation_level	float	solo trade_signal — precio que falsaría la tesis de la señal
target_level	float	solo trade_signal — objetivo analítico más cercano en la dirección de la señal
levels_basis	string	solo trade_signal — sr_touches (S/R del libro de órdenes) o model (derivado)
resistance_low / resistance_high	float	La banda de zona del nivel de resistencia (el S/R es un área, no una línea) — el rango de precio del clúster de toques. Apunta al borde de la zona, no al punto medio.
support_low / support_high	float	La banda de zona del nivel de soporte — la misma idea en el lado del soporte.
resistance_flipped / support_flipped	bool	Inversión de polaridad: true cuando este nivel tenía originalmente el rol opuesto y el precio lo ha atravesado desde entonces (un soporte antiguo actuando ahora como resistencia, o viceversa). Un nivel invertido es real, pero conlleva un peso de fuerza ligeramente menor.
regime_at_signal	string	Régimen de mercado cuando se generó la señal: risk-on, risk-off, range, squeeze
manipulation_score	float	probabilidad de coordinación/manipulación de 0.0–1.0 en el momento de creación de la señal
wallet_type	string|null	Solo señales de ballena — vc_institutional, smart_whale, market_maker, mev_arb, sniper, etc.
smart_money_score	float|null	Solo señales de ballena — credibilidad de la wallet de origen (0.0–1.0)
trust_score	float|null	Señales de launchpad/token — confianza de contrato compuesta (0.0–1.0)
rug_probability	float|null	Señales de launchpad/token — probabilidad estimada de rug/estafa (0.0–1.0)
is_honeypot	bool|null	Señales de launchpad/token — flag de honeypot de GoPlus
historical_edge	object|null	Estadísticas descriptivas de la celda (signal_type × direction × regime_at_signal) de esta señal, a partir de retornos futuros medidos de señales. Objeto: {cell, sample_n, win_rate, avg_pnl_pct, median_pnl_pct, as_of}. Se refresca semanalmente. Null cuando falta el régimen o el tipo.
paired_inverse	object|null	Aviso de dirección contraria. Presente solo cuando la celda histórica es empíricamente anti-predictiva (n ≥ 30, win_rate ≤ 30%, avg_pnl ≤ -2%). Objeto: {direction, basis, implied_avg_pnl_pct, flipped_cell_stats, advisory_text, citation}. Cita literatura revisada por pares sobre reversión a corto plazo (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Informativo; nunca una recomendación de trading.

Edge histórico e inverso emparejado

Cada señal lleva un objeto historical_edge que describe los retornos futuros medidos de señales pasadas en la misma celda (signal_type × direction × regime_at_signal). Las estadísticas se refrescan semanalmente. Los campos son descriptivos — no filtran, dimensionan ni recomiendan.

Cuando una celda es empíricamente anti-predictiva (n ≥ 30 operaciones cerradas, tasa de acierto ≤ 30%, PnL medio ≤ -2%), la señal también lleva un objeto paired_inverse. Aflora la lectura de dirección contraria del mismo evento junto a una cita de literatura revisada por pares sobre reversión a corto plazo (De Bondt & Thaler 1985, Tetlock 2007, Chan 2003, PLOS One 2024). Se presenta como dato, no como recomendación: el campo flipped_cell_stats muestra cómo ha rendido realmente la celda de dirección opuesta históricamente, que a menudo es más débil de lo que sugeriría el implied_avg_pnl_pct en términos de pura inversión.

Usa estos campos para interpretar la calidad de la señal en contexto. Una señal con un historical_edge fuerte (win_rate alto, avg_pnl_pct grande, sample_n grande) es más fiable que la misma señal en una celda donde el edge es débil o invertido. Las estadísticas de la celda y cualquier aviso inverso emparejado están destinados a tu propio análisis — no son recomendaciones de trading, y no sugerimos tamaños de posición ni apalancamiento.

GET /levels/{coin}

Devuelve el soporte/resistencia más cercano del libro de órdenes de Hyperliquid — como zonas (cada nivel lleva su banda de precio), con seguimiento de inversión de polaridad (un soporte roto se muestra como resistencia, y viceversa).

{
  "coin": "BTC",
  "current_price": 81262.5,
  "nearest_resistance": 81450,
  "nearest_support": 80871,
  "all_resistance": [
    81450,
    81800,
    82200,
    82500,
    83000
  ],
  "all_support": [
    80871,
    80500,
    80000,
    79500,
    79000
  ]
}

GET /market-opens

Precios de apertura de BTC, ETH y SOL en cada sesión principal de trading.

{
  "market_opens": {
    "tokyo": {
      "BTC": 81150,
      "ETH": 3200.5,
      "SOL": 96.3,
      "timestamp": 1778539200
    },
    "shanghai": {
      "BTC": 81180,
      "ETH": 3202,
      "SOL": 96.35,
      "timestamp": 1778542800
    },
    "hong_kong": {
      "BTC": 81190,
      "ETH": 3203.5,
      "SOL": 96.4,
      "timestamp": 1778542800
    },
    "london": {
      "BTC": 81201.5,
      "ETH": 3205,
      "SOL": 96.48,
      "timestamp": 1778553600
    },
    "new_york": {
      "BTC": 81262.5,
      "ETH": 3210,
      "SOL": 96.55,
      "timestamp": 1778560800
    }
  }
}

GET /macro

Condiciones macro — un compuesto determinista diario de liquidez neta (balance de la Fed − TGA − RRP), el índice del dólar, tipos reales, la curva 2s10s, M2 y VIX, combinado con el próximo calendario de alto impacto y la inteligencia reciente. La respuesta de /macro siempre lleva el compuesto y los drivers; el sesgo por activo se incluye solo cuando su modelo de soporte está disponible y, de lo contrario, se retiene explícitamente.

El objeto current de nivel superior contiene el último informe. Añade ?history=N (Pro, máx 30) para incluir instantáneas previas; las cuentas gratuitas reciben solo el informe actual. Bias y conviction son anulables y se retienen explícitamente cuando los datos de soporte son insuficientes.

{
  "current": {
    "generated_at": "2026-07-16T07:00:00+00:00",
    "window_days": 7,
    "horizon": "week",
    "regime": "range",
    "calibration": "uncalibrated",
    "btc": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 3,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "eth": {
      "bias": null,
      "conviction": null,
      "status": "insufficient data",
      "sample_size": 2,
      "sufficient_data": false,
      "reason": "Per-asset directional bias withheld until live sample coverage is sufficient."
    },
    "calendar_risks": [],
    "disclaimer": "AI-generated macro commentary; directional conviction is not calibrated. Not financial advice."
  }
}

Referencia de campos

Campo	Tipo	Descripción
regime	string	risk-on, risk-off, range, squeeze
regime_reason	string	justificación de ≤120 caracteres
current.btc.bias / current.eth.bias	string | null	bullish, bearish, neutral, o null cuando se retiene por datos insuficientes
current.btc.conviction / current.eth.conviction	float | null	Confianza de 0.0–1.0 declarada por el modelo, o null cuando se retiene; no es una probabilidad realizada calibrada
btc.reason / eth.reason	string	Driver principal, ≤140 caracteres
btc.key_levels / eth.key_levels	string	Pivotes macro relevantes
btc.invalidation / eth.invalidation	string	Qué invalida la llamada
calendar_risks	array	Los 1–3 principales eventos próximos que podrían invertir el sesgo
window_days	int	Ventana de retroceso (7 diario / 30 semanal)
horizon	string	Etiqueta de horizonte futuro (p. ej. «week», «next two weeks»)
generated_at	string	ISO-8601 UTC. Obsoleto tras 36h — los clientes deberían volver a consultar.

Endpoints de autenticación

POST /auth/register

Crea una cuenta nueva. Devuelve una API key de inmediato.

{
  "api_key": "intel_sk_a1b2c3d4e5f6...",
  "key_prefix": "intel_sk",
  "tier": "free",
  "message": "Save your API key - it will not be shown again."
}

POST /auth/login

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "tier": "free",
  "api_keys": [
    {
      "id": 1,
      "prefix": "intel_sk_a1b2",
      "name": "default",
      "created_at": 1778555605
    }
  ]
}

WebSocket /stream

Solo plan Pro. Conéctate para recibir señales en tiempo real.

wss://api.n0brains.com/stream?api_key=intel_sk_...

Signal received:
{"type": "signal", "data": {"id": 195, "asset": "BTC", "signal_type": "whale", "direction": "bullish", "urgency": "high", "summary": "Strategy buys 535 BTC for $43M", "confidence": 0.95, "score": 1.42, "trade_quality_band": "A", "regime_at_signal": "risk-on"}}

Ping/pong:
send: "ping"
recv: {"type": "pong", "timestamp": 1778555605}

Webhooks

Solo plan Pro. Registra una URL para recibir entregas POST de señales nuevas.

POST /webhooks

{
  "id": 1,
  "url": "https://your-server.com/hooks/n0brains",
  "secret": "a1b2c3d4...",
  "events": "signal.created",
  "note": "Use X-Intel-Signature header to verify deliveries. Secret is shown only once."
}

Formato de entrega

Haz POST a tu URL con la cabecera X-Intel-Signature:

{
  "event": "signal.created",
  "timestamp": 1778555605,
  "data": {
    "id": 195,
    "asset": "BTC",
    "signal_type": "whale",
    "direction": "bullish",
    "urgency": "high",
    "summary": "Strategy buys 535 BTC for $43M",
    "confidence": 0.95,
    "score": 1.42,
    "trade_quality_band": "A",
    "regime_at_signal": "risk-on"
  }
}

Fuentes de datos y puntuación

El pipeline ingiere de los watchers listados abajo. Cada fuente lleva un peso que se multiplica en la puntuación final de la señal — así que lo que lees no es un volcado en bruto del feed, es un único número corroborado y clasificado.

score = source_weight × urgency_weight × confidence_decayed

Pesos de urgencia: low: 1.0, medium: 2.0, high: 3.0

Decaimiento de confianza: la confianza se degrada exponencialmente con la edad. confidence_decayed = confidence₀ × exp(−age / τ) donde τ = vida media / ln(2) por tipo de señal (liquidation: ~43min, hack/sentiment/listing: ~2.9h, whale/price/funding: ~8.7h, regulatory: ~5.8h, macro: ~11.5h, macro_pulse: ~34.6h). Una señal obsoleta tiene una puntuación menor que una fresca de idéntica calidad.

Autoajuste del peso de fuente: los pesos se ajustan por EMA a diario según las tasas de acierto de resultados rastreados. Las fuentes que aciertan se impulsan hasta 1.4×; las que rinden por debajo se atenúan a 0.6×. Mínimo 10 resultados antes del ajuste.

Watchers activos

1. Telegram - WatcherGuru, ZachXBT Investigations, yoyodexhaber, sondakikav
2. News RSS - 15 feeds (Reuters, AP, BBC, CNBC, Bloomberg, CoinDesk, CoinTelegraph, Decrypt, Google News, etc.)
3. Government RSS - 11 feeds (White House, SEC, CFTC, Fed, Kremlin, Xinhua, TASS, EU, etc.)
4. CoinMarketCap - Alertas de precio, monedas en tendencia
5. Macro - Fear and Greed Index, DeFi TVL
6. Derivatives - Posicionamiento de funding/interés abierto en múltiples venues e impresiones públicas de liquidación de OKX
7. Market Opens - Precios de BTC/ETH/SOL en las aperturas de sesión de Tokio, Shanghái, Hong Kong, Londres y Nueva York
8. Exchange Listings - Catalizadores reales de listados en CEX: launchpad/launchpool de Binance & Bybit, más detección de nuevos mercados spot (diff de lista de símbolos) en Binance, Upbit (Corea / kimchi premium) y OKX. Los lanzamientos de memecoins de Pump.fun / Raydium se descartaron — eran ~98% del antiguo feed de listados sin edge negociable.
9. ETF Flows - Flujos netos diarios de ETF spot de BTC + ETH + SOL en EE. UU. vía SoSoValue (API pública gratis). Emitido como contexto (macro_flow, no direccional): un backtest halló que la entrada neta a ETF no predice retornos futuros — es una impresión de demanda coincidente/rezagada (las entradas de SOL fueron contrarias).
10. Stablecoin Flows - Deploy/redención del Tesoro de USDT/USDC + entrada neta preparada hacia wallets de exchange, más la tendencia del suministro total de stablecoins (DeFiLlama). Una lectura adelantada de liquidez (la entrada de stablecoins a exchanges adelanta los retornos de BTC/ETH a corto horizonte en nuestros datos); el suministro agregado es contexto de dry-powder.
11. On-Chain Valuation - Coin Metrics (gratis): MVRV, entradas/salidas de exchanges + reservas, direcciones activas (BTC + ETH). SALIDA neta de exchanges / reservas en descenso = acumulación en autocustodia; MVRV mapea el beneficio/euforia del ciclo. Alimenta la pata on-chain del compuesto Macro Pulse; se emite como contexto.
12. Token Unlocks - Calendario de emisiones de DeFiLlama (gratis). Desbloqueos materiales a corto plazo (acantilados de insiders/inversores) en tokens negociables = suministro programado que los vendedores anticipan → señal unlock, bearish. Se autoprueba mediante la puerta de retorno futuro.
13. TradFi & CME - Yahoo Finance (gratis): gap de futuros de BTC/ETH de CME (los gaps de fin de semana tienden a rellenarse — una lectura de nivel recurrente) más contexto de correlación entre activos SPX/oro.
14. Smart Money - WebSocket de ETH de Alchemy (alchemy_pendingTransactions) sobre 408 wallets curadas + respaldo de tx confirmadas de Etherscan V2. Más de 700 direcciones etiquetadas verificadas (CEX hot/cold, market maker, institucional, smart trader) actualizadas semanalmente desde la nube de etiquetas de Etherscan + barrido de mayor volumen de Alchemy. Bots MEV filtrados.
15. Stealth Accumulation - Un escáner en segundo plano extrae tokentx de Etherscan V2 por wallet rastreada cada 30 min. Marca una wallet que recibe el mismo ERC20 en ≥3 compras fragmentadas por un total ≥$500K en 24 h — detecta acumulación silenciosa antes que los feeds de alertas de ballenas.
16. On-Chain Whale Tracking - Grandes transferencias de ETH hacia/desde exchanges vía WebSocket de Alchemy, más consenso del leaderboard de Hyperliquid de los mejores traders.
17. L/S Ratios - Datos de posicionamiento de Bybit, Binance, Gate.io
18. S/R Levels - Soporte/resistencia en tiempo real desde el libro de órdenes de Hyperliquid
19. Macro Conditions - Compuesto macro determinista diario de FRED y contexto de calendario de alto impacto; sesgo por activo solo cuando está disponible.
20. X (Twitter) API - Lanes en vivo verificadas vía la API oficial X v2: investigación on-chain (@lookonchain, @spotonchain, @arkham), anuncios oficiales de exchanges (@binance, @coinbase, @CoinbaseAssets, @upbit_global) y contexto macro/noticias activo (@DBdaily). Las cuentas retiradas o silenciosas se excluyen de las expectativas de salud y de las afirmaciones públicas sobre fuentes. Retweets y respuestas se filtran.

Pesos de fuente

Fuente	Peso	Justificación
gov_news	1.3	Eventos regulatorios/de política que mueven el mercado
smart_money	1.2	Seguimiento de direcciones on-chain (Alchemy + Etherscan, 408 wallets)
stealth_accumulation	1.4	Compras silenciosas fragmentadas (≥3 tx, ≥$500K, ventana de 24h)
whale_eth	1.1	Grandes transferencias de ETH (Alchemy WS, ≥1000 ETH)
telegram:investigations	1.2	Inteligencia de hack/exploit de alta señal
x:lookonchain	1.5	Movimientos de wallets on-chain con hashes de tx — indicador adelantado
x:binance / x:coinbase	1.5	Anuncios oficiales de listados de exchanges
x:spotonchain / x:arkham	1.4	Analítica on-chain, wallets etiquetadas
x:CoinbaseAssets	1.4	Filtraciones de la hoja de ruta de listados de Coinbase
x:upbit_global	1.3	Listados en Corea, catalizador de kimchi premium
x:DBdaily	0.9	Seguimiento de adopción corporativa
binance_funding	1.0	Datos primarios del exchange
liquidation	1.0	Datos de liquidación de múltiples venues
cmc_price	0.9	Alertas de precio de CoinMarketCap
telegram:WatcherGuru	0.9	Noticias de última hora rápidas
rss:trumpstruth	0.9	Relevante para el mercado pero ruidoso
rss:coindesk	0.8	Medio consolidado
cex_listing	0.8	Listados reales de exchanges (Binance/Bybit/Upbit/OKX)
rss:cointelegraph	0.7	Noticias generales de cripto
rss:decrypt	0.7	Noticias generales de cripto
market_open	0.6	Precios de apertura de sesión
macro_fearGreed	0.6	Índice de sentimiento
rss:reddit_crypto	0.5	señal de la comunidad r/CryptoCurrency
rss:reddit_btc	0.5	señal de la comunidad r/Bitcoin
dexscreener	0.2	Solo enriquecimiento
Por defecto (no listado)	0.5	-

GET /signals/similar

Solo plan Pro. Búsqueda semántica del vecino más cercano en todas las señales usando embeddings vectoriales BGE-M3. Encuentra señales relacionadas por significado — no solo por coincidencia de palabras clave.

Parámetros de consulta

Param	Tipo	Descripción
coin	string	Opcional — filtra los resultados a este ticker de activo
q	string	Consulta de texto libre (por defecto el nombre de la moneda si se omite)
k	int	Número de resultados (por defecto 5, máx 20)

[
  {
    "id": 182,
    "similarity": 0.97,
    "summary": "BTC whale | bullish | high | Strategy loads 420 BTC at open",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "high",
      "score": 1.38,
      "timestamp": 1778551200
    }
  },
  {
    "id": 178,
    "similarity": 0.94,
    "summary": "BTC whale | bullish | medium | Institutional wallet accumulates 310 BTC",
    "metadata": {
      "asset": "BTC",
      "signal_type": "whale",
      "direction": "bullish",
      "urgency": "medium",
      "score": 1.1,
      "timestamp": 1778548800
    }
  }
]

GET /narrative/{coin}

Solo plan Pro. Momentum narrativo continuo de un activo — cuántas señales se han disparado, a qué velocidad, desde cuántas fuentes independientes y si se detecta un patrón de coordinación.

{
  "coin": "BTC",
  "narrative_strength": 0.74,
  "narrative_velocity": 3.2,
  "narrative_decay_rate": 0.18,
  "manipulation_probability": 0.12,
  "dominant_direction": "bullish",
  "direction_conviction": 0.81,
  "source_diversity": 4,
  "signal_count_1h": 7,
  "signal_count_4h": 19,
  "signal_count_24h": 42,
  "disclaimer": "Analytical data only. Not financial advice."
}

Referencia de campos

Campo	Tipo	Descripción
narrative_strength	float	volumen de señal ponderado de 0.0–1.0 en 24h
narrative_velocity	float	Ritmo de señales nuevas por hora en la ventana de 1h
narrative_decay_rate	float	Con qué rapidez cae el volumen de señal (0 = creciendo, 1 = frío)
manipulation_probability	float	0.0–1.0. Se eleva si ≥3 tipos de fuente independientes disparan en la misma dirección en 5 min
dominant_direction	string	bullish, bearish o neutral (voto mayoritario en la ventana)
direction_conviction	float	Fracción de señales que coinciden con la dirección dominante
source_diversity	int	Número de tipos de fuente distintos en la ventana de 1h
signal_count_1h / 4h / 24h	int	Conteo bruto de señales por ventana móvil

GET /manipulation/{coin}

Solo plan Pro. Puntuación de manipulación compuesta para un activo. Combina las subpuntuaciones de estallido social, pump coordinado y cascada de liquidaciones.

{
  "coin": "ETH",
  "manipulation_score": 0.34,
  "social_burst_score": 0.2,
  "coordinated_pump_score": 0.5,
  "liquidation_cascade_score": 0.1,
  "flags": [
    "coordinated_pump"
  ],
  "disclaimer": "Analytical data only. Not financial advice."
}

Referencia de campos

Campo	Tipo	Descripción
manipulation_score	float	Compuesto: social_burst×0.30 + coordinated_pump×0.45 + liq_cascade×0.25
social_burst_score	float	Se eleva si el conteo de señales sociales es ≥5× la línea base de 10 min
coordinated_pump_score	float	Se eleva si ≥4 prefijos de fuente distintos disparan en la misma dirección en 10 min
liquidation_cascade_score	float	Se eleva si hay ≥3 señales de liquidación para la moneda en 15 min
flags	array	Flags activos: social_burst, coordinated_pump, liquidation_cascade

GET /trust/{coin}

Solo plan Pro. Puntuación de confianza y estafa para un ticker de token. Resuelve el ticker a una dirección de contrato vía DexScreener, luego consulta GoPlus Security para ver flags de contrato. Los resultados se cachean 6 horas por dirección de token.

{
  "asset": "PEPE",
  "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
  "chain_id": "1",
  "trust_score": 0.82,
  "rug_probability": 0.18,
  "contract_risk": 0.1,
  "insider_pct": 0.04,
  "is_honeypot": false,
  "is_mintable": false,
  "sell_tax": 0,
  "low_liquidity": false,
  "liquidity_usd": 4820000,
  "flags": [],
  "data_source": "goplus",
  "computed_at": 1778555605,
  "disclaimer": "Analytical data only. Not financial advice."
}

Referencia de campos

Campo	Tipo	Descripción
trust_score	float	1.0 − rug_probability. Más alto = más seguro.
rug_probability	float	Compuesto: contract_risk×0.60 + liquidity_risk×0.20 + vol_liq_risk×0.10 + signal_history_risk×0.10
contract_risk	float	Derivado de GoPlus. Suma: honeypot (+0.50), mintable (+0.20), owner_can_change_balance (+0.25), upgradeable_proxy (+0.10), high_sell_tax, insider_pct
insider_pct	float	Porcentaje combinado de tokens en manos del creador + propietario
is_honeypot	bool	Flag de honeypot de GoPlus — el token no puede venderse
is_mintable	bool	El contrato puede acuñar suministro nuevo ilimitado
sell_tax	float	Impuesto de la transacción de venta (0.10 = 10%)
low_liquidity	bool	True si liquidity_usd < $50,000
flags	array	Flags de riesgo de contrato activos de GoPlus
data_source	string	goplus, dexscreener, signal_history_only, or none

Respuestas de error

// 401 Unauthorized
{"detail": "Invalid API key"}

// 429 Rate Limited
{"detail": "Rate limit exceeded (60 req/min for free tier). Upgrade at https://n0brains.com"}

// 404 Not Found
{"detail": "Signal not found"}

// 403 Forbidden
{"detail": "WebSocket requires Pro tier"}