دليل التكامل
تأكيد الإدخالات في بوت Binance Futures
أضف بوابة نهائية لسياق السوق إلى بوت Binance USDⓈ-M للعقود الآجلة: تأكد من الاتجاه مع تدفق الحيتان ومراكز المشتقات، ثم قم بتحديد حجم الطلب بواسطة المضاعف المقترح.
لمن هذا؟
المطورون الذين يديرون بوت Binance USDⓈ-M للعقود الآجلة الدائمة ويرغبون في طبقة تأكيد مستقلة قبل كل إدخال. Smart Money API هو دعم للقرارات — يحتفظ بوتك بالتحكم الكامل في وضع الأوامر وإدارة المخاطر.
المتطلبات الأساسية
- Python 3.9+ مع
pip install ccxt requests(CCXT يغطي Binance USDⓈ-M للعقود الآجلة). - مفاتيح API لـ Binance futures مع إذن التداول (اختبرها أولاً على testnet).
- مفتاح API لـ Smart Money API (النسخة المجانية تغطي BTC).
احصل على مفتاح API الخاص بك
كل طلب يتم التحقق منه باستخدام X-API-Key الرأس. للحصول على مفتاح:
- 1أنشئ حسابًا مجانيًا، ثم افتح لوحة التحكم.
- 2انسخ مفتاح API المعروض تحت الوصول إلى API. النسخة المجانية تغطي BTC بـ 20 طلب/يوم — كافية لاختبار هذا الدليل من البداية إلى النهاية.
- 3هل تحتاج إلى رموز أكثر أو حدود أعلى؟ قارن بين النسخ على صفحة التسعير.
احتفظ بالمفتاح سريًا — قم بتخزينه في متغير بيئة، ولا تقم بإضافته إلى التحكم في المصدر أبدًا.
الإعداد
- 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.
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 مثل هذا:
{
"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.
تقليل
الإشارات مختلطة. فكر في مركز أصغر ورافعة مالية أضيق، أو انتظر التأكيد.
تخطي
سياق السوق لا يدعم هذه الصفقة. قف جانبًا وقم بالتحقق مرة أخرى عند الإشارة التالية.
هل أنت جاهز للبناء؟
احصل على مفتاح مجاني وقم بإجراء أول استدعاء تأكيد في أقل من دقيقة.
ليست نصيحة مالية. تداول العملات المشفرة ينطوي على مخاطر.