API Documentation
Multi-Exchange Data Aggregation at Advanced Filtering
Pangunahing data aggregation sa Bybit, Binance, at Hyperliquid na may advanced na filtering, pag-uuri, at normalization. Kumuha ng pinag-isang market insights mula sa 3+ exchanges nang sabay-sabay.
Na-publish noong Marso 21, 2026
•
17 min read
•
Advanced
Pangkalahatang-ideya ng Data Aggregation
Ang Smart Money API ay nag-aaggregate ng cryptocurrency derivatives data mula sa 3 pangunahing exchanges: Bybit, Binance, at Hyperliquid. Sa halip na gumawa ng hiwalay na API calls sa bawat exchange, makakakuha ka ng pinag-isang data na may smart filtering, cross-exchange comparison, at advanced analytical capabilities.
Bakit mahalaga ang aggregation:
- Single API Call — Kumuha ng data mula sa 3 exchanges nang sabay-sabay nang hindi namamahala ng maraming koneksyon
- Normalized Format — Lahat ng exchanges ay standardized sa consistent na schema
- Cross-Exchange Insights — Ihambing ang funding rates, positions, at liquidity sa iba't ibang venues
- Intelligent Filtering — I-query ang eksaktong data na kailangan mo gamit ang malalakas na filter
- Performance — CDN-cached aggregated responses ay 50x mas mabilis kaysa sa pag-aggregate mo mismo
Arkitektura: Ang Smart Money API ay kumukuha ng data mula sa exchanges tuwing 1-5 segundo, ina-normalize ito, ini-cache sa CDN edge, at naghahatid ng aggregated responses na may sub-100ms latency globally.
Suportadong Exchanges
Bybit
Code: bybit | Coverage: 500+ perpetual pairs | Update Frequency: 1 second
- USDT perpetual futures (linear contracts)
- Inverse perpetuals (XRP, ETC)
- Complete order book at trade data
- Funding rates at mark prices
Binance
Code: binance | Coverage: 800+ perpetual pairs | Update Frequency: 1 second
- USDT-M (USDT perpetual) futures
- COIN-M (inverse) futures
- Complete market microstructure data
- Pinakamataas na liquidity sa mga pairs
Hyperliquid
Code: hyperliquid | Coverage: 300+ perpetual pairs | Update Frequency: 5 seconds
- Decentralized perpetual futures (no margin)
- Unique on-chain settlement model
- Native whale wallet data integration
- Mas mababang latency para sa algorithmic traders
Exchange Specifications Table
| Exchange |
Pairs |
Leverage |
Update Freq |
Settlement |
| bybit |
500+ |
1-125x |
1s |
Perpetual |
| binance |
800+ |
1-125x |
1s |
Perpetual |
| hyperliquid |
300+ |
1-20x |
5s |
Perpetual |
Kunin ang iyong API key sa loob ng 30 segundo
Handa nang mag-build? Kumuha ng libreng API key (200 calls/day, no card) at simulan nang kumuha ng live whale, funding, at on-chain data.
Kunin ang iyong API key →Mga Konsepto ng Data Fusion
Normalization
Ang bawat exchange ay may iba't ibang field names, decimal precision, at data structures. Ang Smart Money ay nag-no-normalize ng lahat sa isang standard schema:
{
"exchange": "bybit",
"symbol": "BTCUSDT",
"funding_rate": 0.0001,
"mark_price": 72500.50,
"index_price": 72480.25,
"open_interest": 850000000,
"timestamp": 1709980800000
}
Timestamp Alignment
Ang lahat ng data points ay may timestamp at nakahanay sa UTC milliseconds. Ang lumang data ay hinahawakan nang transparent:
- Real-time data: sourced within last 5 seconds
- Aging data: marked with age_ms indicating staleness
- Missing exchanges: returns partial results with exchange list
- Full stale data: returns cached result with cache_age_seconds
Cross-Exchange Metadata
Ang bawat aggregated response ay may kasamang metadata tungkol sa data sources:
{
"data": [...],
"_meta": {
"exchanges": ["bybit", "binance", "hyperliquid"],
"count": 245,
"aggregated_at": 1709980800123,
"sources_healthy": true
}
}
Pangunahing Pagsasala
Salain ayon sa Exchange
Humiling ng data mula sa partikular na exchanges lamang:
// Kunin ang mga funding rates mula sa Binance lamang
GET /v1/derivatives/funding-heatmap?exchange=binance
// Maramihang exchanges
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
Salain ayon sa Asset Class
Salain ayon sa cryptocurrency o trading pair:
// Bitcoin pairs lamang
GET /v1/derivatives/funding-heatmap?asset=BTC
// Maramihang assets
GET /v1/derivatives/funding-heatmap?asset=BTC,ETH,SOL
// Specific pairs
GET /v1/derivatives/funding-heatmap?symbol=BTCUSDT,ETHUSDT
Salain ayon sa Metric Range
Magtanong batay sa mga numerical na halaga:
// Mataas na funding rates (>0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_min=0.0001
// Mababang funding rates (<-0.01%)
GET /v1/derivatives/funding-heatmap?funding_rate_max=-0.0001
// Mataas na open interest
GET /v1/derivatives/oi-rankings?oi_min=100000000
Advanced Filtering
Comparative Filters
Maghanap ng mga pairs na may partikular na katangian sa iba't ibang exchanges:
// Mga pairs na may >5% funding diff sa iba't ibang exchanges
GET /v1/derivatives/comparative?metric=funding_rate_spread&min=0.0005
// Liquidation divergence
GET /v1/derivatives/comparative?metric=liquidation_pressure_diff
// Mga pairs na may pinakamataas na Bybit/Binance open interest ratio
GET /v1/derivatives/comparative?metric=oi_ratio&base=bybit&compare=binance&min=1.5
Time-Based Filters
Magtanong ng historical aggregated data:
// Data mula sa partikular na time window
GET /v1/derivatives/funding-heatmap?start_time=1709980800&end_time=1709984400
// Huling 24 na oras
GET /v1/derivatives/funding-heatmap?lookback=24h
// Snapshots sa 1-hour intervals
GET /v1/derivatives/historical?interval=1h&limit=24
Composite Filters
Pagsamahin ang maramihang filter conditions:
// Top tier pairs: BTC, ETH, SOL
// High positive funding sa Binance
// Negative funding sa Bybit (arbitrage)
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 and Ranking
Sort Directions
Kontrolin ang pagkakasunod-sunod ng resulta:
// Pinakamataas na funding rates muna
GET /v1/derivatives/funding-heatmap?sort=funding_rate:desc
// Pinakamababang open interest
GET /v1/derivatives/oi-rankings?sort=open_interest:asc
// Pinakabagong timestamp
GET /v1/derivatives/funding-heatmap?sort=timestamp:desc
// Multi-field sort
GET /v1/derivatives?sort=exchange:asc,funding_rate:desc
Ranking Options
| Field |
Description |
Range |
| funding_rate |
Perpetual contract funding rate |
-1.0 to 1.0 |
| open_interest |
Kabuuang open positions sa USD |
0 to billions |
| mark_price |
Contract mark/settlement price |
Positive |
| liquidation_pressure |
Longs vs shorts liquidation risk |
-1.0 to 1.0 |
Data Aggregation Modes
Raw Aggregation
Ibalik ang lahat ng data points nang hiwalay kasama ang exchange source identification:
GET /v1/derivatives/funding-heatmap?aggregate_mode=raw&symbol=BTCUSDT
// Response: 3 separate entries (one per exchange)
[
{ exchange: "bybit", funding_rate: 0.00010 },
{ exchange: "binance", funding_rate: 0.00012 },
{ exchange: "hyperliquid", funding_rate: 0.00009 }
]
Merged Aggregation
Pagsamahin ang data sa iisang record kasama ang statistical fields:
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 }
}
Composite Aggregation
Statistical aggregation kasama ang confidence scores:
GET /v1/derivatives/funding-heatmap?aggregate_mode=composite&symbol=BTCUSDT
{
symbol: "BTCUSDT",
funding_rate_consensus: 0.000103,
confidence_score: 0.98, // 98% agreement
outliers: [],
weighted_avg: 0.000102, // liquidity-weighted
exchange_details: { ... }
}
Data Normalization
Price Normalization
Ang lahat ng presyo ay na-normalize sa 8 decimal places at USDT denomination:
- Bybit: USDT pairs normalized directly
- Binance: USDT-M at COIN-M parehong na-convert sa standard form
- Hyperliquid: Ang Native USDT ay palaging naiko-convert
Normalisasyon ng Volume
Lahat ng volume ay iniulat sa mga yunit ng base asset:
{
"volume_base": 1234.5,
"volume_quote": 89234500,
"num_trades": 45678
}
Normalisasyon ng Timestamp
- Lahat ng timestamp ay nasa UTC milliseconds (13 digits)
- Naka-synchronize sa oras ng API gateway
- Pag-aayos ng edad para sa data na nakolekta sa iba't ibang oras
- Walang kinikilingang timezone (laging UTC)
Mga Praktikal na Halimbawa ng Query
Halimbawa 1: Mga Opportunidad sa Arbitrage ng Funding Rate
Maghanap ng mga pares na may pinakamataas na spread sa pagitan ng long funding ng Binance at short funding ng Bybit:
GET /v1/derivatives/funding-heatmap?
exchange=bybit,binance&
asset=BTC,ETH,SOL,ARB&
sort=funding_rate_spread:desc&
limit=10&
aggregate_mode=merged
Halimbawa 2: Mga Kontrata na may Mataas na Open Interest
Kunin ang mga kontrata na may malaking open interest sa lahat ng exchange:
GET /v1/derivatives/oi-rankings?
oi_min=100000000&
sort=open_interest:desc&
limit=20&
aggregate_mode=merged
Halimbawa 3: Pag-aggregate ng Time Series
Mga historical funding rates sa 4-hour intervals:
GET /v1/historical/funding?
symbol=BTCUSDT&
interval=4h&
limit=30&
aggregate_mode=composite
Master Multi-Exchange Data
Kumuha ng pinag-isang derivatives data mula sa Bybit, Binance, at Hyperliquid na may malakas na filtering, aggregation, at normalization. Magtipid ng oras sa engineering at bawasan ang API costs.
Tingnan ang Mga Plan
Ang Free tier ay kasama ang basic aggregation. Ang Trader at Pro plans ay nag-uunlock ng advanced filtering at historical queries.