API ডকুমেন্টেশন
মাল্টি-এক্সচেঞ্জ ডেটা অ্যাগ্রিগেশন এবং অ্যাডভান্সড ফিল্টারিং
বাইবিট, বাইন্যান্স এবং হাইপারলিকুইড জুড়ে অ্যাডভান্সড ফিল্টারিং, সর্টিং এবং নরমালাইজেশন সহ মাস্টার ডেটা অ্যাগ্রিগেশন। ৩+ এক্সচেঞ্জ থেকে একইসাথে ইউনিফাইড মার্কেট ইনসাইট পাবেন।
প্রকাশিত মার্চ ২১, ২০২৬
•
১৭ মিনিটের পড়া
•
অ্যাডভান্সড
ডেটা অ্যাগ্রিগেশন ওভারভিউ
স্মার্ট মানি API ক্রিপ্টোকারেন্সি ডেরিভেটিভস ডেটা ৩টি প্রধান এক্সচেঞ্জ থেকে অ্যাগ্রিগেট করে: বাইবিট, বাইন্যান্স এবং হাইপারলিকুইড। প্রতিটি এক্সচেঞ্জে আলাদা API কল করার বদলে, আপনি ইউনিফাইড ডেটা পাবেন স্মার্ট ফিল্টারিং, ক্রস-এক্সচেঞ্জ কম্প্যারিজন এবং অ্যাডভান্সড অ্যানালিটিক্যাল ক্যাপাবিলিটিস সহ।
অ্যাগ্রিগেশন কেন গুরুত্বপূর্ণ:
- সিঙ্গল API কল — একাধিক কানেকশন ম্যানেজ না করেই ৩টি এক্সচেঞ্জ থেকে একইসাথে ডেটা পাবেন
- নরমালাইজড ফরম্যাট — সব এক্সচেঞ্জ কনসিস্টেন্ট স্কিমায় স্ট্যান্ডার্ডাইজড
- ক্রস-এক্সচেঞ্জ ইনসাইটস — ফান্ডিং রেট, পজিশন এবং লিকুইডিটি ভেন্যু জুড়ে কম্পেয়ার করুন
- ইন্টেলিজেন্ট ফিল্টারিং — পাওয়ারফুল ফিল্টার দিয়ে আপনার প্রয়োজনীয় এক্সাক্ট ডেটা কোয়েরি করুন
- পারফরম্যান্স — CDN-ক্যাশড অ্যাগ্রিগেটেড রেস্পন্স নিজে অ্যাগ্রিগেট করার চেয়ে ৫০x ফাস্ট
আর্কিটেকচার: স্মার্ট মানি API প্রতি ১-৫ সেকেন্ডে এক্সচেঞ্জ থেকে ডেটা কালেক্ট করে, নরমালাইজ করে, CDN এজে ক্যাশ করে এবং সাব-১০০মিলিসেকেন্ড লেটেন্সিতে গ্লোবালি অ্যাগ্রিগেটেড রেস্পন্স সার্ভ করে।
সাপোর্টেড এক্সচেঞ্জসমূহ
বাইবিট
কোড: bybit | কভারেজ: ৫০০+ পারপেচুয়াল পেয়ার | আপডেট ফ্রিকোয়েন্সি: ১ সেকেন্ড
- USDT পারপেচুয়াল ফিউচার্স (লিনিয়ার কন্ট্রাক্টস)
- ইনভার্স পারপেচুয়ালস (XRP, ETC)
- কমপ্লিট অর্ডার বুক এবং ট্রেড ডেটা
- ফান্ডিং রেট এবং মার্ক প্রাইস
বাইন্যান্স
কোড: binance | কভারেজ: ৮০০+ পারপেচুয়াল পেয়ার | আপডেট ফ্রিকোয়েন্সি: ১ সেকেন্ড
- USDT-M (USDT পারপেচুয়াল) ফিউচার্স
- COIN-M (ইনভার্স) ফিউচার্স
- কমপ্লিট মার্কেট মাইক্রোস্ট্রাকচার ডেটা
- হায়েস্ট লিকুইডিটি অ্যাক্রস পেয়ার্স
হাইপারলিকুইড
কোড: hyperliquid | কভারেজ: ৩০০+ পারপেচুয়াল পেয়ার | আপডেট ফ্রিকোয়েন্সি: ৫ সেকেন্ড
- ডিসেন্ট্রালাইজড পারপেচুয়াল ফিউচার্স (নো মার্জিন)
- ইউনিক অন-চেইন সেটেলমেন্ট মডেল
- নেটিভ হোয়েল ওয়ালেট ডেটা ইন্টিগ্রেশন
- লোয়ার লেটেন্সি ফর অ্যালগোরিদমিক ট্রেডার্স
এক্সচেঞ্জ স্পেসিফিকেশন টেবিল
| এক্সচেঞ্জ |
পেয়ার্স |
লিভারেজ |
আপডেট ফ্রিক |
সেটেলমেন্ট |
| bybit |
500+ |
১-১২৫x |
১s |
পারপেচুয়াল |
| binance |
800+ |
১-১২৫x |
১s |
পারপেচুয়াল |
| hyperliquid |
300+ |
১-২০x |
৫s |
পারপেচুয়াল |
৩০ সেকেন্ডে আপনার API কী পাবেন
বিল্ড করতে প্রস্তুত? ফ্রি API কী নিন (৫০ কল/দিন, নো কার্ড) এবং লাইভ হোয়েল, ফান্ডিং এবং অন-চেইন ডেটা পুল করা শুরু করুন।
আপনার API কী পাবেন →
ডেটা ফিউশন কনসেপ্টস
নরমালাইজেশন
প্রতিটি এক্সচেঞ্জের আলাদা ফিল্ড নাম, ডেসিমাল প্রিসিশন এবং ডেটা স্ট্রাকচার আছে। স্মার্ট মানি সবকিছুকে স্ট্যান্ডার্ড স্কিমায় নরমালাইজ করে:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
টাইমস্ট্যাম্প অ্যালাইনমেন্ট
সব ডেটা পয়েন্ট টাইমস্ট্যাম্পড এবং UTC মিলিসেকেন্ডে অ্যালাইনড। পুরনো ডেটা ট্রান্সপারেন্টলি হ্যান্ডেলড হয়:
- রিয়েল-টাইম ডেটা: শেষ ৫ সেকেন্ডে সোর্সড
- এজিং ডেটা: 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
অ্যাসেট ক্লাস দ্বারা ফিল্টার করুন
ক্রিপ্টোকারেন্সি বা ট্রেডিং পেয়ার দ্বারা ফিল্টার করুন:
// শুধুমাত্র Bitcoin পেয়ার
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
// 1-ঘন্টা ব্যবধানে স্ন্যাপশট
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 |
USD-তে মোট ওপেন পজিশন |
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
}
টাইমস্ট্যাম্প নরমালাইজেশন
- সমস্ত টাইমস্ট্যাম্প 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
মাল্টি-এক্সচেঞ্জ ডেটা মাস্টার করুন
Bybit, Binance, এবং Hyperliquid থেকে একীভূত ডেরিভেটিভস ডেটা পাওয়ারফুল ফিল্টারিং, অ্যাগ্রিগেশন, এবং নরমালাইজেশন সহ। ইঞ্জিনিয়ারিং সময় বাঁচান এবং API খরচ কমিয়ে দিন।
প্ল্যান দেখুন
ফ্রি টিয়ারে বেসিক অ্যাগ্রিগেশন অন্তর্ভুক্ত। ট্রেডার এবং প্রো প্ল্যানগুলি অ্যাডভান্সড ফিল্টারিং এবং ঐতিহাসিক ক্যোয়ারী আনলক করে।