المرجع الكامل لواجهة برمجة التطبيقات (REST)

أتقن Smart Money API من خلال مرجعنا الشامل لـ REST. تعلم جميع النقاط الطرفية والمعاملات وطرق المصادقة وأنماط التكامل الواقعية لبيانات مشتقات العملات الرقمية وتتبع الحيتان.

نظرة عامة

يوفر Smart Money API وصولاً RESTful إلى بيانات مشتقات العملات الرقمية في الوقت الفعلي عبر ثلاث بورصات رئيسية: Bybit وBinance وHyperliquid. تجمع واجهة برمجة التطبيقات لدينا مراكز محافظ الحيتان ومعدلات التمويل ومقاييس الاهتمام المفتوح وبيانات التصفية وإشارات السلسلة في واجهة موحدة واحدة. سواء كنت تبني خوارزميات تداول أو أنظمة إدارة مخاطر أو أدوات تحليل السوق، فإن واجهة برمجة التطبيقات REST تمنحك وصولاً برمجياً مباشراً إلى جميع ذكاء Smart Money.

مع أكثر من 229 رمز تداول مكتشف تلقائياً وأكثر من 600 محفظة حيتان مراقبة، توفر واجهة برمجة التطبيقات ذكاء سوقي شامل. توفر اتصالات WebSocket في الوقت الفعلي تحديثات بأقل من ثانية، بينما تتعامل نقاطنا الطرفية REST مع استعلامات الدُفعات واسترجاع البيانات التاريخية وتحليل المحافظ على نطاق واسع.

يجب أن تتضمن جميع الطلبات بيانات اعتماد مصادقة صالحة. لدى مستخدمي الطبقة المجانية 100 طلبًا في اليوم محدودة بـ BTC. تفتح الطبقة التجارية (400 طلب/يوم) والطبقة الاحترافية (4,000 طلب/يوم) جميع الرموز والميزات المتقدمة.

المصادقة

تستخدم Smart Money API مصادقة مفتاح API. الطريقة الأساسية هي X-API-Key رأس الطلب. يمكنك إنشاء مفاتيح API من لوحة التحكم الخاصة بك. يتم قبول JWT للجلسة عبر Authorization: Bearer كحل بديل لجلسات المتصفح/لوحة التحكم، ولكن يجب على عملاء API استخدام X-API-Key.

مصادقة مفتاح API (الأساسية)

أرسل مفتاح API الخاص بك في X-API-Key رأس في كل طلب. لا تضع مفتاحك في عنوان URL أبداً.

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

JWT الجلسة (بديل)

قد تمرر جلسات المتصفح/لوحة التحكم JWT للجلسة عبر Authorization: Bearer (صالح لمدة 24 ساعة). يجب أن يفضل العملاء البرمجيون X-API-Key.

بايثون

import requests
import json

# الحصول على رمز JWT
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# استخدام JWT للطلبات اللاحقة
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

رابط الأساس والنقاط الطرفية

توجه جميع طلبات API إلى https://api.smartmoneyapi.com. يتم تنظيم API إلى فئات موارد منطقية مع بادئات إصدار. الإصدار المستقر الحالي هو v1.

رابط الأساس: https://api.smartmoneyapi.com/api/v1

رابط WebSocket: wss://ws.smartmoneyapi.com/stream

تنسيق الاستجابة

يتم إرجاع جميع استجابات API ككائنات JSON بتنسيق مغلف قياسي. تُرجع الاستجابات الناجحة رموز حالة HTTP 200-299 مع البيانات في جسم الاستجابة. تتضمن استجابات الأخطاء رسائل خطأ مفصلة واقتراحات للحل.

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

نقطة طرفية لمراكز الحيتان

استرجع مراكز مفصلة من محافظ الحيتان المراقبة عبر جميع البورصات. تُظهر هذه النقطة الطرفية الرافعة المالية في الوقت الفعلي وأسعار الدخول وأسعار التصفية و P&L غير المحققة للمراكز عالية القيمة.

GET /v1/whales/events PRO

المعامل	النوع	الوصف
symbol	string	زوج التداول (مثل BTCUSDT، ETHUSDT) اختياري
exchange	string	تصفية حسب البورصة: bybit، binance، hyperliquid اختياري
min_position_size	number	الحد الأدنى لحجم المركز بالأصل الأساسي اختياري
direction	string	مراكز شراء أو بيع فقط اختياري
page	integer	رقم صفحة الترقيم، الافتراضي 1 اختياري
limit	integer	النتائج لكل صفحة، الحد الأقصى 100، الافتراضي 50 اختياري

مثال على الطلب:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

نقطة طرفية لمعدلات التمويل

الوصول إلى معدلات التمويل في الوقت الفعلي والتاريخية عبر Bybit وBinance وHyperliquid. تعتبر معدلات التمويل حاسمة لتداول المراجحة واستراتيجيات التأرجح والتحوط بالمشتقات. تجمع واجهة برمجة التطبيقات لدينا المعدلات بدقة 15 دقيقة وتوفر تحليلًا للمعدلات التاريخية.

GET /v1/funding-rates FREE

المعامل	النوع	الوصف
symbol	string	زوج التداول (مثل BTCUSDT) مطلوب
exchange	string	البورصة: bybit، binance، hyperliquid اختياري
interval	string	1h، 4h، 1d، الافتراضي 1h اختياري
limit	integer	الفترات التاريخية لإرجاعها، الحد الأقصى 500 اختياري

مثال على الطلب:

جافا سكريبت

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

نقطة نهاية الفائدة المفتوحة

راقب إجمالي الفائدة المفتوحة عبر جميع المتداولين بالرافعة المالية. يشير تباعد الفائدة المفتوحة عن حركة السعر إلى احتمالية حدوث انعكاسات وفرص استمرار الاتجاه. تتبع كل من الفائدة المفتوحة المطلقة ومعدلات تغير الفائدة المفتوحة.

GET /v1/open-interest متداول

المعامل	النوع	الوصف
symbol	string	زوج التداول مطلوب
exchange	string	bybit أو binance أو hyperliquid اختياري
granularity	string	1m أو 5m أو 15m أو 1h أو 4h أو 1d، الافتراضي 15m اختياري

نقطة نهاية التصفية

تُرجع وجهتي نظر متكاملتين لرمز معين: مستويات مُتوقعة بالرافعة المالية levels (تقدير لمكان تجمعات التصفية) و realized_heatmap — شدة التصفية القسرية المنفذة فعليًا (السعر × الوقت) المجمعة مباشرة من قنوات WebSocket العامة للتبادلات: Binance وOKX وBybit وBitget وBitMEX. تظهر خريطة الحرارة عندما يكون هناك بيانات للرمز.

GET /v1/liquidations متداول

المعامل	النوع	الوصف
symbol	string	رمز الأصل، الافتراضي BTC اختياري

متداول تُرجع مخاطر التتابع، المسافات الأقرب، والمجموع/حسب الجانب المنفذ. Pro تُرجم المستويات المتوقعة الكاملة levels بالإضافة إلى realized_heatmap (مصفوفات، تجمعات لكل سعر، أعداد لكل تبادل).

تصفية DeFi على السلسلة

تصفيات DeFi المنفذة من بروتوكولات الإقراض التي تم التقاطها مباشرة من عقد BSC وAvalanche المحلية الخاصة بنا — مستقلة عن أي بوت تداول. تغطي Venus/Cream وMoolah على BSC، وAAVE V3/V2 وBenqi وBankerJoe وGranary وVinium على Avalanche. يتطلب مفتاح مصادقة (Trader+)؛ يُرجع Pro أيضًا المراكز المعرضة للخطر المعتمدة على البوت.

GET /v1/liquidations/onchain متداول

المعامل	النوع	الوصف
chain	string	bsc أو avax؛ اتركه لجميع السلاسل اختياري
limit	integer	الحد الأقصى للصفوف، الافتراضي 100، الحد الأقصى 500 (الأحدث أولاً) اختياري

نقطة نهاية التأكيد

تُرجع نقطة النهاية /v1/confirm درجة تقارب قائمة على القواعد متعددة العوامل confluence تجمع بين المشتقات، على السلسلة (Coin Metrics المجانية: MVRV / تدفق التبادل / العناوين النشطة)، وتحديد مواقع الحيتان. تتراوح الدرجة composite من -1.0 إلى +1.0 (وليس 0–100) وكل استجابة تتضمن تفصيلًا شفافًا لـ factors (درجة كل جزء × الوزن)، adjustments, weights، و coverage. إنه دعم للقرار، وليس ضمانًا لمعدل الفوز. يُرجع الرمز غير المتابع نتيجة صريحة NO_DATA / غير مدعومة بدلاً من نتيجة LOW مصطنعة.

GET /v1/confirm متداول

المعاملات: symbol (BTC/ETH/SOL) و direction (long/short). confidence هي إما HIGH / MEDIUM / LOW / VETO / NO_DATA؛ action هي إما CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP؛ size_mult هو مضاعف حجم المركز المقترح.

نقاط نهاية بيانات On-Chain

الوصول إلى مقاييس On-Chain للبيتكوين والإيثريوم بما في ذلك تدفقات التبادل، تحركات محافظ الحيتان، نسبة MVRV، NUPL، شروط الإنفاق، والتقلب المحقق. تساعد هذه المقاييس في تحديد دورات التراكم/التوزيع وتوفر إشارات مبكرة للانعكاسات الكبرى.

GET /v1/on-chain/metrics Pro

المعامل	النوع	الوصف
asset	string	bitcoin أو ethereum مطلوب
metrics	array	مقاييس محددة: exchange_flows وmvrv وnupl وwhale_moves اختياري
interval	string	1d (يوميًا) أو 1w (أسبوعيًا)، الافتراضي 1d اختياري

مرجع نماذج البيانات

فهم بنية استجابات API ضروري للتكامل. فيما يلي تعريفات نماذج البيانات الكاملة المستخدمة عبر جميع نقاط النهاية.

كائن WhalePosition

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

كائن FundingRateRecord

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

أمثلة التعليمات البرمجية

فيما يلي أمثلة تعليمات برمجية جاهزة للإنتاج لأنماط التكامل الشائعة.

مراقبة مراكز الحيتان باستخدام بايثون

بايثون

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """جلب مراكز الحيتان مع فلتر رمز اختياري"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """الحصول على معدلات التمويل الحالية والتاريخية"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """مراقبة مراكز الحيتان بشكل مستمر"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"Whale {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# Usage
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"Total whale positions: {whales['data']['total']}")

أفضل الممارسات ونصائح الأداء

استخدم التقسيم إلى صفحات: قم دائمًا بتقسيم مجموعات النتائج الكبيرة إلى صفحات. استخدم معلمات الحد والصفحة لجلب البيانات في مجموعات من 50-100 سجل، وليس جميع البيانات مرة واحدة.

قم بتخزين الاستجابات مؤقتًا: مراكز الحيتان لا تتغير كل ثانية. قم بتخزين النتائج مؤقتًا لمدة 30-60 ثانية لتقليل طلبات API وتحسين الأداء.

قم بالتصفية مبكرًا: استخدم معلمات الاستعلام (الرمز، البورصة، الاتجاه) لتصفية البيانات من جانب الخادم، وليس في كود التطبيق الخاص بك.

تعامل مع حدود المعدل: قم بتنفيذ منطق إعادة المحاولة مع التراجع الأسي. عندما تصل إلى حدود المعدل (حالة 429)، انتظر وأعد المحاولة.

استخدم WebSocket للبيانات في الوقت الفعلي: لتدفق البيانات، يفضل استخدام اتصالات WebSocket بدلاً من استطلاع نقاط نهاية REST. ستوفر عرض النطاق الترددي وتحصل على زمن انتقال أقل من الثانية.

تحقق من الطوابع الزمنية: جميع الطوابع الزمنية هي ISO 8601 UTC. قم دائمًا بتحويلها إلى المنطقة الزمنية المحلية الخاصة بك للعرض وقم دائمًا بتخزينها بالتوقيت العالمي المنسق (UTC).

تعامل مع انقطاعات الاتصال: قم بتنفيذ منطق إعادة الاتصال التلقائي مع التراجع الأسي لاتصالات WebSocket.

راقب حصتك: تحقق من رأس X-Requests-Remaining في الاستجابات. خطط لاستخدام API الخاص بك للبقاء ضمن الحد الخاص بمستواك.

أنماط التكامل الشائعة

النمط 1: تنبيه على تراكم الحيتان

قم بإعداد تنبيهات عندما تتجاوز مراكز الحيتان حدًا معينًا، مما يشير إلى احتمالية حدوث صعود قوي أو مراحل تراكم.

النمط 2: اكتشاف المراجحة في معدلات التمويل

اكتشف تلقائيًا عندما تتجاوز فروق معدلات التمويل الحدود المربحة عبر البورصات، مما يتيح تشغيل خوارزميات المراجحة عبر البورصات.

النمط 3: مراقبة تسلسل التصفية

تتبع عمليات التصفية الكبيرة ووضع الخوارزمية للاستفادة من عمليات التصفية المتسلسلة وحركات الأسعار ذات التأثير الكبير.

النمط 4: تأكيد متعدد الإشارات

اجمع بين مراكز الحيتان، معدلات التمويل، المقاييس على السلسلة، ودرجات التأكيد الذكية الخاصة بنا لإشارات دخول عالية الثقة.

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

احصل على مفتاح API الخاص بك من لوحة التحكم وابدأ البناء اليوم. جميع الحسابات الجديدة تحصل على وصول مجاني مع 100 طلبًا يوميًا (BTC, ETH, SOL). قم بالترقية إلى Trader أو Pro للحصول على وصول غير محدود لجميع الرموز والميزات المتقدمة.

احصل على مفتاح API

افتح الميزات الاحترافية

احصل على وصول كامل إلى مراكز الحيتان، درجات التأكيد، البيانات على السلسلة، وأكثر من 2000 طلب API يوميًا.

عرض الأسعار