개요 OHLCV 캔들 시간대 옵션 역사적 쿼리 집계 간격 고래 이동 기록 펀딩 비율 기록 백테스팅 데이터 사용 예시 모범 사례

API 문서

시계열 데이터 및 역사적 분석 쿼리

백테스팅, 연구 및 역사적 분석을 위한 포괄적인 시계열 데이터에 액세스하세요. OHLCV 캔들, 역사적 펀딩 비율, 고래 이동 타임라인 및 여러 시간대에 걸친 집계된 시장 스냅샷을 쿼리할 수 있습니다.

2026년 3월 21일 게시됨 • 15분 읽기 • 연구

역사적 데이터 개요

Smart Money API는 24개월의 역사적 데이터를 제공하여 포괄적인 연구, 백테스팅 및 시간 기반 분석이 가능합니다. 모든 역사적 데이터는 정규화되고 중복 제거되며 여러 집계 수준에서 사용할 수 있습니다.

사용 가능한 역사적 데이터에는 다음이 포함됩니다:

OHLCV 캔들 — 모든 거래 쌍에 대한 시가, 고가, 저가, 종가, 거래량
고래 이동 — 일일 및 시간별 해상도의 역사적 축적/분배
펀딩 비율 — 모든 영구 쌍에 대한 역사적 펀딩 비율 스냅샷
미결제약정 — 모든 거래소 및 시간대에 걸친 역사적 OI 데이터
청산 — 역사적 청산 연쇄 및 압력 포인트

데이터 보존: 전체 틱 데이터는 90일 동안 보관됩니다. 집계된 시간별/일일 데이터는 24개월 동안 보관됩니다. 원시 아카이브는 다운로드할 수 있습니다.

OHLCV 캔들스틱 데이터

기술적 분석 및 차트 작성을 위한 시가-고가-저가-종가-거래량 데이터. 1분부터 1개월까지의 모든 시간대에 대해 모든 암호화폐 쌍에 사용할 수 있습니다.

OHLCV 데이터 구조

OHLCV 캔들스틱
{
 "timestamp": 1709980800000,
 "symbol": "BTCUSDT",
 "timeframe": "1h",
 "open": 71250.50,
 "high": 72500.00,
 "low": 71000.25,
 "close": 72250.75,
 "volume_base": 1234.5,
 "volume_quote": 89234500,
 "trades": 45678
}

OHLCV 데이터 쿼리

역사적 OHLCV 쿼리
// 지난 30일 동안의 1시간 캔들 가져오기
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  lookback=30d&
  limit=720

30초 안에 API 키 받기

빌드할 준비가 되셨나요? 무료 API 키(하루 100회 호출, 카드 불필요)를 받아 라이브 고래, 펀딩 및 온체인 데이터를 가져오기 시작하세요.

API 키 받기 →

사용 가능한 시간대

시간대 옵션

시간대	기간	사용 사례	최대 조회 기간
1m	1분	고빈도 트레이딩, 스캘핑	30일
5m	5분	당일 트레이딩, 스윙 트레이딩	90일
15m	15분	데이 트레이딩, 신호 감지	180일
1h	1시간	중기 트레이딩, 분석	365일
4h	4시간	스윙 트레이딩, 추세 분석	24개월
1d	1일	장기 포지셔닝, 연구	24개월
1w	1주	거시적 분석, 다년간 추세	24개월
1M	1개월	전략적 포지셔닝	24개월

시간대 조합

여러 시간대를 동시에 쿼리:

다중 시간대 쿼리
GET /v1/historical/ohlcv/multi?
  symbol=BTCUSDT&
  timeframes=1h,4h,1d&
  timestamp=1709980800000
// 각 시간대에 대한 최신 캔들 반환

역사적 쿼리 패턴

시간 기반 쿼리

시간 범위 쿼리
// 특정 시간 범위 쿼리
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1h&
  start_time=1709894400000&
  end_time=1709980800000
// 또는 상대적 조회 기간 사용
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1d&
  lookback=90d

대용량 데이터셋을 위한 페이징

페이징 패턴
// 첫 페이지: 1000개 캔들
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  limit=1000&
  start_time=1709980800000
// 커서를 사용한 다음 페이지
GET /v1/historical/ohlcv?
  symbol=BTCUSDT&
  timeframe=1m&
  cursor=1709981000000&
  limit=1000

집계 간격

고정 시간 집계

고정 간격(시간별, 일별, 주별)으로 데이터 집계:

고정 집계
// 1개월 일별 스냅샷
GET /v1/historical/snapshots?
  metrics=whale_net_flow,funding_rate,oi&
  interval=1d&
  lookback=30d

사용자 정의 집계

사용자 정의 시간 창에서 집계:

사용자 정의 창
// 1분 캔들을 15분으로 재집계
GET /v1/historical/ohlcv/resample?
  symbol=BTCUSDT&
  source_timeframe=1m&
  target_timeframe=15m&
  lookback=7d

고래 움직임 기록

역사적 고래 추적

고래 기록
// 역사적 고래 축적 패턴
GET /v1/historical/whales?
  asset=BTC&
  metric=net_accumulation&
  interval=1d&
  lookback=365d
// 가격 수준 주변의 역사적 움직임
GET /v1/historical/whales/price-correlation?
  asset=ETH&
  lookback=90d

고래 데이터 구조

고래 데이터 포인트
{
 "timestamp": 1709980800000,
 "asset": "BTC",
 "metric": "net_accumulation",
 "value": 50000,  // BTC
 "whale_count": 847,
 "exchange_inflow": -12000,
 "exchange_outflow": 62000
}

펀딩 비율 기록

역사적 펀딩 비율 스냅샷

펀딩 비율 기록
// 시간별 펀딩 비율 스냅샷 가져오기
GET /v1/historical/derivatives/funding-heatmap?
  symbol=BTCUSDT&
  exchange=binance&
  interval=1h&
  lookback=30d
// 거래소 간 역사적 비율 비교
GET /v1/historical/derivatives/funding-heatmap/comparative?
  symbol=ETHUSDT&
  exchanges=bybit,binance,hyperliquid&
  interval=4h&
  lookback=90d

펀딩 비율 통계

집계된 펀딩 비율 통계 조회:

통계 조회
GET /v1/historical/derivatives/funding-stats?
  symbol=BTCUSDT&
  lookback=365d&
  metrics=mean,median,std_dev,min,max
// 응답 포함 사항:
// - 연간 평균 펀딩 비율
// - 분포(표준 편차)
// - 역사적 극값
// - 백분위 순위

백테스팅 데이터 접근

백테스팅 쿼리 형식

Backtrader, VectorBT 및 사용자 정의 엔진과 같은 백테스팅 프레임워크에 최적화:

백테스트 데이터
// 1년 백테스트를 위한 모든 데이터 가져오기
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT&
  timeframe=1h&
  start=2024-01-01&
  end=2025-01-01&
  fields=ohlcv,funding_rate,oi,whale_flow

내보내기 형식

오프라인 분석을 위한 역사적 데이터 다운로드:

CSV — 스프레드시트용 표준 열 형식
JSON — 모든 메타데이터가 포함된 구조화된 형식
Parquet — 데이터 과학용 압축된 열 형식
HDF5 — 시계열 최적화 형식

내보내기 쿼리
// CSV로 내보내기
GET /v1/backtest/export?
  symbols=BTCUSDT&
  timeframe=1d&
  lookback=365d&
  format=csv

실용적인 예시

예시 1: 2024년 강세장 연구

강세장 분석
// 고래 움직임과 가격 행동 상관 관계
GET /v1/historical/correlated-data?
  asset=BTC&
  start_time=2024-01-01&
  end_time=2024-12-31&
  include=ohlcv,whale_accumulation,funding_rates&
  interval=1d

예시 2: 펀딩 비율 전략 백테스팅

전략 백테스트
// 펀딩 비율 평균 회귀 전략을 위한 데이터 가져오기
GET /v1/backtest/data?
  symbols=BTCUSDT,ETHUSDT,BNBUSDT&
  timeframe=4h&
  start=2023-01-01&
  end=2025-01-01&
  exchange=binance&
  fields=funding_rate,open_interest,liquidations

역사적 데이터 모범 사례

1. 적절한 시간 프레임 선택

분석에 필요한 가장 작은 시간 프레임을 사용하세요. 1분 데이터는 시간당 데이터보다 비용이 더 듭니다.

2. 시간 범위 지정

항상 start_time/end_time 또는 lookback 매개변수를 사용하세요. 개방형 쿼리는 비효율적입니다.

3. 역사적 쿼리 캐싱

역사적 데이터는 변경되지 않습니다. 적극적으로 캐싱하세요(월간 데이터의 경우 30일 TTL).

4. 대량 결과에 페이지네이션 사용

1년간의 1분 데이터 = 525,600개의 캔들. 대용량 데이터셋에는 페이지네이션과 스트리밍을 사용하세요.

5. 데이터 완성도 검증

분석에 데이터를 사용하기 전에 응답 메타데이터에서 공백이나 누락된 거래소를 확인하세요.

연구를 위한 역사적 데이터 접근

24개월간의 OHLCV, 고래 움직임, 펀딩 비율 데이터. 백테스팅, 연구, 전략 개발에 완벽합니다.

플랜 보기

무료 티어: 30일 기록. 프로: 24개월. 엔터프라이즈: 전체 아카이브 접근.