Guia de Integração

Confirme entradas de perpetuals na Bybit com Smart Money API

Leia dados de mercado ao vivo de swaps da Bybit com CCXT, pergunte à Smart Money API se o fluxo de baleias e o posicionamento de derivativos confirmam sua direção, então faça a entrada de perpetuals — dimensionada pelo multiplicador sugerido.

Para quem é isso

Desenvolvedores Python executando um bot de USDT-perpetuals na Bybit em CCXT que desejam uma verificação independente do contexto de mercado antes de cada entrada. Smart Money API é um suporte para decisões — ela não faz ordens por você; seu código CCXT permanece no controle da execução e do risco.

Pré-requisitos

  • Python 3.9+ com pip install ccxt requests.
  • Chaves de API da Bybit configuradas para CCXT (somente leitura é suficiente para testar).
  • Uma chave de API da Smart Money API (o nível gratuito cobre BTC).

Obtenha sua chave de API

Cada solicitação é autenticada com o X-API-Key cabeçalho. Para obter uma chave:

  1. 1Crie uma conta gratuita, depois abra seu painel.
  2. 2Copie a chave de API exibida em Acesso à API. O nível gratuito cobre BTC com 20 solicitações/dia — o suficiente para testar este guia de ponta a ponta.
  3. 3Precisa de mais símbolos ou limites maiores? Compare os níveis na página de preços.

Mantenha a chave secreta — armazene-a em uma variável de ambiente, nunca a comprometa no controle de origem.

Configuração

  1. 1Instale as bibliotecas: pip install ccxt requests.
  2. 2Exporte sua chave: export SMA_API_KEY="sm_your_key_here".
  3. 3Abra swaps da Bybit com CCXT (ccxt.bybit({"options":{"defaultType":"swap"}})), deixe sua estratégia escolher uma direção candidata, então chame /v1/confirm como um portão de contexto final.
  4. 4Faça a entrada de perpetuals com CCXT apenas quando a ação for CONFIRM, dimensionamento por size_mult.

Exemplo prático

Este script lê um ticker de swap da Bybit com CCXT, deriva uma direção candidata e então chama GET /v1/confirm?symbol=BTC&direction=long antes de decidir se deve colocar a entrada.

bybit_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.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")

Resposta esperada

Uma chamada bem-sucedida para /v1/confirm retorna 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 varia de -1.0 (forte contra) a +1.0 (forte confirmação), confidence é HIGH ou MEDIUM, e size_mult é um multiplicador de tamanho sugerido de 0.0–1.5. Consulte a referência completa de campos na documentação da API.

Como agir com base na resposta

CONFIRMAR

O contexto apoia sua direção. Prossiga com suas próprias regras de entrada e risco, opcionalmente dimensionando o tamanho por size_mult.

REDUZIR

Os sinais estão misturados. Considere uma posição menor, stops mais apertados ou aguardar uma configuração mais clara.

IGNORAR

O contexto do mercado não apoia esta operação. Fique de fora e verifique novamente no próximo candidato.

Pronto para construir?

Obtenha uma chave gratuita e faça sua primeira chamada de confirmação em menos de um minuto.

Não é um conselho financeiro. O trading de criptomoedas envolve riscos.