فهرست مطالب

مرور کلی شمع‌های OHLCV گزینه‌های بازه زمانی پرس‌و‌جوهای تاریخی فواصل تجمیع تاریخچه حرکت نهنگ‌ها تاریخچه نرخ تامین مالی داده‌های بکتست نمونه‌های استفاده بهترین روش‌ها

مستندات API

داده‌های سری زمانی و پرس‌و‌جوهای تحلیل تاریخی

به داده‌های جامع سری زمانی برای بکتست، تحقیق و تحلیل تاریخی دسترسی پیدا کنید. شمع‌های OHLCV، نرخ‌های تامین مالی تاریخی، خطوط زمانی حرکت نهنگ‌ها و تصاویر بازار تجمیع شده در بازه‌های زمانی مختلف را پرس‌و‌جو کنید.

منتشر شده در ۲۱ مارس ۲۰۲۶ • ۱۵ دقیقه زمان مطالعه • تحقیق

مرور کلی داده‌های تاریخی

Smart Money API داده‌های تاریخی ۲۴ ماهه را فراهم می‌کند که امکان تحقیق جامع، بکتست و تحلیل مبتنی بر زمان را فراهم می‌کند. تمام داده‌های تاریخی نرمال‌سازی، حذف تکراری‌ها و در سطوح تجمیع مختلف در دسترس هستند.

داده‌های تاریخی موجود شامل:

شمع‌های OHLCV — باز، بالا، پایین، بسته، حجم برای تمام جفت‌های معامله شده
حرکات نهنگ‌ها — تجمع/توزیع تاریخی با وضوح روزانه و ساعتی
نرخ‌های تامین مالی — تصاویر نرخ تامین مالی تاریخی برای تمام جفت‌های دائمی
علاقه باز — داده‌های تاریخی OI در تمام صرافی‌ها و بازه‌های زمانی
نقدینگی‌ها — آبشارهای نقدینگی تاریخی و نقاط فشار

نگهداری داده‌ها: داده‌های تیک کامل برای ۹۰ روز نگهداری می‌شوند. داده‌های تجمیع شده ساعتی/روزانه برای ۲۴ ماه نگهداری می‌شوند. آرشیوهای خام برای دانلود در دسترس هستند.

داده‌های شمعی 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
// دریافت شمع‌های ۱ ساعته برای ۳۰ روز گذشته
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

کلید API خود را در ۳۰ ثانیه دریافت کنید

آماده ساخت هستید؟ یک کلید API رایگان دریافت کنید (۵۰ تماس در روز، بدون کارت) و شروع به کشیدن داده‌های زنده نهنگ، تامین مالی و زنجیره‌ای کنید.

کلید 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

فواصل تجمیع

تجمیع زمان ثابت

تجمیع داده‌ها در فواصل زمانی ثابت (ساعتی، روزانه، هفتگی):

تجمیع ثابت
// تصاویر روزانه برای 1 ماه
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 و موتورهای سفارشی:

داده‌های بکتست
// دریافت تمام داده‌ها برای بکتست 1 ساله
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

مثال ۲: بکتست استراتژی نرخ تأمین مالی

بکتست استراتژی
// دریافت داده‌ها برای استراتژی بازگشت به میانگین نرخ تأمین مالی
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

بهترین روش‌های داده‌های تاریخی

۱. انتخاب بازه‌های زمانی مناسب

کوچکترین بازه زمانی مورد نیاز برای تحلیل خود را استفاده کنید. داده‌های ۱ دقیقه‌ای گران‌تر از داده‌های ساعتی هستند.

۲. محدوده زمانی را مشخص کنید

همیشه از پارامترهای start_time/end_time یا lookback استفاده کنید. کوئری‌های بدون محدوده زمانی ناکارآمد هستند.

۳. ذخیره کوئری‌های تاریخی

داده‌های تاریخی تغییرناپذیرند. آن‌ها را به‌صورت تهاجمی کش کنید (TTL 30 روزه برای داده‌های ماهانه).

۴. از صفحه‌بندی برای نتایج بزرگ استفاده کنید

داده‌های ۱ دقیقه‌ای در طول ۱ سال = ۵۲۵,۶۰۰ کندل. برای مجموعه‌داده‌های بزرگ از صفحه‌بندی و استریمینگ استفاده کنید.

۵. بررسی کامل‌بودن داده‌ها

قبل از استفاده از داده‌ها در تحلیل، متادیتای پاسخ را برای شکاف‌ها یا صرافی‌های缺失 بررسی کنید.

دسترسی به داده‌های تاریخی برای تحقیق

۲۴ ماه داده OHLCV، حرکت نهنگ‌ها و نرخ تأمین مالی. مناسب برای بکتست، تحقیق و توسعه استراتژی.

مشاهده طرح‌ها

طرح رایگان: تاریخچه ۳۰ روز. طرح حرفه‌ای: ۲۴ ماه. طرح سازمانی: دسترسی به آرشیو کامل.