Guía de Integración
Confirmar entradas en perpetuos de Bybit con Smart Money API
Lee datos de mercado en vivo de swaps de Bybit con CCXT, consulta a Smart Money API si el flujo de ballenas y el posicionamiento de derivados confirman tu dirección, luego realiza la entrada en perpetuos — dimensionada por el multiplicador sugerido.
Para quién es esto
Desarrolladores de Python que ejecutan un bot de perpetuos USDT en Bybit con CCXT que desean una verificación independiente del contexto del mercado antes de cada entrada. Smart Money API es un soporte para decisiones — no coloca órdenes por ti; tu código CCXT mantiene el control de la ejecución y el riesgo.
Requisitos previos
- Python 3.9+ con
pip install ccxt requests. - Claves API de Bybit configuradas para CCXT (solo lectura es suficiente para pruebas).
- 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:
- 1Crea una cuenta gratuita, luego abre tu panel de control.
- 2Copia la clave API que aparece en Acceso API. El nivel gratuito cubre BTC con 20 solicitudes/día — suficiente para probar esta guía de principio a fin.
- 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 incluyas en el control de código fuente.
Configuración
- 1Instala las bibliotecas:
pip install ccxt requests. - 2Exporta tu clave:
export SMA_API_KEY="sm_your_key_here". - 3Abre swaps de Bybit con CCXT (
ccxt.bybit({"options":{"defaultType":"swap"}})), deja que tu estrategia elija una dirección candidata, luego llama a/v1/confirmcomo una puerta de contexto final. - 4Realiza la entrada en perpetuos con CCXT solo cuando la acción sea
CONFIRM, tamaño porsize_mult.
Ejemplo práctico
Este script lee un ticker de swap de Bybit con CCXT, deriva una dirección candidata, luego llama GET /v1/confirm?symbol=BTC&direction=long antes de decidir si realizar la entrada.
import os
import ccxt
import requests
API_KEY = os.environ["SMA_API_KEY"] # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"
exchange = ccxt.bybit({"options": {"defaultType": "swap"}}) # Bybit perpetuals
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": "bybit-bot"},
headers={"X-API-Key": API_KEY},
timeout=10,
)
r.raise_for_status()
return r.json()
# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT: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:USDT", "market", direction, qty)
print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
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 JSON como este:
{
"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. Consulte la referencia completa de campos en la documentación de la API.
Cómo actuar ante 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 están mezcladas. 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 próximo 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.