دليل التكامل

استخدم Smart Money API بجانب CCXT

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

لمن هذا

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

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

  • Python 3.9+ مع pip install ccxt requests.
  • مفاتيح واجهة برمجة التطبيقات للبورصة المكونة لـ 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دع استراتيجيتك تقرر اتجاهًا مرشحًا من بيانات السوق باستخدام CCXT، ثم استدع /v1/confirm كبوابة سياق نهائية.
  4. 4قم بتنفيذ الأمر باستخدام CCXT فقط عندما يكون الإجراء CONFIRM, تحديد الحجم بواسطة size_mult.

مثال عملي

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

ccxt_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.binance()                       # any CCXT exchange

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": "ccxt-bot"},
        headers={"X-API-Key": API_KEY},
        timeout=10,
    )
    r.raise_for_status()
    return r.json()

# 1. Read market data with CCXT and pick a candidate direction
ticker = exchange.fetch_ticker("BTC/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", "market", direction, qty)
    print(f"Would place {direction} {qty} BTC/USDT")
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

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

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

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

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