통합 가이드
Binance Futures 봇에서 진입 확인
Binance USDⓈ-M 선물 봇에 최종 시장 컨텍스트 게이트 추가: 고래 흐름과 파생상품 포지셔닝으로 방향을 확인한 후, 제안된 승수로 주문 크기를 조정하세요.
대상 사용자
Binance USDⓈ-M 영구 선물 봇을 운영하는 개발자로, 각 진입 전에 독립적인 확인 레이어를 원하는 분들. Smart Money API는 의사 결정 지원 도구입니다. 주문 배치 및 리스크 관리는 여전히 봇이 완전히 제어합니다.
필수 조건
- Python 3.9+ 설치
pip install ccxt requests(CCXT는 Binance USDⓈ-M 선물을 지원합니다). - 거래 권한이 있는 Binance 선물 API 키 (먼저 테스트넷에서 테스트하세요).
- Smart Money API 키 (무료 티어는 BTC를 포함합니다).
API 키 받기
설정
- 1기존의 롱/숏 신호를 생성하는 진입 로직을 유지하세요.
- 2키를 내보내세요:
export SMA_API_KEY="sm_your_key_here". - 3각 진입 전에 심볼과 방향으로
/v1/confirm를 호출하세요. - 4선물 포지션은
CONFIRM, 노미널을 스케일링하여만 열세요.size_mult.
작동 예시
이 봇은 롱 또는 숏을 확인하고 GET /v1/confirm?symbol=BTC&direction=long 액션이 있을 때만 Binance USDⓈ-M 선물 포지션을 엽니다. 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)
예상 응답
성공적인 호출은 /v1/confirm 다음과 같은 JSON을 반환합니다:
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 -1.0(강한 반대)부터 +1.0(강한 확인)까지의 범위를 가지며, confidence HIGH 또는 MEDIUM이고, size_mult 0.0–1.5의 제안된 크기 승수입니다. 전체 필드 참조는 API 문서.
응답에 따른 조치 방법
확인
상황이 당신의 방향을 지원합니다. 자신의 위험 규칙에 따라 포지션을 열고, size_mult로 노션을 조정하세요. size_mult.
축소
신호가 혼재되어 있습니다. 더 작은 포지션과 타이트한 레버리지를 고려하거나 확인을 기다리세요.
건너뛰기
시장 상황이 이 거래를 지원하지 않습니다. 옆으로 비켜서 다음 신호를 다시 확인하세요.
준비되었나요?
무료 키를 받고 1분 이내에 첫 확인 호출을 하세요.
재무적 조언이 아닙니다. 암호화폐 거래는 위험을 수반합니다.