جدول المحتويات

نظرة عامة شموع OHLCV خيارات الإطار الزمني استعلامات تاريخية فترات التجميع تاريخ تحركات الحيتان تاريخ معدل التمويل بيانات الاختبار الخلفي أمثلة استخدام أفضل الممارسات

توثيق API

بيانات السلاسل الزمنية واستعلامات التحليل التاريخي

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

نشر في 21 مارس 2026 • 15 دقيقة قراءة • بحث

نظرة عامة على البيانات التاريخية

يوفر Smart Money API بيانات تاريخية لمدة 24 شهرًا تمكن من إجراء بحث شامل واختبار خلفي وتحليل زمني. جميع البيانات التاريخية موحدة، ومكررة، ومتاحة على مستويات تجميع متعددة.

تشمل البيانات التاريخية المتاحة:

شموع OHLCV — افتتاح، أعلى، أدنى، إغلاق، حجم لجميع الأزواج المتداولة
تحركات الحيتان — تراكم/توزيع تاريخي بدقة يومية وساعية
معدلات التمويل — لقطات تاريخية لمعدل التمويل لجميع أزواج العقود الدائمة
الاهتمام المفتوح — بيانات OI التاريخية عبر جميع البورصات والأطر الزمنية
التصفية — تصفيات تاريخية متتالية ونقاط ضغط

احتفاظ البيانات: يتم الاحتفاظ ببيانات التجزئة الكاملة لمدة 90 يومًا. يتم الاحتفاظ ببيانات التجميع اليومية/الساعية لمدة 24 شهرًا. أرشيفات البيانات الخام متاحة للتنزيل.

بيانات شموع OHLCV

بيانات افتتاح-أعلى-أدنى-إغلاق-حجم للتحليل الفني ورسم الرسوم البيانية. متاحة لجميع أزواج العملات المشفرة عبر أطر زمنية من دقيقة واحدة إلى شهر واحد.

هيكل بيانات OHLCV

شمعة OHLCV
{
 "timestamp": 1709980800000,
 "symbol": "BTCUSDT",
 "timeframe": "1h",
 "open": 71250.50,
 "high": 72500.00,
 "low": 71000.25,
 "close": 72250.75,
 "volume_base": 1234.5,
 "volume_quote": 89234500,
 "trades": 45678
}

استعلام بيانات OHLCV

استعلام OHLCV التاريخي
// احصل على شموع لمدة ساعة واحدة لآخر 30 يومًا
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

احصل على مفتاح API في 30 ثانية

هل أنت مستعد للبناء؟ احصل على مفتاح API مجاني (100 استدعاء/يوم، بدون بطاقة) وابدأ في سحب بيانات الحيتان والتمويل والبيانات على السلسلة مباشرة.

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

الأطر الزمنية المتاحة

خيارات الإطار الزمني

الإطار الزمني	المدة	حالة الاستخدام	أقصى مدة للرجوع
1m	1 دقيقة	تداول عالي التردد، المضاربة	30 يومًا
5m	5 دقائق	التداول اليومي، تداول الأرجوحة	90 يومًا
15m	15 دقيقة	تداول يومي، كشف الإشارات	180 يومًا
1h	1 ساعة	تداول متوسط المدى، تحليل	365 يومًا
4h	4 ساعات	تداول الأرجوحة، تحليل الاتجاه	24 شهرًا
1d	1 يوم	تحديد مواقع طويلة المدى، بحث	24 شهرًا
1w	1 أسبوع	تحليل ماكرو، اتجاهات متعددة السنوات	24 شهرًا
1M	1 شهر	تحديد مواقع استراتيجي	24 شهرًا

مجموعات الإطار الزمني

استفسر عن أطر زمنية متعددة في وقت واحد:

استعلام متعدد الأطر الزمنية
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// يعود بأحدث شمعة لكل إطار زمني

أنماط الاستعلام التاريخي

استعلامات زمنية

استعلام النطاق الزمني
// استعلام عن نطاق زمني محدد
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// أو استخدم مدة الرجوع النسبية
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

ترقيم الصفحات لمجموعات البيانات الكبيرة

نمط الترقيم
// الصفحة الأولى: 1000 شمعة
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// الصفحة التالية باستخدام المؤشر
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

فترات التجميع

تجميع الوقت الثابت

تجميع البيانات على فترات ثابتة (كل ساعة، يوميًا، أسبوعيًا):

تجميع ثابت
// لقطات يومية لمدة شهر
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

تجميع مخصص

تجميع على نوافذ زمنية مخصصة:

نوافذ مخصصة
// تجميع شموع 1 دقيقة إلى 15 دقيقة
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

تاريخ حركة الحيتان

تتبع الحيتان التاريخي

تاريخ الحيتان
// أنماط تراكم الحيتان التاريخية
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// الحركة التاريخية حول مستويات الأسعار
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

هيكل بيانات الحيتان

نقطة بيانات الحوت
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

تاريخ معدل التمويل

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

تاريخ معدل التمويل
// الحصول على لقطات معدل التمويل كل ساعة
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// مقارنة المعدلات التاريخية عبر البورصات
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

إحصائيات معدل التمويل

استعلام إحصائيات معدل التمويل المجمعة:

استعلام الإحصائيات
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// الرد يتضمن:
// - متوسط معدل التمويل السنوي
// - التوزيع (الانحراف المعياري)
// - التطرفات التاريخية
// - رتب النسب المئوية

الوصول إلى بيانات الاختبار الخلفي

تنسيق استعلام الاختبار الخلفي

مُحسَّن لأطر الاختبار الخلفي مثل Backtrader و VectorBT والمحركات المخصصة:

بيانات الاختبار الخلفي
// الحصول على جميع البيانات لاختبار خلفي لمدة عام
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT&
  timeframe=1h&
  start=2024-01-01&
  end=2025-01-01&
  fields=ohlcv,funding_rate,oi,whale_flow

تنسيقات التصدير

تنزيل البيانات التاريخية للتحليل دون اتصال:

CSV — تنسيق عمودي قياسي لجداول البيانات
JSON — تنسيق منظم مع جميع البيانات الوصفية
Parquet — تنسيق عمودي مضغوط لعلوم البيانات
HDF5 — تنسيق مُحسَّن للسلاسل الزمنية

استعلام التصدير
// تصدير كملف CSV
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

أمثلة عملية

المثال 1: بحث سوق الثيران 2024

تحليل سوق الثيران
// ربط حركة الحيتان بحركة السعر
GET /v1/historical/correlated-data?
  asset=BTC&
  start_time=2024-01-01&
  end_time=2024-12-31&
  include=ohlcv,whale_accumulation,funding_rates&
  interval=1d

المثال 2: اختبار استراتيجية معدل التمويل

اختبار استراتيجية
// الحصول على بيانات استراتيجية الارتداد المتوسط لمعدل التمويل
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT,BNBUSDT&
  timeframe=4h&
  start=2023-01-01&
  end=2025-01-01&
  exchange=binance&
  fields=funding_rate,open_interest,liquidations

أفضل الممارسات للبيانات التاريخية

1. اختر الإطارات الزمنية المناسبة

استخدم أصغر إطار زمني مطلوب لتحليلك. بيانات الدقيقة الواحدة أكثر تكلفة من البيانات بالساعة.

2. حدد النطاقات الزمنية

استخدم دائمًا معلمات start_time/end_time أو lookback. الاستعلامات المفتوحة غير فعالة.

3. خزن الاستعلامات التاريخية مؤقتًا

البيانات التاريخية ثابتة. خزنها بفعالية (TTL لمدة 30 يومًا للبيانات الشهرية).

4. استخدم التقسيم للنتائج الكبيرة

بيانات الدقيقة الواحدة لمدة عام = 525,600 شمعة. استخدم التقسيم والتدفق لمجموعات البيانات الكبيرة.

5. تحقق من اكتمال البيانات

تحقق من بيانات الاستجابة للفجوات أو البورصات المفقودة قبل استخدام البيانات في التحليل.

الوصول إلى البيانات التاريخية للبحث

24 شهرًا من بيانات OHLCV، وحركة الحيتان، ومعدل التمويل. مثالي لاختبار الاستراتيجيات، والبحث، وتطوير الاستراتيجيات.

عرض الخطط

الطبقة المجانية: تاريخ 30 يومًا. المحترف: 24 شهرًا. المؤسسة: وصول كامل إلى الأرشيف.