API 문서
멀티거래소 데이터 통합 및 고급 필터링
Bybit, Binance, Hyperliquid의 고급 필터링, 정렬, 표준화를 통한 마스터 데이터 통합. 3개 이상의 거래소에서 동시에 통합된 시장 인사이트를 얻으세요.
2026년 3월 21일 게시
•
17분 읽기
•
고급
데이터 통합 개요
Smart Money API는 Bybit, Binance, Hyperliquid 3대 거래소의 암호화폐 파생상품 데이터를 통합합니다. 각 거래소에 별도로 API 요청을 보내는 대신, 스마트 필터링, 거래소 간 비교, 고급 분석 기능이 포함된 통합 데이터를 제공받을 수 있습니다.
통합이 중요한 이유:
- 단일 API 호출 — 여러 연결을 관리할 필요 없이 3개 거래소 데이터 동시 획득
- 표준화된 형식 — 모든 거래소 데이터가 일관된 스키마로 표준화
- 거래소 간 인사이트 — 펀딩 비율, 포지션, 유동성 등을 거래소 간 비교
- 지능형 필터링 — 강력한 필터로 필요한 데이터 정확히 쿼리
- 성능 — CDN 캐시된 통합 응답이 직접 통합보다 50배 빠름
아키텍처: Smart Money API는 1-5초마다 거래소 데이터를 수집, 표준화, CDN 엣지에 캐시하며, 전 세계적으로 100ms 미만의 지연 시간으로 통합 응답을 제공합니다.
지원되는 거래소
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 |
무기한 |
30초 내 API 키 획득
구축 준비 완료? 무료 API 키(일일 100회 호출, 카드 불필요)로 실시간 고래, 펀딩, 온체인 데이터를 가져오세요.
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
}
}
기본 필터링
거래소별 필터링
특정 거래소의 데이터만 요청:
// Binance의 펀딩 비율만 가져오기
GET /v1/derivatives/funding-heatmap?exchange=binance
// 여러 거래소
GET /v1/derivatives/funding-heatmap?exchange=bybit,binance
자산 클래스별 필터링
암호화폐 또는 거래 페어별 필터링:
// BTC 페어만
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: 펀딩 비율 차익 거래 기회
바이낸스 롱 펀딩과 바이비트 숏 펀딩 간 스프레드가 가장 큰 페어 찾기:
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
다중 거래소 데이터 마스터하기
바이낸스, 바이비트, Hyperliquid의 통합 파생상품 데이터를 강력한 필터링, 집계 및 정규화로 얻으세요. 엔지니어링 시간을 절약하고 API 비용을 줄입니다.
플랜 보기
무료 티어에는 기본 집계가 포함됩니다. 트레이더 및 프로 플랜은 고급 필터링과 과거 쿼리를 제공합니다.