Guía de Integración

Usa Smart Money API junto con CCXT

Lee datos de mercado en tiempo real con CCXT, pregunta a Smart Money API si el flujo de ballenas y el posicionamiento de derivados confirman tu dirección, luego realiza la orden en el exchange de tu elección.

Para quién es esto

Desarrolladores de Python que construyen bots independientes del exchange en CCXT que desean una verificación independiente del contexto del mercado antes de cada orden. Smart Money API es un soporte para la toma de decisiones — no realiza órdenes por ti; CCXT mantiene el control de la ejecución.

Requisitos previos

  • Python 3.9+ con pip install ccxt requests.
  • Claves API de exchange configuradas para CCXT (solo lectura es suficiente para probar).
  • Una clave API de Smart Money API (el nivel gratuito cubre BTC).

Obtén tu clave API

Cada solicitud se autentica con el X-API-Key encabezado. Para obtener una clave:

  1. 1Crea una cuenta gratuita, luego abre tu panel de control.
  2. 2Copia la clave API que se muestra en Acceso API. El nivel gratuito cubre BTC con 20 solicitudes/día — suficiente para probar esta guía de principio a fin.
  3. 3¿Necesitas más símbolos o límites más altos? Compara los niveles en la página de precios.

Mantén la clave en secreto — guárdala en una variable de entorno, nunca la comprometas en el control de código fuente.

Configuración

  1. 1Instala las bibliotecas: pip install ccxt requests.
  2. 2Exporta tu clave: export SMA_API_KEY="sm_your_key_here".
  3. 3Deja que tu estrategia decida una dirección candidata a partir de los datos de mercado de CCXT, luego llama a /v1/confirm como una puerta de contexto final.
  4. 4Realiza la orden con CCXT solo cuando la acción sea CONFIRM, dimensionando por size_mult.

Ejemplo práctico

Este script lee un ticker con CCXT, deriva una dirección candidata, luego llama a GET /v1/confirm?symbol=BTC&direction=long antes de decidir si realizar la orden.

ccxt_confirm.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

exchange = ccxt.binance()                       # any CCXT exchange

def confirm(symbol: str, direction: str) -> dict:
    """Ask Smart Money API for market-context confirmation."""
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "ccxt-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"

# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])

# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
    base_qty = 0.01
    qty = base_qty * sig["size_mult"]          # scale by suggested multiplier
    # exchange.create_order("BTC/USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT")
elif sig["action"] == "REDUCE":
    print("Context is mixed -> trade smaller or wait for a cleaner setup")
else:  # SKIP
    print("Context does not support this trade -> stand aside")

Respuesta esperada

Una llamada exitosa a /v1/confirm devuelve un JSON como este:

200 OK · application/json
{
  "ts": 1710940821,
  "symbol": "BTC",
  "direction": "long",
  "composite": 0.74,
  "confidence": "HIGH",
  "action": "CONFIRM",
  "size_mult": 1.5,
  "deriv_score": 0.81,
  "onchain_score": 0.68,
  "whale_score": 0.73,
  "reasons": [
    "Funding rate positive across all venues",
    "LSR favors longs: 1.42",
    "Whales: 67% long consensus",
    "MVRV above 1.0 — on-chain bullish"
  ]
}

composite varía de -1.0 (fuerte contra) a +1.0 (fuerte confirmación), confidence es HIGH o MEDIUM, y size_mult es un multiplicador de tamaño sugerido de 0.0–1.5. Consulta la referencia completa de campos en la documentación API.

Cómo actuar según la respuesta

CONFIRMAR

El contexto respalda tu dirección. Procede con tus propias reglas de entrada y riesgo, opcionalmente escalando el tamaño por size_mult.

REDUCIR

Las señales son mixtas. Considera una posición más pequeña, stops más ajustados o esperar una configuración más clara.

SALTAR

El contexto del mercado no respalda esta operación. Mantente al margen y vuelve a verificar en el siguiente candidato.

¿Listo para construir?

Obtén una clave gratuita y realiza tu primera llamada de confirmación en menos de un minuto.

No es un consejo financiero. El trading de criptomonedas implica riesgos.