Dokumentasi API
Agregasi Data Multi-Bursa dan Penyaringan Lanjutan
Kuasi agregasi data lintas Bybit, Binance, dan Hyperliquid dengan penyaringan lanjutan, pengurutan, dan normalisasi. Dapatkan wawasan pasar terpadu dari 3+ bursa secara bersamaan.
Dipublikasikan pada 21 Maret 2026
•
17 menit baca
•
Lanjutan
Ikhtisar Agregasi Data
Smart Money API mengagregasi data derivatif kripto dari 3 bursa utama: Bybit, Binance, dan Hyperliquid. Alih-alih membuat panggilan API terpisah ke setiap bursa, Anda mendapatkan data terpadu dengan penyaringan cerdas, perbandingan lintas bursa, dan kemampuan analitis lanjutan.
Mengapa agregasi penting:
- Satu Panggilan API — Dapatkan data dari 3 bursa secara bersamaan tanpa mengelola banyak koneksi
- Format Ternormalisasi — Semua bursa distandarisasi ke skema yang konsisten
- Wawasan Lintas Bursa — Bandingkan tingkat pendanaan, posisi, dan likuiditas di berbagai tempat
- Penyaringan Cerdas — Kueri data yang Anda butuhkan dengan filter yang kuat
- Performa — Respons agregasi yang di-cache CDN 50x lebih cepat daripada mengagregasi sendiri
Arsitektur: Smart Money API mengumpulkan data dari bursa setiap 1-5 detik, menormalkannya, menyimpannya di tepi CDN, dan menyajikan respons agregasi dengan latensi di bawah 100ms secara global.
Bursa yang Didukung
Bybit
Kode: bybit | Cakupan: 500+ pasangan perpetual | Frekuensi Pembaruan: 1 detik
- Futures perpetual USDT (kontrak linear)
- Perpetual terbalik (XRP, ETC)
- Data buku pesanan dan perdagangan lengkap
- Tingkat pendanaan dan harga mark
Binance
Kode: binance | Cakupan: 800+ pasangan perpetual | Frekuensi Pembaruan: 1 detik
- Futures perpetual USDT-M (USDT perpetual)
- Futures COIN-M (terbalik)
- Data mikrostruktur pasar lengkap
- Likuiditas tertinggi di seluruh pasangan
Hyperliquid
Kode: hyperliquid | Cakupan: 300+ pasangan perpetual | Frekuensi Pembaruan: 5 detik
- Futures perpetual terdesentralisasi (tanpa margin)
- Model penyelesaian on-chain yang unik
- Integrasi data dompet paus asli
- Latensi lebih rendah untuk trader algoritmik
Tabel Spesifikasi Bursa
| Bursa |
Pasangan |
Leverage |
Frekuensi Pembaruan |
Penyelesaian |
| bybit |
500+ |
1-125x |
1s |
Perpetual |
| binance |
800+ |
1-125x |
1s |
Perpetual |
| hyperliquid |
300+ |
1-20x |
5s |
Perpetual |
Dapatkan kunci API Anda dalam 30 detik
Siap membangun? Ambil kunci API gratis (100 panggilan/hari, tanpa kartu) dan mulai menarik data paus, pendanaan, dan on-chain langsung.
Dapatkan kunci API Anda →
Konsep Fusi Data
Normalisasi
Setiap bursa memiliki nama bidang, presisi desimal, dan struktur data yang berbeda. Smart Money menormalkan semuanya ke skema standar:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Penjajaran Timestamp
Semua titik data diberi timestamp dan diselaraskan ke milidetik UTC. Data lama ditangani secara transparan:
- Data real-time: bersumber dalam 5 detik terakhir
- Data yang menua: ditandai dengan age_ms yang menunjukkan ketidakaktifan
- Bursa yang hilang: mengembalikan hasil parsial dengan daftar bursa
- Data basi lengkap: mengembalikan hasil yang di-cache dengan cache_age_seconds
Metadata Lintas Bursa
Setiap respons agregasi mencakup metadata tentang sumber data:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Filter Dasar
Filter berdasarkan Exchange
Minta data hanya dari exchange tertentu:
// Dapatkan funding rate hanya dari Binance
GET /v1/derivatives/funding-heatmap?exchange=binance
// Multiple exchange
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Filter berdasarkan Kelas Aset
Filter berdasarkan cryptocurrency atau trading pair:
// Hanya pair BTC
GET /v1/derivatives/funding-heatmap?asset=BTC
// Multiple aset
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Pair spesifik
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Filter berdasarkan Rentang Metrik
Query berdasarkan nilai numerik:
// Funding rate tinggi (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Funding rate rendah (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Open interest tinggi
GET /v1/derivatives/oi-rankings?oi_min=100000000
Filter Lanjutan
Filter Komparatif
Temukan pair dengan karakteristik spesifik di berbagai exchange:
// Pair dengan perbedaan funding >5% antar exchange
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Divergensi likuidasi
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Pair dengan rasio open interest Bybit/Binance tertinggi
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Filter Berbasis Waktu
Query data agregasi historis:
// Data dari jendela waktu spesifik
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// 24 jam terakhir
GET /v1/derivatives/funding-heatmap?lookback=24h
// Snapshot dengan interval 1 jam
GET /v1/derivatives/historical?interval=1h&limit=24
Filter Komposit
Gabungkan beberapa kondisi filter:
// Pair top tier: BTC, ETH, SOL
// Funding positif tinggi di Binance
// Funding negatif di Bybit (arbitrase)
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
Sorting dan Ranking
Arah Sorting
Kontrol urutan hasil:
// Funding rate tertinggi pertama
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Open interest terendah
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Timestamp terbaru
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Multi-field sort
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Opsi Ranking
| Field |
Deskripsi |
Rentang |
| funding_rate |
Funding rate kontrak perpetual |
-1.0 hingga 1.0 |
| open_interest |
Total posisi terbuka dalam USD |
0 hingga miliaran |
| mark_price |
Harga mark/settlement kontrak |
Positif |
| liquidation_pressure |
Risiko likuidasi long vs short |
-1.0 hingga 1.0 |
Mode Agregasi Data
Agregasi Mentah
Kembalikan semua titik data terpisah dengan identifikasi sumber exchange:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Respons: 3 entri terpisah (satu per exchange)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Agregasi Gabungan
Gabungkan data menjadi satu record dengan field statistik:
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 }
}
Agregasi Komposit
Agregasi statistik dengan skor kepercayaan:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% kesepakatan
outliers: [],
weighted_avg: 0.000102, // berbobot likuiditas
exchange_details: { ... }
}
Normalisasi Data
Normalisasi Harga
Semua harga dinormalisasi ke 8 desimal dan denominasi USDT:
- Bybit: Pair USDT dinormalisasi langsung
- Binance: USDT-M dan COIN-M keduanya dikonversi ke bentuk standar
- Hyperliquid: Native USDT dikonversi secara konsisten
Normalisasi Volume
Semua volume dilaporkan dalam unit aset dasar:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Normalisasi Timestamp
- Semua timestamp dalam milidetik UTC (13 digit)
- Disinkronkan dengan jam API gateway
- Penyesuaian usia untuk data yang dikumpulkan pada waktu berbeda
- Tidak tergantung zona waktu (selalu UTC)
Contoh Kueri Praktis
Contoh 1: Peluang Arbitrase Tingkat Pendanaan
Temukan pasangan dengan spread tertinggi antara pendanaan panjang Binance dan pendanaan pendek Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Contoh 2: Kontrak dengan Open Interest Tinggi
Dapatkan kontrak dengan open interest signifikan di semua exchange:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Contoh 3: Agregasi Time Series
Tingkat pendanaan historis dalam interval 4 jam:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Kuasai Data Multi-Exchange
Dapatkan data derivatif terpadu dari Bybit, Binance, dan Hyperliquid dengan penyaringan, agregasi, dan normalisasi yang kuat. Hemat waktu rekayasa dan kurangi biaya API.
Lihat Paket
Tingkat gratis mencakup agregasi dasar. Paket Trader dan Pro membuka kunci penyaringan lanjutan dan kueri historis.