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:
- 1Crie uma conta gratuita, depois abra seu painel.
- 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.
- 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
- 1Mantenha sua lógica de entrada existente que produz um sinal de compra/venda candidato.
- 2Exporte sua chave:
export SMA_API_KEY="sm_your_key_here". - 3Antes de cada entrada, chame
/v1/confirmcom o símbolo e a direção. - 4Abra a posição de futuros apenas em
CONFIRM, dimensionando o valor nocional porsize_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.
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:
{
"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.