Guia de Integração

Confirme entradas em um bot de Futuros da Binance

Adicione uma verificação final de contexto de mercado ao seu bot de futuros USDⓈ-M da Binance: confirme a direção com o fluxo de baleias e posicionamento de derivativos, depois dimensione o pedido pelo multiplicador sugerido.

Para quem é isso

Desenvolvedores que operam um bot de futuros perpétuos USDⓈ-M da Binance e desejam uma camada de confirmação independente antes de cada entrada. A Smart Money API é um suporte para decisões — seu bot mantém o controle total da colocação de ordens e gerenciamento de risco.

Pré-requisitos

  • Python 3.9+ com pip install ccxt requests (CCXT cobre futuros USDⓈ-M da Binance).
  • Chaves de API de futuros da Binance com permissão de negociação (teste primeiro na testnet).
  • Uma chave de API da Smart Money API (o plano 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 plano gratuito cobre BTC com 20 solicitações/dia — suficiente para testar este guia de ponta a ponta.
  3. 3Precisa de mais símbolos ou limites maiores? Compare os planos 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. 1Mantenha sua lógica de entrada existente que produz um sinal de compra/venda candidato.
  2. 2Exporte sua chave: export SMA_API_KEY="sm_your_key_here".
  3. 3Antes de cada entrada, chame /v1/confirm com o símbolo e a direção.
  4. 4Abra a posição de futuros apenas em CONFIRM, dimensionando o valor nocional por size_mult.

Exemplo funcional

Este bot confirma uma compra ou venda com GET /v1/confirm?symbol=BTC&direction=long e só abre uma posição de futuros USDⓈ-M da Binance quando a ação é CONFIRM.

binance_futures_bot.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]
SMA_BASE = "https://api.smartmoneyapi.com"

binance = ccxt.binance({
    "apiKey": os.environ["BINANCE_KEY"],
    "secret": os.environ["BINANCE_SECRET"],
    "options": {"defaultType": "future"},   # USDⓈ-M futures
})

def confirm(symbol: str, direction: str) -> dict:
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "binance-fut"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

def maybe_enter(symbol: str, direction: str, base_qty: float):
    sig = confirm(symbol, direction)
    print(sig["symbol"], direction, "->", sig["action"], sig["confidence"])

    if sig["action"] != "CONFIRM":
        print("Not confirmed -> no entry")   # REDUCE or SKIP
        return

    qty = round(base_qty * sig["size_mult"], 3)   # size by multiplier
    side = "buy" if direction == "long" else "sell"
    # binance.create_order("BTC/USDT", "market", side, qty)
    print(f"Would open {direction} {qty} BTC/USDT (futures)")

if __name__ == "__main__":
    # your strategy decided it wants a long here
    maybe_enter("BTC", "long", base_qty=0.02)

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 nos documentos da API.

Como agir com base na resposta

CONFIRMAR

O contexto apoia sua direção. Abra a posição com suas próprias regras de risco, dimensionando o valor nocional por size_mult.

REDUZIR

Os sinais estão misturados. Considere uma posição menor e alavancagem mais apertada, ou aguarde confirmação.

PULAR

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

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.