توثيق API
تجميع البيانات متعدد البورصات والتصفية المتقدمة
إتقان تجميع البيانات عبر Bybit وBinance وHyperliquid مع التصفية المتقدمة والفرز والتوحيد. احصل على رؤى موحدة للسوق من 3+ بورصات في وقت واحد.
نشر في 21 مارس 2026
•
17 دقيقة قراءة
•
متقدم
نظرة عامة على تجميع البيانات
تقوم Smart Money API بتجميع بيانات مشتقات العملات المشفرة من 3 بورصات رئيسية: Bybit وBinance وHyperliquid. بدلاً من إجراء مكالمات API منفصلة لكل بورصة، تحصل على بيانات موحدة مع تصفية ذكية ومقارنة عبر البورصات وإمكانيات تحليلية متقدمة.
لماذا يهم التجميع:
- مكالمة API واحدة — احصل على بيانات من 3 بورصات في وقت واحد دون إدارة اتصالات متعددة
- تنسيق موحد — جميع البورصات موحدة إلى مخطط ثابت
- رؤى عبر البورصات — قارن معدلات التمويل والمراكز والسيولة عبر المنصات
- تصفية ذكية — استعلم عن البيانات الدقيقة التي تحتاجها باستخدام مرشحات قوية
- الأداء — استجابات مجمعة مخزنة في CDN أسرع بـ 50 مرة من التجميع الذاتي
الهيكل: تقوم Smart Money API بجمع البيانات من البورصات كل 1-5 ثوانٍ، وتوحيدها، وتخزينها في حافة CDN، وتقديم استجابات مجمعة مع زمن انتقال أقل من 100 مللي ثانية عالميًا.
البورصات المدعومة
Bybit
الكود: bybit | التغطية: 500+ زوج دائم | تردد التحديث: 1 ثانية
- العقود الآجلة الدائمة USDT (عقود خطية)
- العقود الآجلة الدائمة العكسية (XRP, ETC)
- بيانات كتاب الطلبات الكامل وبيانات التداول
- معدلات التمويل وأسعار العلام
Binance
الكود: binance | التغطية: 800+ زوج دائم | تردد التحديث: 1 ثانية
- العقود الآجلة USDT-M (الدائمة USDT)
- العقود الآجلة COIN-M (العكسية)
- بيانات البنية الدقيقة الكاملة للسوق
- أعلى سيولة عبر الأزواج
Hyperliquid
الكود: hyperliquid | التغطية: 300+ زوج دائم | تردد التحديث: 5 ثوانٍ
- العقود الآجلة الدائمة اللامركزية (بدون هامش)
- نموذج تسوية فريد على السلسلة
- تكامل بيانات محفظة الحيتان الأصلية
- زمن انتقال أقل للمتداولين الخوارزميين
جدول مواصفات البورصة
| البورصة |
الأزواج |
الرافعة المالية |
تردد التحديث |
التسوية |
| bybit |
500+ |
1-125x |
1s |
دائم |
| binance |
800+ |
1-125x |
1s |
دائم |
| hyperliquid |
300+ |
1-20x |
5s |
دائم |
احصل على مفتاح API في 30 ثانية
هل أنت مستعد للبناء؟ احصل على مفتاح API مجاني (100 مكالمة/يوم، بدون بطاقة) وابدأ في سحب بيانات الحيتان والتمويل والبيانات على السلسلة مباشرة.
احصل على مفتاح API →مفاهيم دمج البيانات
التوحيد
كل بورصة لديها أسماء حقول مختلفة ودقة عشرية وهياكل بيانات مختلفة. تقوم Smart Money بتوحيد كل شيء إلى مخطط قياسي:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
محاذاة الطابع الزمني
جميع نقاط البيانات مؤرخة ومحاذاة إلى UTC بالمللي ثانية. يتم التعامل مع البيانات القديمة بشكل شفاف:
- البيانات في الوقت الفعلي: تم الحصول عليها خلال آخر 5 ثوانٍ
- البيانات القديمة: يتم تمييزها بـ age_ms للإشارة إلى التقادم
- البورصات المفقودة: تُرجع نتائج جزئية مع قائمة البورصات
- البيانات القديمة الكاملة: تُرجع نتيجة مخزنة مع cache_age_seconds
البيانات الوصفية عبر البورصات
كل استجابة مجمعة تتضمن بيانات وصفية حول مصادر البيانات:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
الترشيح الأساسي
تصفية حسب البورصة
طلب البيانات من بورصات محددة فقط:
// الحصول على معدلات التمويل من Binance فقط
GET /v1/derivatives/funding-heatmap?exchange=binance
// متعددة البورصات
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
تصفية حسب فئة الأصول
تصفية حسب العملة المشفرة أو زوج التداول:
// أزواج البيتكوين فقط
GET /v1/derivatives/funding-heatmap?asset=BTC
// أصول متعددة
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// أزواج محددة
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
تصفية حسب نطاق المقياس
الاستعلام بناءً على القيم الرقمية:
// معدلات تمويل مرتفعة (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// معدلات تمويل منخفضة (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// فتح مراكز مرتفع
GET /v1/derivatives/oi-rankings?oi_min=100000000
تصفية متقدمة
تصفية مقارنة
العثور على أزواج بخصائص محددة عبر البورصات:
// أزواج بفارق تمويل >5% عبر البورصات
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// اختلاف التصفية
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// أزواج بأعلى نسبة فتح مراكز بين Bybit/Binance
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
تصفية حسب الوقت
استعلام البيانات المجمعة تاريخيًا:
// بيانات من نافذة زمنية محددة
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// آخر 24 ساعة
GET /v1/derivatives/funding-heatmap?lookback=24h
// لقطات على فترات ساعة واحدة
GET /v1/derivatives/historical?interval=1h&limit=24
تصفية مركبة
دمج شروط تصفية متعددة:
// أزواج من الدرجة الأولى: BTC، ETH، SOL
// تمويل إيجابي مرتفع على Binance
// تمويل سلبي على Bybit (مراجحة)
GET /v1/derivatives/funding-heatmap?
asset=BTC,ETH,SOL&
exchange=binance,bybit&
binance_funding_rate_min=0.0003&
bybit_funding_rate_max=-0.0001&
sort=funding_rate_spread:desc
الترتيب والتصنيف
اتجاهات الترتيب
التحكم في ترتيب النتائج:
// أعلى معدلات تمويل أولاً
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// أقل فتح مراكز
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// أحدث طابع زمني
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// ترتيب متعدد الحقول
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
خيارات التصنيف
| الحقل |
الوصف |
النطاق |
| funding_rate |
معدل تمويل العقود الدائمة |
-1.0 إلى 1.0 |
| open_interest |
إجمالي المراكز المفتوحة بالدولار الأمريكي |
0 إلى مليارات |
| mark_price |
سعر العلامة/التسوية للعقد |
إيجابي |
| liquidation_pressure |
مخاطر تصفية المراكز الطويلة مقابل القصيرة |
-1.0 إلى 1.0 |
أنماط تجميع البيانات
تجميع خام
إرجاع جميع نقاط البيانات بشكل منفصل مع تحديد مصدر البورصة:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// الرد: 3 إدخالات منفصلة (واحد لكل بورصة)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
تجميع مدمج
دمج البيانات في سجل واحد مع حقول إحصائية:
GET /v1/derivatives/funding-heatmap?aggregate_mode=merged&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_avg: 0.000103,
funding_rate_median: 0.00010,
funding_rate_min: 0.00009,
funding_rate_max: 0.00012,
funding_rate_spread: 0.00003,
sources: { bybit, binance, hyperliquid }
}
تجميع مركب
تجميع إحصائي مع درجات ثقة:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% اتفاق
outliers: [],
weighted_avg: 0.000102, // مرجح حسب السيولة
exchange_details: { ... }
}
توحيد البيانات
توحيد السعر
يتم توحيد جميع الأسعار إلى 8 منازل عشرية وعملة USDT:
- Bybit: يتم توحيد أزواج USDT مباشرة
- Binance: يتم تحويل USDT-M و COIN-M إلى الشكل القياسي
- Hyperliquid: يتم تحويل USDT الأصلي بشكل ثابت
تطبيع الحجم
يتم الإبلاغ عن جميع الأحجام بوحدات الأصل الأساسي:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
تطبيع الطابع الزمني
- جميع الطوابع الزمنية بوحدة المللي ثانية بالتوقيت العالمي المنسق (13 رقمًا)
- مزامنة مع ساعة بوابة API
- ضبط العمر للبيانات المجمعة في أوقات مختلفة
- غير مرتبط بمنطقة زمنية (دائمًا بالتوقيت العالمي المنسق)
أمثلة عملية للاستعلام
المثال 1: فرص المراجحة في معدل التمويل
ابحث عن الأزواج ذات أعلى فرق بين التمويل الطويل في Binance والتمويل القصير في Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
المثال 2: عقود ذات فائدة مفتوحة عالية
احصل على العقود ذات الفائدة المفتوحة الكبيرة عبر جميع المنصات:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
المثال 3: تجميع السلاسل الزمنية
معدلات التمويل التاريخية على فترات 4 ساعات:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
إتقان بيانات المنصات المتعددة
احصل على بيانات مشتطة موحدة من Bybit وBinance وHyperliquid مع تصفية قوية وتجميع وتطبيع. وفر وقت الهندسة وتقليل تكاليف API.
عرض الخطط
تشمل الطبقة المجانية التجميع الأساسي. تفتح خطط المتاجر والمحترف التصفية المتقدمة والاستعلامات التاريخية.