एकीकरण गाइड

बायनेंस फ्यूचर्स बॉट में एंट्री की पुष्टि करें

अपने बायनेंस USDⓈ-M फ्यूचर्स बॉट में एक अंतिम मार्केट-कॉन्टेक्स्ट गेट जोड़ें: व्हेल फ्लो और डेरिवेटिव्स पोजीशनिंग के साथ दिशा की पुष्टि करें, फिर सुझाए गए मल्टीप्लायर द्वारा ऑर्डर का आकार तय करें।

यह किसके लिए है

डेवलपर्स जो बायनेंस USDⓈ-M परपेचुअल फ्यूचर्स बॉट चला रहे हैं और प्रत्येक एंट्री से पहले एक स्वतंत्र पुष्टि परत चाहते हैं। स्मार्ट मनी API निर्णय समर्थन है — आपका बॉट ऑर्डर प्लेसमेंट और रिस्क मैनेजमेंट का पूर्ण नियंत्रण रखता है।

पूर्वापेक्षाएँ

  • Python 3.9+ के साथ pip install ccxt requests (CCXT बायनेंस USDⓈ-M फ्यूचर्स को कवर करता है)।
  • ट्रेड परमिशन के साथ बायनेंस फ्यूचर्स API कुंजी (पहले टेस्टनेट पर टेस्ट करें)।
  • एक स्मार्ट मनी 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 और केवल तभी बायनेंस 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 डॉक्स.

प्रतिक्रिया पर कैसे कार्य करें

CONFIRM

कॉन्टेक्स्ट आपकी दिशा का समर्थन करता है। अपने स्वयं के रिस्क नियमों के साथ पोजीशन खोलें, नोशनल को स्केल करके size_mult.

REDUCE

सिग्नल मिश्रित हैं। एक छोटी पोजीशन और टाइटर लीवरेज पर विचार करें, या पुष्टि के लिए प्रतीक्षा करें।

SKIP

मार्केट कॉन्टेक्स्ट इस ट्रेड का समर्थन नहीं करता है। अलग रहें और अगले सिग्नल पर फिर से जांच करें।

बनाने के लिए तैयार?

एक निःशुल्क कुंजी प्राप्त करें और एक मिनट से कम समय में अपना पहला कन्फर्मेशन कॉल करें।

वित्तीय सलाह नहीं। क्रिप्टो ट्रेडिंग में जोखिम शामिल है।