راهنمای интеграیه

تأیید ورودی‌ها در ربات فیوچرز بایننس

یک دروازه نهایی مبتنی بر شرایط بازار به ربات فیوچرز USDⓈ-M بایننس اضافه کنید: جهت را با جریان نهنگ‌ها و موقعیت‌سازی مشتقات تأیید کنید، سپس اندازه سفارش را با ضریب پیشنهادی تنظیم نمایید.

مخاطبان این ویژگی

توسعه‌دهندگانی که یک ربات فیوچرز دائمی USDⓈ-M بایننس را اجرا می‌کنند و می‌خواهند قبل از هر ورودی یک لایه تأیید مستقل داشته باشند. Smart Money API پشتیبان تصمیم‌گیری است — ربات شما کنترل کامل روی ثبت سفارش و مدیریت ریسک را حفظ می‌کند.

پیش‌نیازها

  • Python 3.9+ با pip install ccxt requests (CCXT فیوچرز USDⓈ-M بایننس را پوشش می‌دهد).
  • کلیدهای API فیوچرز بایننس با مجوز معامله (ابتدا در testnet تست کنید).
  • یک کلید API Smart Money (رایگان برای BTC).

دریافت کلید API

هر درخواست با X-API-Key هدر احراز هویت می‌شود. برای دریافت کلید:

  1. 1یک حساب رایگان ایجاد کنید، سپس داشبورد.
  2. 2کلید API نمایش داده شده در زیر را کپی کنید دسترسی API. سطح رایگان شامل BTC با 100 درخواست/روز می‌شود — کافی است تا این راهنما را از ابتدا تا انتها تست کنید.
  3. 3به نمادهای بیشتر یا محدودیت‌های بالاتر نیاز دارید؟ سطوح مختلف را در صفحه قیمت‌گذاری.

مقایسه کنید.

دریافت کلید API رایگان

  1. 1تنظیمات
  2. 2منطق ورودی موجود خود را که یک سیگنال خرید/فروش کاندید تولید می‌کند، حفظ کنید. export SMA_API_KEY="sm_your_key_here".
  3. 3کلید خود را صادر کنید: /v1/confirm قبل از هر ورودی، با نماد و جهت فراخوانی کنید
  4. 4فقط موقعیت فیوچرز را در CONFIRMباز کنید، با مقیاس‌دهی اسمی توسط size_mult.

مثال عملی

این ربات تأیید میکند که یک معامله long یا short با GET /v1/confirm?symbol=BTC&direction=long و فقط زمانی یک پوزیشن futures در 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.

کاهش

سیگنال‌ها ترکیبی هستند. یک پوزیشن کوچکتر و اهرم محدودتر در نظر بگیرید، یا منتظر تأیید بمانید.

رد کردن

زمینه بازار از این معامله حمایت نمی‌کند. کنار بایستید و در سیگنال بعدی دوباره بررسی کنید.

آماده ساخت هستید؟

یک کلید رایگان بگیرید و اولین فراخوانی تأیید خود را در کمتر از یک دقیقه انجام دهید.

مشاوره مالی نیست. معامله ارزهای دیجیتال همراه با ریسک است.