Smart Money API

Principios de diseño

Cuatro ideas dan forma a cada endpoint y a cada puntuación que devuelve esta API. También son los límites honestos de lo que promete — y no promete.

Primero la estrategia, no primero la señal. Esto no es un feed de señales de compra/venta. Tú traes la estrategia y la entrada; la API te dice si la estructura del mercado circundante — posicionamiento de derivados, financiación, interés abierto, liquidaciones, flujo on-chain y consenso de ballenas — está de acuerdo con la operación que ya quieres realizar.

Puntuación de confianza, no predicción binaria. Cada respuesta lleva una calificación confidence (ALTA / MEDIA / BAJA) y una composite de -1.0 a +1.0. No hay garantías ni llamadas de oráculo — obtienes una lectura calibrada de acuerdo, con las razones detrás de ella, para que puedas dimensionar proporcionalmente a tu convicción.

Apoyo a la decisión, no consejo de ejecución. La API devuelve una recomendación CONFIRMAR / REDUCIR / OMITIR y un multiplicador de tamaño para tu lógica para actuar. Nunca coloca órdenes, y nada aquí es consejo financiero. Tú sigues siendo responsable del riesgo, el tamaño y la ejecución.

Métricas vivas, no garantías fijas. Las tasas de acierto, estadísticas de régimen y cifras de precisión se calculan a partir de una muestra móvil y cambian a medida que los mercados se mueven. Las publicamos honestamente, incluso cuando son mediocres. Trata cada métrica como una observación actual, no como una promesa sobre el futuro.

Para quién es esta API

Esta API está diseñada para desarrolladores de bots, algoritmos y agentes de IA en cripto que ya tienen una señal de compra/venta — desde una estrategia de TA, un modelo de ML, un pipeline de Freqtrade, una alerta de TradingView o un agente LLM — y desean una decisión rápida previa a la operación CONFIRMAR / REDUCIR / OMITIR antes de comprometer capital.

Un ciclo típico: tu estrategia emite "compra BTC" → llamas GET /v1/confirm?symbol=BTC&direction=long → confirmas, reduces u omites la entrada y ajustas el tamaño por size_mult. Una llamada, una única respuesta JSON de baja latencia, sin infraestructura adicional.

Es no un generador de señales independiente, un producto de gráficos o un lugar de ejecución. Si no tienes tu propia señal para filtrar, comienza con la página de rendimiento para ver cómo se ha comportado la puntuación antes de integrarla en un bot en vivo.

Obtener acceso

1 — Regístrate. Crea una cuenta gratuita en signup (correo electrónico/contraseña o Google). No se requiere tarjeta de crédito para el nivel gratuito.

2 — Abre tu panel de control. Tu panel de control muestra tu clave API, plan actual y uso en vivo frente a tu cuota diaria.

3 — Copia tu clave API. Las claves tienen el prefijo sm_. Pásala como el X-API-Key encabezado en cada solicitud (ver Autenticación). Actualiza en cualquier momento en el página de precios para aumentar los límites y desbloquear más símbolos y endpoints.

Especificación, SDK y Libro de recetas

Todo lo que necesitas para integrarte rápidamente, ya sea que escribas el código tú mismo o lo delegues a un agente de programación.

Inicio rápido en 2 minutos

Paso 1 — URL base. Cada endpoint está bajo:

Paso 2 — Obtén tu clave API. Regístrate gratis (no se requiere tarjeta de crédito) y copia tu clave desde el panel de control. Pásala como el X-API-Key encabezado en cada solicitud.

Paso 3 — Tu primera llamada. Pega esto en tu terminal y reemplaza sm_your_key con la clave de tu panel de control:

Respuesta esperada:

Cuando confidence es HIGH o MEDIUM y action es CONFIRM, escala el tamaño de tu posición por size_mult. Ese es todo el ciclo de integración. Consulta Campos de respuesta para la referencia completa de campos.

Autenticación

Todas las solicitudes requieren una clave API proporcionada en la X-API-Key cabecera HTTP.

Tu clave API está disponible en el panel de control después de registrarte. Mantén tu clave en secreto — no la expongas en código del lado del cliente o repositorios públicos.

Inicio de sesión con Google (Firebase Auth)

Los usuarios pueden autenticarse usando su cuenta de Google mediante Firebase Authentication. Después de un inicio de sesión exitoso con Google en el cliente, intercambia el token de ID de Firebase por una sesión API vinculada. El sistema sincroniza automáticamente tu identidad de Google con el sistema de claves API.

Cuerpo de la solicitud

Ejemplo de respuesta

Límites de tasa

Los encabezados de límite de tasa están incluidos en cada respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.

URL base

Todos los endpoints a continuación son relativos a esta URL base. Todas las respuestas son JSON con Content-Type: application/json.

Errores

Los errores utilizan códigos de estado HTTP estándar y un cuerpo JSON consistente. Siempre bifurque según el código de estado, no según el texto de la respuesta. Los tres que encontrará con más frecuencia:

Cada error devuelve la misma forma:

Para la lista completa de códigos de estado (400 / 403 / 500 / 503 y más), consulte Códigos de error. Una integración robusta trata los 5xx y 429 como transitorios (reintentar con retroceso) y 401/402/403 como terminales (corregir la clave o el plan).

Mejores prácticas de seguridad

Envíe la clave en el encabezado, nunca en la URL. Siempre pase X-API-Key como un encabezado HTTP. Las claves en las cadenas de consulta (?key=) se registran por proxies, balanceadores de carga y el historial del navegador — la autenticación ?key= legacy ya no se acepta en los endpoints WebSocket por esta misma razón.

Mantenga las claves del lado del servidor. Nunca incruste una clave API en JavaScript del lado del cliente, un paquete de aplicación móvil o un repositorio público. Cárguela desde una variable de entorno o un administrador de secretos. Si una clave se filtra, rótela.

Rote las claves periódicamente. Regenere su clave desde el panel de control según un horario e inmediatamente si sospecha exposición. La clave antigua deja de funcionar en el momento en que se emite una nueva.

Use boletos para sockets de navegador. Para transmisiones en tiempo real desde el navegador, intercambie su clave por un boleto de un solo uso en lugar de conectarse con la clave cruda — consulte Autenticación WebSocket (boletos).

Uso con agentes de codificación / LLMs

¿Está construyendo con Claude Code, Codex, Cursor o cualquier agente de codificación LLM? Puede entregarle al agente todo lo que necesita para conectar esta API correctamente de una vez. Se publican dos referencias legibles por máquina:

Dirija su agente al /llms.txt archivo (la convención llms.txt) para obtener una descripción general concisa, luego a la especificación OpenAPI para obtener las formas exactas de solicitud/respuesta. Un mensaje de una línea que funciona bien:

Consulte el Libro de recetas para obtener una receta trabajada de agente de codificación.

Endpoints

GET  /confirm

El endpoint principal. Devuelve una puntuación de confianza compuesta y una recomendación de acción para una dirección de comercio dada. Llame a esto antes de ingresar a cualquier posición.

Cobertura, en términos simples. /confirm actualmente puntúa BTC, ETH y SOL — los símbolos con suficiente historial resuelto para confirmar honestamente. El filtro de derivados por separado monitorea ~519 mercados de derivados para datos de financiamiento, OI y liquidación, y el seguimiento de ballenas cubre más de 600 billeteras. Pro desbloquea el filtro completo, exportaciones y una cobertura de mercado más amplia; /confirm el soporte de símbolos se expande a medida que cada mercado acumula un historial confiable.

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

Transparente por diseño. Cada respuesta incluye un factors objeto que muestra el puntuación × peso = contribución ponderada, un adjustments objeto para ajustes posteriores al filtro, el weights utilizado, y un coverage mapa. La parte onchain utiliza datos gratuitos en tiempo real de Coin Metrics (MVRV / flujo de intercambio / direcciones activas) cuando no se establece una clave de Glassnode. Este es un puntaje de confluencia multifactorial — soporte para decisiones, no una tasa de ganancia garantizada.

Los símbolos no rastreados son honestos. Un símbolo fuera del universo rastreado de derivados/ballenas devuelve una "confidence":"NO_DATA" / "action":"NO_DATA_SKIP" explícita "unsupported":true — nunca una LOW.

Campos de respuesta

GET  /snapshot

Devuelve una instantánea completa del mercado, incluyendo todas las subpuntuaciones, métricas brutas y valores de indicadores para un símbolo dado. Útil para paneles de control y registro.

GET  /onchain

Devuelve métricas en cadena sin procesar: MVRV, SOPR, flujo neto en exchanges, ratio de capitalización realizada y clasificación de posición en el ciclo.

GET  /v1/derivatives/*

Monitor de derivados multiplataforma con más de 500 símbolos: mapa de calor de tasas de financiación, rankings de interés abierto y detección de señales de ratio largo/corto. Las primeras 10 filas son públicas; el monitor completo requiere Trader o Pro. Endpoints: /v1/derivatives/screener, /v1/derivatives/funding, /v1/derivatives/oi, /v1/derivatives/signals.

GET  /v1/options/*

Análisis de opciones de BTC y ETH de Deribit (público, sin autenticación): ratio put/call, máximo dolor e interés abierto por strike. Endpoints: /v1/options/summary, /v1/options/pcr, /v1/options/oi.

GET  /v1/etf/*

Flujos netos diarios de ETFs de BTC y ETH al contado y desglose por fondo (público). Endpoints: /v1/etf/flows, /v1/etf/funds.

GET  /v1/historical/*

Datos históricos de financiación, interés abierto, ratio largo/corto (Binance) y OHLCV (CoinGecko) para backtesting. Endpoints: /v1/historical/funding, /v1/historical/oi, /v1/historical/lsr, /v1/historical/ohlcv.

GET  /v1/dex/*

Pares en tendencia, búsqueda de tokens y detalles de pares con DexScreener (público, sin autenticación). Endpoints: /v1/dex/trending, /v1/dex/search, /v1/dex/token, /v1/dex/pair.

GET  /v1/news/*

Inteligencia de noticias: noticias de políticas/geopolíticas/cripto clasificadas por impacto, más el índice Miedo y Codicia (público, sin autenticación). Endpoints: /v1/news/trump, /v1/news/general, /v1/news/impact, /v1/news/fear-greed.

GET  /whales

Devuelve datos de consenso de carteras de ballenas: división largo/corto, exposición nocional total, top 10 posiciones (solo Pro) y recuento de carteras.

GET  /signals

Devuelve un flujo de las señales HIGH/MEDIUM más recientes en todos los activos monitorizados. Útil para escaneo de oportunidades.

GET  /v1/strategies/*

Registro transparente y de solo lectura para las estrategias de trading automatizado que operan sobre señales Smart Money — incluyendo la deriv40 estrategia SmartMoney Copytrade (account=9). Todos los endpoints aceptan un ?account=<id> parámetro de consulta y devuelven JSON. No requiere autenticación (registro público).

Endpoints

• GET /v1/strategies/stats?account=9 — métricas principales: total_trades, win_rate, profit_factor, total_pnl_usdt, account_growth_percent, initial_equity, current_equity, max_drawdown_portfolio, max_drawdown_trade.
• GET /v1/strategies/equity?account=9 — curva de equidad para gráficos: { initial_equity, curve: [{ time, equity }] }.
• GET /v1/strategies/trades?account=9&limit=500 — libro de operaciones cerradas: array (o {trades:[…]}) de symbol, direction, entry_price, exit_price, pnl_usdt, pnl_percent, pnl_percent_net.
• GET /v1/strategies/active?account=9 — posiciones abiertas actualmente: array (o {positions:[…]}) de symbol, side/direction, entry_price, unrealized_pnl.
• GET /v1/strategies/signals — desglose por tipo de señal que alimenta las estrategias (recuento / ganancias / tasa_ganancias / pnl_medio por tipo de señal).

El rendimiento pasado no es indicativo de resultados futuros. Las cifras se reconstruyen durante un único régimen de ~3 meses más operaciones en vivo y se muestran sin comisiones donde se indica.

GET  /export

Descarga datos históricos de señales en CSV para backtesting. Parámetros: symbol, from (unix ts), to (unix ts).

GET  /health

Verificación del estado del sistema. Devuelve la actualización de datos de cada fuente y el estado general de la API. No requiere autenticación.

GET  /usage

Devuelve tus estadísticas actuales de uso de la API: llamadas hoy, totales mensuales, límites de cuota y tiempos de reinicio.

POST  /webhooks

Registra una URL HTTPS para recibir notificaciones firmadas en tiempo real cuando se active una señal en tus activos monitorizados. Las entregas incluyen un X-SmartMoney-Event encabezado y una firma HMAC-SHA256 en X-SmartMoney-Signature, y se reintentan hasta 3× con retroceso.

Request Body

Verificación de la firma

La clave HMAC es el digesto hexadecimal SHA-256 de tu secreto registrado. Calcula el HMAC-SHA256 del cuerpo de la solicitud en bruto con esa clave y compara (tiempo constante) con X-SmartMoney-Signature. Ver el Guía de implementación de Webhooks.

Inteligencia

GET  /analysis

Devuelve una clasificación de regímenes de mercado impulsada por IA con detección de conflictos de señales. Analiza la concordancia entre señales, identifica divergencias entre datos de derivados, on-chain y de ballenas, y produce un resumen en lenguaje natural con factores de riesgo prospectivos y una recomendación con horizonte temporal.

Parámetros

Ejemplo de respuesta

GET  /liquidations

Devuelve dos vistas complementarias: (1) proyección de apalancamiento levels — una estimación de dónde se ubican los clusters de liquidación; y (2) un realized_heatmap — la REAL ejecutada intensidad de liquidaciones forzadas (precio × tiempo), agregada en tiempo real desde los feeds WebSocket de exchanges públicos: Binance, OKX, Bybit, Bitget, BitMEX. El heatmap está presente cuando el stream tiene datos para el símbolo (ausente en un mercado muy tranquilo o justo después del inicio).

Parámetros

Ejemplo de respuesta

GET  /liquidations/heatmap

Public heatmap de liquidaciones por nivel de precio. Devuelve una matriz estilo Coinglass de precio × tiempo de REAL ejecutadas liquidaciones forzadas, agrupadas por el precio en el que se ejecutó cada liquidación — agregadas en vivo desde los feeds WebSocket de exchanges públicos: Binance, OKX, Bybit, Bitget, BitMEX. El clusters array es la salida práctica: buckets de precio clasificados por notional liquidado, cada uno etiquetado con su lado dominante. Los datos dependen del stream en vivo — un símbolo muy tranquilo o una puerta de enlace recién reiniciada devuelve la estructura vacía bien formada más un note. Los niveles mostrados son siempre liquidaciones reales, nunca estimados.

Parámetros

Ejemplo de respuesta

GET  /liquidations/onchain

Ejecutadas liquidaciones en cadena de préstamos DeFi capturadas directamente desde nuestros propios nodos completos de BSC + Avalanche — independientes de cualquier bot de trading. Cubre Venus/Cream y Moolah en BSC, y AAVE V3/V2, Benqi, BankerJoe, Granary y Vinium en Avalanche. El nivel Pro además devuelve at_risk posiciones (dependiente de bots, puede estar ausente).

Parámetros

Ejemplo de respuesta

GET  /smart-stop

Calcula niveles inteligentes de stop-loss basados en el mapa de calor de liquidación actual, bandas de volatilidad y estructura del mercado. Devuelve recomendaciones de stop escalonadas y sugerencias de toma de ganancias calibradas según tu precio de entrada y tolerancia al riesgo.

Parámetros

Ejemplo de respuesta

GET  /funding-arb

Identifica oportunidades de arbitraje de tasas de financiación entre intercambios en tiempo real. Devuelve oportunidades clasificadas con rendimiento anualizado estimado, par de intercambios óptimo y la acción de cobertura requerida para capturar el spread.

Parámetros

Ejemplo de respuesta

Variante pública gratuita Sin autenticación

Un endpoint público sin clave devuelve las 10 mejores oportunidades con un screener en vivo entre intercambios, ideal para incrustar o comprobaciones rápidas. Omite el historial de spread por símbolo y campos pesados y se sirve desde una caché de 120 segundos. Cuando no existen spreads de financiación entre intercambios en la ventana de frescura, devuelve un opportunities array vacío con un note — nunca datos fabricados.

GET  /smart-money/flow

Un índice direccional ponderado por calidad de ballenas por símbolo, puntuado -100 (dinero de ballenas inclinado a corto) a +100 (inclinado a largo). Construido a partir de miles de carteras de ballenas rastreadas en Hyperliquid — cada una ponderada por su propia tasa de aciertos históricos y PnL, y atenuada por antigüedad. Este es un índice de posicionamiento, no una señal de compra/venta o predicción de precio. Los símbolos con pocas carteras contribuyentes se etiquetan thin y se puntúan honestamente. Página en vivo: smart-money-flow.html.

Parámetros

Ejemplo de Respuesta

GET  /v1/whales/crowding

Contexto combinado de posicionamiento y aglomeración de ballenas por símbolo, fusionado entre Hyperliquid + GMX v2 + Jupiter Perps. Devuelve notional bruto/neto, sesgo direccional, conteo de carteras y venues, concentración de posición (participación top-3 + HHI), un apalancamiento promedio ponderado, y niveles de proximidad a liquidación ($ notional dentro del 5% y 10% de su precio de liquidación estimado, dividido en largo/corto). Esto es contexto, no una señal direccional. Los campos que no son derivables son null y se muestran como — — ej. lev_wavg/crowding_index cuando ninguna posición tiene apalancamiento. Las distancias de liquidación son una estimación de margen aislado (pct_to_liq ≈ 1/lev + upnl/notional − mmr, mmr = 0.01), no precios de liquidación reportados por el exchange.

Parámetros

Ejemplo de Solicitud

Ejemplo de Respuesta

GET  /v1/options/gex

Dealer exposición gamma (GEX) análisis para BTC & ETH, calculado en vivo a partir de la cadena de opciones públicas de Deribit (sin autenticación). Devuelve el GEX neto del dealer por strike (convención SpotGamma dealer-short), el nivel de flip gamma (strike donde el GEX neto acumulado cruza cero), la estructura temporal de la IV (volatilidad implícita ATM por días hasta el vencimiento), y un sesgo de IV de vencimiento cercano (proxy de reversión de riesgo de 25Δ). El régimen de GEX es positive (dealers largos en gamma → supresión de volatilidad) o negative (amplificación de volatilidad). Totalmente autónomo — recalculado en cada llamada, sin dependencia de base de datos almacenada.

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

GET  /v1/liquidations/simulate

Interactivo prueba de estrés por cascada de liquidacionesDado un movimiento hipotético del precio, devuelve las posiciones apalancadas estimadas que se liquidarían, el volumen forzado por nivel de precio/lado/bolsa y un informe de profundidad de la cascada. Un movimiento a la baja liquida largos cuyo precio de liquidación está en/por encima del objetivo; un movimiento al alza liquida cortos cuyo precio de liquidación está en/por debajo. Se fusionan dos métodos independientes: precios exactos de liquidación de ballenas rastreadas en Hyperliquid con apalancamiento/entrada real , más clusters estadísticos de bandas de OI por bolsa (apalancamiento de la multitud inferido por funding). Todo está claramente etiquetado estimated: true — no puede conocer el margen por cuenta, cruzado vs aislado, margen adicional o ADL.

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

GET  /v1/wallet/{addr}/profile

Un perfil de billetera multiplataforma construido completamente a partir de instantáneas de posiciones de ballenas rastreadas en vivo. Para una ballena de Hyperliquid rastreada, devuelve las posiciones abiertas actuales, una serie temporal de PnL no realizado / exposición / recuento de posiciones serie temporal, una línea de tiempo de actividad OPEN/CLOSE/FLIP (reconstruida al comparar instantáneas consecutivas), la etiqueta descifrada del cuadro de líderes de HL y un resumen de libro abierto. Página en vivo: wallet-profiler.html.

Parámetros

Ejemplo de solicitud

Ejemplo de respuesta

GET  /flows

Devuelve datos de flujo de capital entre activos que muestran patrones de rotación entre BTC, ETH y SOL en múltiples ventanas de tiempo. Útil para identificar qué activo está acumulando capital y cuál se está distribuyendo en un momento dado.

Ejemplo de respuesta

GET  /whale-events

Devuelve cambios significativos en las posiciones de ballenas — aperturas, cierres y cambios de dirección — detectados en las billeteras y direcciones en cadena rastreadas dentro del período de tiempo especificado.

Parámetros

Respuesta de ejemplo

GET  /regimes/history

Devuelve datos históricos de clasificación de regímenes para un activo específico. Úsalo para hacer backtesting de cómo han funcionado históricamente tipos de regímenes específicos, cuánto suele durar cada tipo de régimen y cómo se desarrollan las transiciones entre regímenes a lo largo del tiempo.

Parámetros

Ejemplo de respuesta

GET  /exchange-health

Devuelve el estado de salud en tiempo real de todos los exchanges monitoreados, incluyendo latencia por exchange, tasas de error e indicadores de obsolescencia de datos. No requiere autenticación — endpoint de acceso público.

Ejemplo de respuesta

GET  /sentiment

Devuelve un índice de Miedo y Codicia (0-100) en tiempo real, calculado a partir del sentimiento en derivados, actividad de ballenas, volatilidad y señales sociales. Incluye desglose por componentes e historial de 24 horas para análisis de tendencias.

Parámetros

Ejemplo de respuesta

Integraciones

GET  /tradingview/setup

Devuelve tu configuración personalizada de integración con TradingView: URL del webhook, secreto para validación y scripts Pine listos para usar que se conectan directamente a la Smart Money API. Copia y pega el script Pine en TradingView para superponer nuestras señales en cualquier gráfico.

Ejemplo de respuesta

POST  /tradingview/webhook

Recibe una alerta de TradingView, la procesa a través de /confirm, y devuelve la confirmación. TradingView no puede enviar cabeceras personalizadas, así que autentícate incluyendo tu webhook secret en el cuerpo JSON (este endpoint no usa X-API-Key). La respuesta envuelve la confirmación y añade un nivel superior action de CONFIRMED (confianza del daemon HIGH/MEDIUM) o VETOED.

Cuerpo de la solicitud

Requerido: secret, symbol, direction (long|short). Opcional: source, timeframe, strategy, price.

Personalización

GET  /preferences

Devuelve tus configuraciones de personalización actuales, incluyendo parámetros de operación por defecto, perfil de riesgo, lista de seguimiento y preferencias de notificación.

Actualiza las preferencias enviando un cuerpo JSON con cualquier subconjunto de los campos a continuación. Los campos omitidos mantienen sus valores actuales.

Campos de preferencia

GET  /watchlist

Devuelve una instantánea del estado de confirmación y métricas clave de riesgo para todos los símbolos en tu lista de seguimiento configurada. Proporciona una visión general multi-activos sin necesidad de llamar /confirm por separado para cada símbolo.

Ejemplo de Respuesta

Transmisión en Tiempo Real (Swaps en Vivo)

Transmite swaps DEX ≥ $500 detectados en tiempo real desde nuestros propios nodos de BSC y Avalanche. Dos transportes están disponibles: un flujo público de Server-Sent Events (SSE) para clientes gratuitos/navegadores, y un flujo de baja latencia WebSocket para niveles de pago. Los eventos se transmiten en segundos después de su inclusión en un bloque.

Flujo Público SSE (Gratuito)

No se requiere autenticación. Soporte nativo EventSource en todos los navegadores modernos. El servidor emite swap eventos y latidos periódicos para mantener la conexión activa.

WebSocket Firehose (Pago)

Autenticación (recomendado): nunca pongas tu clave de larga duración en la URL — se registra en proxies y se guarda en el historial del navegador. En su lugar, envía tu clave mediante POST a /v1/ws/ticket usando el encabezado seguro X-API-Key , luego abre el socket con el ticket de un solo uso devuelto ticket (válido ~60s, canjeable una vez). Los clientes del lado del servidor que pueden establecer encabezados pueden pasar X-API-Key directamente en el handshake. Las claves de nivel gratuito reciben una 402 payment_required respuesta. Un hello frame se envía al conectar con tu nivel y el umbral de transmisión.

Autenticación WebSocket (tickets)

Por qué: nunca pongas tu clave API en una URL de WebSocket — las cadenas de consulta se registran en proxies, balanceadores de carga y se guardan en el historial del navegador. En su lugar, intercambia tu clave por un ticket de corta duración y de un solo uso ticket mediante un POST autenticado normal, luego conéctate con ese ticket.

Flujo: POST a /v1/ws/ticket con tu X-API-Key encabezado → recibe { "ticket": "…", "expires_in": 60 }. Luego abre wss://api.smartmoneyapi.com/v1/ws/live-swaps?ticket=<ticket>El ticket es de un solo uso y caduca en ~60 segundosLos clientes del lado del servidor que pueden configurar encabezados de solicitud pueden pasar X-API-Key directamente en el handshake de WebSocket — no se necesita ticket.

Genera un ticket de un solo uso para un handshake de WebSocket autenticado. Autentícate con el X-API-Key encabezado (tu clave nunca sale de los encabezados de la solicitud). El ticket devuelto se puede canjear una vez en /v1/ws/live-swaps antes de que caduque.

Ejemplo de Respuesta

Campos de Respuesta

Nota: la autenticación por ?key= parámetro de consulta heredado ya no se acepta en los endpoints de WebSocket por razones de seguridad. Usa un ticket (clientes de navegador) o el X-API-Key encabezado de handshake (clientes del lado del servidor).

Instantánea REST

Devuelve los últimos N swaps transmitidos desde el búfer en curso. Útil para la primera pintura en paneles antes de que se abra la conexión de transmisión. También disponible: /v1/live-swaps/status para estadísticas de transmisión.

Esquema de Evento

POST  /alerts/conditions

Crea reglas de alerta personalizadas que se activan cuando una métrica especificada cruza un umbral. Las alertas se entregan mediante webhook, correo electrónico o el feed de notificaciones del panel según tus preferencias.

Devuelve una lista de todas tus condiciones de alerta configuradas con sus IDs, definiciones y estado actual.

Elimina permanentemente una condición de alerta por su ID.

Devuelve eventos recientes de activación de alertas con marcas de tiempo, condiciones coincidentes y el valor de la métrica en el momento de la activación.

Crear Alerta — Cuerpo de la Solicitud

La lista actualizada de métricas y operadores válidos es devuelta por GET /v1/alerts/conditions as available_metrics and available_operators.

Available Metrics

GET  /kelly

Devuelve recomendaciones de tamaño de posición según el Criterio de Kelly, calibradas según el rendimiento histórico de la señal para el símbolo, nivel de confianza y dirección. Basa el tamaño de la posición en tasas de éxito empíricas para evitar sobre-apalancamiento.

Parameters

Example Response

GET  /performance

Devuelve estadísticas de precisión histórica de señales emitidas por la API, desglosadas por nivel de confianza. Útil para comprender la fiabilidad de las señales antes de comprometer capital.

Parámetros

Ejemplo de respuesta

Estadísticas y Señales

GET  /v1/stats

Estadísticas de rendimiento honestas de todo el sitio, obtenidas de smart_money_confirm resultados de llamadas distintas. Devuelve tasas de acierto en los niveles de confianza HIGH y MEDIUM, precisión general, factor de beneficio y un desglose por símbolo. Todas las cifras son dentro de la muestra durante la ventana de puntuación; consulta calibration.html para obtener contexto y metodología de forward-holdout.

Ejemplo de respuesta

GET  /v1/signals/performance

Seguimiento de resultados de señales en múltiples horizontes de resolución (4h, 12h, 24h, 72h). Devuelve tasas de acierto por horizonte, conteos totales de señales y un desglose por tipo de señal.

Parámetros

Ejemplo de respuesta

GET  /v1/signals/recent

Feed de señales HIGH y MEDIUM publicadas recientemente en todos los símbolos monitoreados. Cada entrada incluye el tipo de señal, nivel de confianza, dirección y estado de resolución, si está disponible.

Ejemplo de respuesta

GET  /v1/signals/{id}/outcome

Resultado resuelto para una señal individual por su ID numérico. Devuelve acierto/fallo en cada horizonte de resolución (4h, 12h, 24h, 72h) junto con el precio en el momento de la señal y en la resolución.

Parámetros

Ejemplo de respuesta

GET  /v1/confirm-winrate

Desglose de la tasa de aciertos de señales de confirmación para la clave API del usuario autenticado. Devuelve tasas de aciertos por llamada distinta en cada nivel de confianza, factor de beneficio y cifras por símbolo. Requiere un encabezado válido. X-API-Key encabezado.

Ejemplo de solicitud

Ejemplo de respuesta

Shadow Gate

Un registro de decisiones personal inmutable y solo de adición. Envía tus decisiones de trading antes o después de ejecutarlas; el sistema calcula una puntuación de confirmación contra el motor Smart Money y añade una fila permanente. Úsalo para construir un historial honesto y con marca de tiempo de qué tan bien coincidió la señal de la API con tus propias entradas, completamente independiente del grupo global de tasas de éxito. Las respuestas de los niveles Gratis y Trader tienen campos de evidencia eliminados; Pro devuelve el desglose completo. Un retraso por nivel aplica a los datos del nivel Gratis.

Envía una decisión. Idempotente en el Idempotency-Key encabezado de la solicitud — reenviar la misma clave devuelve la fila existente sin crear un duplicado. El sistema llama inmediatamente al motor de confirmación y añade el resultado como una fila inmutable en el registro.

Cuerpo de la solicitud

Ejemplo de solicitud

Ejemplo de respuesta

Lista tus propias decisiones de shadow-gate, las más recientes primero. Limitado al propietario — solo se devuelven las decisiones enviadas por tu clave de API.

Parámetros

Ejemplo de respuesta

Decisión individual por ID, incluyendo la evidencia completa de confirmación para el nivel Pro. Las respuestas de los niveles Free y Trader tienen factors y adjustments eliminados. Devuelve 403 si la decisión pertenece a una clave API diferente.

Ejemplo de respuesta (Pro)

Resuelve manualmente el resultado de una decisión. Llama a esto después de cerrar la operación para registrar el resultado final en el registro. Una vez resuelto, el registro es inmutable y no se puede cambiar nuevamente.

Cuerpo de la solicitud

Ejemplo de respuesta

Códigos de error

Ejemplos de código

Python

JavaScript / Node.js

cURL

Integración de Freqtrade

Agrega confirmación de Smart Money a cualquier estrategia de Freqtrade sobrescribiendo el confirm_trade_entry método.

CCXT + Smart Money