מדריך אינטגרציה

אשר כניסות בבוט Binance Futures

הוסף שער הקשר שוק סופי לבוט Binance USDⓈ-M futures שלך: אשר את הכיוון עם זרימת לווייתנים ומיקום נגזרות, ואז קבע את גודל ההזמנה לפי המכפיל המוצע.

למי זה מיועד

מפתחים שמפעילים בוט Binance USDⓈ-M perpetual futures שרוצים שכבת אישור עצמאית לפני כל כניסה. Smart Money API הוא תמיכה בהחלטות — הבוט שלך שומר על שליטה מלאה במיקום ההזמנות ובניהול הסיכונים.

דרישות מוקדמות

  • Python 3.9+ עם pip install ccxt requests (CCXT מכסה Binance USDⓈ-M futures).
  • מפתחות API של Binance futures עם הרשאת מסחר (בדוק תחילה ב-testnet).
  • מפתח Smart Money API (הרמה החינמית מכסה BTC).

קבל את מפתח ה-API שלך

כל בקשה מאומתת עם ה- X-API-Key header. כדי לקבל מפתח:

  1. 1צור חשבון חינמי, ואז פתח את ה- לוח הבקרה.
  2. 2העתק את מפתח ה-API המוצג תחת גישה ל-API. הרמה החינמית מכסה BTC ב-20 בקשות/יום — מספיק כדי לבדוק את המדריך הזה מקצה לקצה.
  3. 3צריך יותר סמלים או גבולות גבוהים יותר? השווה רמות ב- דף המחירים.

שמור על המפתח בסוד — אחסן אותו במשתנה סביבה, לעולם אל תכניס אותו לבקרת מקור.

התקנה

  1. 1שמור על הלוגיקה הקיימת שלך ליצירת אות מועמד ל-long/short.
  2. 2ייצא את המפתח שלך: export SMA_API_KEY="sm_your_key_here".
  3. 3לפני כל כניסה, התקשר ל- /v1/confirm עם הסמל והכיוון.
  4. 4פתח את עמדת ה-futures רק ב- CONFIRM, קבע את הערך הנומינלי לפי size_mult.

דוגמה עובדת

בוט זה מאשר long או short עם GET /v1/confirm?symbol=BTC&direction=long ופותח עמדת Binance USDⓈ-M futures רק כאשר הפעולה היא 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.

כיצד לפעול לפי התגובה

CONFIRM

ההקשר תומך בכיוון שלך. פתח את העמדה עם כללי הסיכון שלך, קבע את הערך הנומינלי לפי size_mult.

REDUCE

האותות מעורבים. שקול עמדה קטנה יותר ולחיצה הדוקה יותר, או המתן לאישור.

SKIP

ההקשר השוק אינו תומך במסחר זה. הישאר בצד ובדוק שוב באות הבא.

מוכן לבנות?

קח מפתח חינמי ועשה את שיחת האישור הראשונה שלך תוך פחות מדקה.

לא ייעוץ פיננסי. מסחר בקריפטו כרוך בסיכון.