통합 가이드

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 키 받기

모든 요청은 다음으로 인증됩니다 X-API-Key 헤더. 키를 얻으려면:

  1. 1무료 계정을 생성한 후 대시보드.
  2. 2아래에 표시된 API 키를 복사하세요. API 접근. 무료 티어는 BTC를 하루 100회 요청으로 지원합니다 — 이 가이드를 처음부터 끝까지 테스트하기에 충분합니다.
  3. 3더 많은 심볼이나 더 높은 한도가 필요하신가요? 티어를 비교해 보세요. 가격 페이지.

키를 비밀로 유지하세요 — 환경 변수에 저장하고 소스 제어에 절대 커밋하지 마세요.

설정

  1. 1기존의 롱/숏 신호를 생성하는 진입 로직을 유지하세요.
  2. 2키를 내보내세요: export SMA_API_KEY="sm_your_key_here".
  3. 3각 진입 전에 심볼과 방향으로 /v1/confirm 를 호출하세요.
  4. 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분 이내에 첫 확인 호출을 하세요.

재무적 조언이 아닙니다. 암호화폐 거래는 위험을 수반합니다.