دليل التكامل

تأكيد دخول العقود الدائمة على Bybit باستخدام Smart Money API

اقرأ بيانات سوق المبادلات الحية على Bybit باستخدام CCXT، واسأل Smart Money API ما إذا كان تدفق الحيتان ومراكز المشتقات تؤكد اتجاهك، ثم قم بإدخال العقود الدائمة - بحجم مضاعف مقترح.

لمن هذا الدليل

مطوري Python الذين يشغلون بوت العقود الدائمة USDT على Bybit باستخدام CCXT والذين يرغبون في التحقق من سياق السوق بشكل مستقل قبل كل دخول. Smart Money API هو دعم قرار - لا يقوم بوضع الأوامر نيابة عنك؛ يظل كود CCXT الخاص بك مسيطرًا على التنفيذ والمخاطر.

المتطلبات الأساسية

  • Python 3.9+ مع pip install ccxt requests.
  • مفاتيح Bybit API مهيأة لـ CCXT (وضع القراءة فقط كافٍ للاختبار).
  • مفتاح Smart Money API (الطبقة المجانية تغطي BTC).

احصل على مفتاح API الخاص بك

كل طلب يتم التحقق من صحته باستخدام X-API-Key الرأس. للحصول على مفتاح:

  1. 1قم بإنشاء حساب مجاني، ثم افتح لوحة التحكم.
  2. 2انسخ مفتاح API الموجود تحت الوصول إلى API. الطبقة المجانية تغطي BTC بحد 20 طلب/يوم - كافية لاختبار هذا الدليل من البداية إلى النهاية.
  3. 3هل تحتاج إلى رموز أكثر أو حدود أعلى؟ قارن بين الطبقات على صفحة الأسعار.

احتفظ بالمفتاح سريًا - قم بتخزينه في متغير بيئة، ولا تقم بإضافته إلى التحكم في المصدر أبدًا.

الإعداد

  1. 1قم بتثبيت المكتبات: pip install ccxt requests.
  2. 2قم بتصدير مفتاحك: export SMA_API_KEY="sm_your_key_here".
  3. 3افتح مقايضات Bybit باستخدام CCXT (ccxt.bybit({"options":{"defaultType":"swap"}}))، دع استراتيجيتك تختار اتجاهًا مرشحًا، ثم استدعِ /v1/confirm كبوابة سياق نهائية.
  4. 4قم بإدخال العقود الدائمة باستخدام CCXT فقط عندما يكون الإجراء CONFIRM، بحجم size_mult.

مثال عملي

هذا البرنامج النصي يقرأ مؤشر مقايضة Bybit باستخدام CCXT، ويستنتج اتجاهًا مرشحًا، ثم يستدعي GET /v1/confirm?symbol=BTC&direction=long قبل اتخاذ قرار بشأن وضع الدخول.

bybit_confirm.py
import os
import ccxt
import requests

API_KEY = os.environ["SMA_API_KEY"]            # never hard-code
SMA_BASE = "https://api.smartmoneyapi.com"

exchange = ccxt.bybit({"options": {"defaultType": "swap"}})   # Bybit perpetuals

def confirm(symbol: str, direction: str) -> dict:
    """Ask Smart Money API for market-context confirmation."""
    r = requests.get(
        f"{SMA_BASE}/v1/confirm",
        params={"symbol": symbol, "direction": direction, "source": "bybit-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read Bybit swap market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/USDT:USDT")
direction = "long" if ticker["percentage"] and ticker["percentage"] > 0 else "short"

# 2. Confirm with Smart Money API before acting
sig = confirm("BTC", direction)
print(sig["action"], sig["confidence"], "size_mult", sig["size_mult"])

# 3. Act on the recommendation (CCXT executes; the API only advises)
if sig["action"] == "CONFIRM":
    base_qty = 0.01
    qty = base_qty * sig["size_mult"]          # scale by suggested multiplier
    # exchange.create_order("BTC/USDT:USDT", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT:USDT perp")
elif sig["action"] == "REDUCE":
    print("Context is mixed -> trade smaller or wait for a cleaner setup")
else:  # SKIP
    print("Context does not support this trade -> stand aside")

الاستجابة المتوقعة

استدعاء ناجح لـ /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

سياق السوق لا يدعم هذه الصفقة. ابتعد وتحقق مرة أخرى في المرشح التالي.

مستعد للبناء؟

احصل على مفتاح مجاني وقم بإجراء أول مكالمة تأكيد في أقل من دقيقة.

ليست نصيحة مالية. تداول العملات المشفرة ينطوي على مخاطر.