فهرست مطالب

مرور کلی صرافی‌های پشتیبانی شده مفاهیم ادغام داده‌ها فیلترهای پایه فیلترهای پیشرفته مرتب‌سازی و رتبه‌بندی گردآوری داده‌ها یکسان‌سازی داده‌ها نمونه‌های کوئری نکات عملکردی

مستندات 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 رایگان دریافت کنید (50 فراخوان در روز، بدون نیاز به کارت) و شروع به دریافت داده‌های زنده نهنگ، تأمین مالی و زنجیره‌ای کنید.

دریافت کلید 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
  }
}

فیلتر پایه

فیلتر بر اساس صرافی

درخواست داده فقط از صرافی‌های خاص:

فیلتر تک صرافی
// دریافت نرخ‌های تأمین مالی فقط از بایننس
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
// جفت‌ها با بالاترین نسبت سود باز بایبیت/بایننس
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
// تصاویر در فواصل 1 ساعته
GET /v1/derivatives/historical?interval=1h&limit=24

فیلترهای ترکیبی

ترکیب چند شرط فیلتر:

پرس‌وجو پیچیده
// جفت‌های سطح بالا: BTC, ETH, SOL
// نرخ تأمین مالی مثبت بالا در بایننس
// نرخ تأمین مالی منفی در بایبیت (آربیتراژ)
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,  // BTC
 "volume_quote": 89234500,  // USDT
 "num_trades": 45678
}

نرمال سازی زمان‌مهر

تمامی زمان‌مهرها بر اساس میلی‌ثانیه UTC (13 رقمی)
همگام‌سازی با ساعت دروازه API
تنظیم سن برای داده‌های جمع‌آوری شده در زمان‌های مختلف
مستقل از منطقه زمانی (همیشه UTC)

نمونه‌های عملی کوئری

مثال 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

نکات عملکردی

1. استفاده از فیلترهای خاص

هرچه کوئری شما خاص‌تر باشد، پاسخ سریع‌تر خواهد بود. فیلتر کردن 800 جفت به 5 جفت سریع‌تر از درخواست همه است.

2. محدود کردن مجموعه نتایج

همیشه یک پارامتر limit مشخص کنید. مقدار پیش‌فرض 100 و حداکثر 1000 است. مجموعه‌های نتیجه بزرگ‌تر کندتر هستند و پهنای باند بیشتری مصرف می‌کنند.

3. انتخاب حالت تجمیع

حالت‌های merged و composite برای مجموعه‌داده‌های کوچک سریع‌تر از حالت raw هستند. حالت raw برای تحلیل دقیق صرافی‌های فردی بهتر است.

4. کش‌گذاری تهاجمی

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

5. استفاده از محدوده‌های زمانی خاص

کوئری‌های تاریخی با پنجره‌های زمانی محدود بسیار سریع‌تر از پارامترهای بازگشتی باز هستند.

تسلط بر داده‌های چندصرافی

دریافت داده‌های یکپارچه مشتقات از Bybit، Binance و Hyperliquid با فیلترهای قدرتمند، تجمیع و نرمال‌سازی. صرفه‌جویی در زمان مهندسی و کاهش هزینه‌های API.

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

طرح رایگان شامل تجمیع پایه است. طرح‌های Trader و Pro فیلترهای پیشرفته و کوئری‌های تاریخی را باز می‌کنند.