전체 REST API 레퍼런스

포괄적인 REST 레퍼런스로 Smart Money API를 마스터하세요. 암호화폐 파생상품 인텔리전스와 고래 추적 데이터를 위한 모든 엔드포인트, 매개변수, 인증 방법 및 실제 통합 패턴을 학습하세요.

개요

Smart Money API는 Bybit, Binance, Hyperliquid 3대 거래소의 실시간 암호화폐 파생상품 데이터에 RESTful 액세스를 제공합니다. 본 API는 고래 지갑 포지션, 펀딩 비율, 미결제약정 메트릭, 청산 데이터 및 온체인 신호를 단일 통합 인터페이스로 집계합니다. 거래 알고리즘, 위험 관리 시스템 또는 시장 분석 도구를 구축 중이든, REST API는 모든 Smart Money 인텔리전스에 직접 프로그래밍 방식으로 액세스할 수 있게 합니다.

229개 이상의 자동 탐지된 거래 심볼과 600개 이상의 모니터링된 고래 지갑을 통해 API는 포괄적인 시장 인텔리전스를 제공합니다. 실시간 WebSocket 연결은 초 단위 업데이트를 전달하며, REST 엔드포인트는 대량 쿼리, 과거 데이터 검색 및 포트폴리오 분석을 처리합니다.

모든 요청에는 유효한 인증 자격 증명이 포함되어야 합니다. 무료 등급 사용자는 BTC에 한해 하루 100회 요청이 제한됩니다. 트레이더 등급(1,000회/일)과 프로 등급(5,000회/일)은 모든 심볼과 고급 기능을 잠금 해제합니다.

인증

Smart Money API는 API 키 인증을 사용합니다. 주요 방법은 X-API-Key 요청 헤더입니다. 대시보드에서 API 키를 생성할 수 있습니다. 브라우저/대시보드 세션을 위한 대체 수단으로 Authorization: Bearer 을 통한 세션 JWT가 허용되지만, API 클라이언트는 X-API-Key.

API 키 인증 (기본)

모든 요청에 API 키를 X-API-Key 헤더로 전송하세요. URL에 키를 넣지 마세요.

HTTP

GET /v1/whales/events HTTP/1.1
Host: api.smartmoneyapi.com
X-API-Key: sm_your_key
Content-Type: application/json

세션 JWT (대체)

브라우저/대시보드 세션은 세션 JWT를 Authorization: Bearer (24시간 유효)로 전달할 수 있습니다. 프로그래밍 방식 클라이언트는 X-API-Key.

Python

import requests
import json

# JWT 토큰 가져오기
response = requests.post(
  "https://api.smartmoneyapi.com/auth/jwt",
  json={"api_key": "sk_live_abc123xyz789"}
)
token = response.json()["token"]

# 이후 요청에 JWT 사용
headers = {"Authorization": f"Bearer {token}"}
whales = requests.get(
  "https://api.smartmoneyapi.com/v1/whales/events",
  headers=headers
)
print(whales.json())

기본 URL & 엔드포인트

모든 API 요청은 https://api.smartmoneyapi.com으로 전송됩니다. API는 버전 접두사가 있는 논리적 리소스 카테고리로 구성됩니다. 현재 안정 버전은 v1.

기본 URL: https://api.smartmoneyapi.com/api/v1

WebSocket URL: wss://ws.smartmoneyapi.com/stream

응답 형식

모든 API 응답은 표준 봉투 형식의 JSON 객체로 반환됩니다. 성공적인 응답은 HTTP 200-299 상태 코드와 응답 본문에 데이터를 반환합니다. 오류 응답에는 상세한 오류 메시지와 해결 제안이 포함됩니다.

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [
      {
        "wallet_address": "0x1234...",
        "symbol": "BTCUSDT",
        "position_size": 15.5,
        "entry_price": 42150.0,
        "current_price": 43200.5,
        "pnl": 16577.75,
        "pnl_percent": 3.91,
        "leverage": 5,
        "funding_rate": 0.00012,
        "last_updated": "2026-03-21T14:30:45Z"
      }
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 50,
    "total_pages": 1
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

고래 포지션 엔드포인트

모든 거래소에서 모니터링된 고래 지갑의 상세 포지션을 검색합니다. 이 엔드포인트는 고가치 포지션에 대한 실시간 레버리지, 진입 가격, 청산 가격 및 미실현 손익을 보여줍니다.

GET /v1/whales/events PRO

매개변수	유형	설명
symbol	string	거래 쌍 (예: BTCUSDT, ETHUSDT) 선택 사항
exchange	string	거래소별 필터: bybit, binance, hyperliquid 선택 사항
min_position_size	number	기초 자산 기준 최소 포지션 크기 선택 사항
direction	string	롱 또는 숏 포지션만 선택 사항
page	integer	페이지네이션 페이지 번호, 기본값 1 선택 사항
limit	integer	페이지당 결과 수, 최대 100, 기본값 50 선택 사항

예제 요청:

cURL

curl -X GET "https://api.smartmoneyapi.com/v1/whales/events?symbol=BTCUSDT&min_position_size=10&limit=25" \
  -H "X-API-Key: sm_your_key" \
  -H "Content-Type: application/json"

펀딩 비율 엔드포인트

Bybit, Binance, Hyperliquid의 실시간 및 과거 펀딩 비율에 액세스합니다. 펀딩 비율은 차익 거래, 스윙 전략 및 파생상품 헤징에 중요합니다. 본 API는 15분 단위의 펀딩 비율을 집계하고 과거 비율 분석을 제공합니다.

GET /v1/funding-rates FREE

매개변수	유형	설명
symbol	string	거래 쌍 (예: BTCUSDT) 필수
exchange	string	거래소: bybit, binance, hyperliquid 선택 사항
interval	string	1h, 4h, 1d, 기본값 1h 선택 사항
limit	integer	반환할 과거 기간 수, 최대 500 선택 사항

예제 요청:

JavaScript

const fetchFundingRates = async () => {
  const response = await fetch(
    "https://api.smartmoneyapi.com/v1/funding-rates?symbol=BTCUSDT&interval=4h&limit=100",
    {
      headers: {
        "X-API-Key": "sm_your_key",
        "Content-Type": "application/json"
      }
    }
  );
  const data = await response.json();
  console.log(data);
};
fetchFundingRates();

오픈 이익 엔드포인트

모든 레버리지 트레이더의 총 오픈 이익을 모니터링하세요. 가격 변동과 오픈 이익의 차이는 잠재적인 반전 및 추세 지속 기회를 신호합니다. 절대적 오픈 이익과 오픈 이익 변화율을 모두 추적하세요.

GET /v1/open-interest TRADER

매개변수	유형	설명
symbol	string	거래 쌍 필수
exchange	string	bybit, binance 또는 hyperliquid 선택
granularity	string	1m, 5m, 15m, 1h, 4h, 1d, 기본값 15m 선택

청산 엔드포인트

심볼에 대한 두 가지 보완적인 뷰를 반환합니다: 레버리지 예상 레벨 (청산 클러스터가 위치한 곳의 추정치)와 realized_heatmap — 공개 거래소 WebSocket 피드(Binance, OKX, Bybit, Bitget, BitMEX)에서 실시간으로 집계된 실제 실행된 강제 청산 강도(가격 × 시간)입니다. 스트림에 해당 심볼에 대한 데이터가 있을 때 히트맵이 표시됩니다.

GET /v1/liquidations TRADER

매개변수	유형	설명
symbol	string	자산 심볼, 기본값 BTC 선택

Trader 캐스케이드 리스크, 가장 가까운 거리 및 실현된 총액/측면을 반환합니다. Pro 전체 예상 레벨 과 전체 realized_heatmap (행렬, 가격별 클러스터, 거래소별 카운트)을 반환합니다.

온체인 DeFi 청산

우리 자체의 BSC 및 Avalanche 풀 노드에서 직접 캡처한 실행된 DeFi 대출 프로토콜 청산 — 어떤 트레이딩 봇과도 독립적입니다. BSC의 Venus/Cream 및 Moolah, Avalanche의 AAVE V3/V2, Benqi, BankerJoe, Granary 및 Vinium을 포함합니다. 인증된 키(Trader+)가 필요합니다; Pro는 추가로 봇에 의존하는 위험 포지션을 반환합니다.

GET /v1/liquidations/onchain TRADER

매개변수	유형	설명
chain	string	bsc 또는 avax; 생략 시 모두 선택
limit	integer	최대 행 수, 기본값 100, 최대 500 (최신순) 선택

확인 엔드포인트

The /v1/confirm 엔드포인트는 파생상품, 온체인(무료 Coin Metrics: MVRV / exchange-flow / active-address), 및 고래 포지셔닝을 결합한 규칙 기반의 다중 요소 confluence 점수를 반환합니다. The composite 는 -1.0에서 +1.0(0–100 아님)까지이며 모든 응답에는 투명한 factors 분해(각 항목 점수 × 가중치), adjustments, 가중치, 및 coverage가 포함됩니다. 이는 보장된 승률이 아닌 의사 결정 지원입니다. 추적되지 않은 심볼은 조작된 LOW 대신 명시적인 NO_DATA / 지원되지 않음 결과를 반환합니다.

GET /v1/confirm TRADER

매개변수: symbol (BTC/ETH/SOL) 및 direction (long/short). confidence 는 HIGH / MEDIUM / LOW / VETO / NO_DATA 중 하나; action 는 CONFIRM_FULL / CONFIRM_REDUCED / CONFIRM_MINIMAL / VETO_SKIP / NO_DATA_SKIP 중 하나; size_mult 는 제안된 포지션 크기 승수입니다.

온체인 데이터 엔드포인트

Bitcoin 및 Ethereum 온체인 메트릭(거래소 유입/유출, 고래 지갑 이동, MVRV 비율, NUPL, 지출 조건, 실현 변동성)에 액세스하세요. 이러한 메트릭은 축적/분배 주기를 식별하고 주요 반전에 대한 초기 신호를 제공합니다.

GET /v1/on-chain/metrics PRO

매개변수	유형	설명
asset	string	bitcoin 또는 ethereum 필수
metrics	array	특정 메트릭: exchange_flows, mvrv, nupl, whale_moves 선택
interval	string	1d (일간), 1w (주간), 기본값 1d 선택

데이터 모델 참조

API 응답의 구조를 이해하는 것은 통합에 필수적입니다. 아래는 모든 엔드포인트에서 사용되는 완전한 데이터 모델 정의입니다.

WhalePosition 객체

JSON

{
  "id": "pos_1a2b3c4d5e6f7g8h",
  "wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
  "exchange": "bybit",
  "symbol": "BTCUSDT",
  "position_type": "long",
  "position_size": 15.5,
  "entry_price": 42150.0,
  "current_price": 43200.5,
  "pnl": 16577.75,
  "pnl_percent": 3.91,
  "leverage": 5,
  "margin_balance": 129000.0,
  "used_margin": 126225.0,
  "available_margin": 2775.0,
  "liquidation_price": 34560.0,
  "funding_rate": 0.00012,
  "time_opened": "2026-03-15T08:30:00Z",
  "last_updated": "2026-03-21T14:30:45Z"
}

FundingRateRecord 객체

JSON

{
  "timestamp": "2026-03-21T14:00:00Z",
  "symbol": "BTCUSDT",
  "bybit": {
    "funding_rate": 0.00012,
    "next_rate": 0.00015
  },
  "binance": {
    "funding_rate": 0.00010,
    "next_rate": 0.00013
  },
  "hyperliquid": {
    "funding_rate": 0.00014,
    "next_rate": 0.00016
  },
  "aggregated": {
    "mean": 0.000120,
    "median": 0.000120,
    "spread": 0.000060
  }
}

코드 예제

일반적인 통합 패턴을 위한 프로덕션 준비 완료된 코드 예제입니다.

Python으로 고래 포지션 모니터링

Python

import requests
import time
from typing import List, Dict

class SmartMoneyClient:
    def __init__(self, api_key: str):
        self.api_key = api_key
        self.base_url = "https://api.smartmoneyapi.com/api/v1"
        self.headers = {
            "Authorization": f"Bearer {api_key}",
            "Content-Type": "application/json"
        }

    def get_whale_positions(self, symbol: str = None) -> Dict:
        """심볼 필터 옵션과 함께 고래 포지션 조회"""
        params = {}
        if symbol:
            params["symbol"] = symbol

        response = requests.get(
            f"{self.base_url}/whales/events",
            headers=self.headers,
            params=params
        )
        return response.json()

    def get_funding_rates(self, symbol: str) -> Dict:
        """현재 및 과거 펀딩 레이트 조회"""
        response = requests.get(
            f"{self.base_url}/funding-rates",
            headers=self.headers,
            params={"symbol": symbol, "limit": 100}
        )
        return response.json()

    def monitor_whale_activity(self, symbol: str, interval_seconds: int = 60):
        """고래 포지션 지속 모니터링"""
        while True:
            positions = self.get_whale_positions(symbol)
            if positions["success"]:
                for pos in positions["data"]["positions"]:
                    print(f"고래 {pos['wallet_address'][:10]}: "
                          f"{pos['position_type']} "
                          f"{pos['position_size']} {symbol} "
                          f"PnL: {pos['pnl_percent']}%")
            time.sleep(interval_seconds)

# 사용 예시
client = SmartMoneyClient("sk_live_abc123xyz789")
whales = client.get_whale_positions("BTCUSDT")
print(f"총 고래 포지션 수: {whales['data']['total']}")

모범 사례 및 성능 팁

페이징 사용: 대량 결과 집합은 항상 페이징 처리하세요. limit 및 page 매개변수를 사용하여 한 번에 50-100개 레코드 단위로 데이터를 가져오고, 모든 데이터를 한 번에 가져오지 마세요.

응답 캐싱: 고래 포지션은 매초 변경되지 않습니다. 결과를 30-60초 동안 캐시하여 API 호출을 줄이고 성능을 향상시키세요.

조기 필터링: 애플리케이션 코드에서 필터링하지 말고 쿼리 매개변수(심볼, 거래소, 방향)를 사용하여 서버 측에서 데이터를 필터링하세요.

속도 제한 처리: 지수 백오프 재시도 로직을 구현하세요. 속도 제한(429 상태)에 도달하면 대기 후 재시도하세요.

실시간을 위해 WebSocket 사용: 스트리밍 데이터의 경우 폴링 REST 엔드포인트보다 WebSocket 연결을 선호하세요. 대역폭을 절약하고 서브초 지연 시간을 얻을 수 있습니다.

타임스탬프 검증: 모든 타임스탬프는 ISO 8601 UTC 형식입니다. 표시를 위해 항상 현지 시간대로 변환하고 저장할 때는 UTC로 저장하세요.

연결 끊김 처리: WebSocket 연결에 대해 지수 백오프를 사용한 자동 재연결 로직을 구현하세요.

할당량 모니터링: 응답의 X-Requests-Remaining 헤더를 확인하세요. API 사용을 계획하여 티어 제한 내에서 유지하세요.

일반적인 통합 패턴

패턴 1: 고래 축적 시 알림

고래 포지션이 임계값을 초과하여 증가할 때 알림을 설정하세요. 이는 잠재적인 강세장 또는 축적 단계를 신호할 수 있습니다.

패턴 2: 펀딩 레이트 차익 거래 감지

거래소 간 펀딩 레이트 스프레드가 수익성 있는 임계값을 초과할 때 자동으로 감지하여 교차 거래소 차익 거래 알고리즘을 활성화하세요.

패턴 3: 청산 연쇄 모니터링

대규모 청산을 추적하고 알고리즘을 배치하여 연쇄 청산 및 고충격 가격 변동을 활용하세요.

패턴 4: 다중 신호 확인

고래 포지션, 펀딩 레이트, 온체인 메트릭 및 AI 확인 점수를 결합하여 높은 확신의 진입 신호를 생성하세요.

시작할 준비가 되셨나요?

콘솔에서 API 키를 받아 오늘부터 구축을 시작하세요. 모든 신규 계정은 무료 티어 액세스(일일 100회 요청, BTC, ETH, SOL)를 제공합니다. 모든 심볼과 고급 기능에 대한 무제한 액세스를 위해 Trader 또는 Pro로 업그레이드하세요.

API 키 받기

프로 기능 잠금 해제

고래 포지션, 확인 점수, 온체인 데이터 및 일일 2000+ API 요청에 대한 전체 액세스를 얻으세요.

가격 보기