개요 캐싱 전략 커넥션 풀링 배치 작업 쿼리 최적화 압축 비동기 패턴 성능 메트릭 벤치마킹 최적화 권장 사항

API 문서

API 성능 최적화 및 레이턴시 감소

Smart Money API로 100ms 미만의 응답 시간을 달성하세요. 최대 처리량을 위해 캐싱, 커넥션 풀링, 배치 작업 및 쿼리 최적화를 마스터하세요.

2026년 3월 21일 게시됨 • 17분 읽기 • 성능

성능 개요

Smart Money API는 낮은 레이턴시와 높은 처리량을 위해 최적화되었습니다. 통합 시 권장 패턴을 구현하여 최대 성능을 달성하세요.

성능 최적화 계층:

캐싱 — 로컬 및 CDN 캐싱으로 원본 요청 감소
커넥션 풀링 — 커넥션 재사용, 오버헤드 감소
배치 작업 — 여러 요청을 하나로 결합
쿼리 최적화 — 필요한 데이터만 요청
비동기/병렬 — 여러 요청을 동시에 처리

성능 목표: P95 레이턴시 <100ms, P99 <500ms, 99.9% 가동 시간 및 <0.1% 오류율.

캐싱 전략

응답 캐싱

로컬 캐시
// Cache-Control 헤더 준수
const cache = new Map();
async function cachedFetch(url) {
  const cached = cache.get(url);
  if (cached && !cached.isExpired) {
    return cached.data;
  }
  const response = await fetch(url);
  const ttl = parseCacheControl(response.headers);
  cache.set(url, { data: response, expiry: ttl });
  return response;
}

캐시 무효화

고래 누적 데이터: 5분 TTL
펀딩 비율: 1분 TTL
OHLCV 데이터: 1시간 TTL
히스토리컬 데이터: 24시간 TTL

30초 내 API 키 획득

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

API 키 받기 →

커넥션 풀링

HTTP 커넥션 재사용

커넥션 풀
// 풀링이 적용된 Node.js HTTP Agent
const http = require('http');
const https = require('https');
const httpAgent = new http.Agent({
  keepAlive: true,
  maxSockets: 50,
  maxFreeSockets: 10
});
const httpsAgent = new https.Agent({
  keepAlive: true,
  maxSockets: 50,
  maxFreeSockets: 10
});
// 요청에 에이전트 사용
fetch(url, { agent: httpsAgent });

커넥션 설정

매개변수	권장 값	근거
maxSockets	50-100	동시성과 리소스 사용 균형
maxFreeSockets	10-20	재사용을 위한 유휴 커넥션 유지
keepAliveTimeout	60000ms	서버 타임아웃과 일치

배치 작업

요청 결합

배치 쿼리
// 여러 요청 대신
// GET /whales?asset=BTC
// GET /whales?asset=ETH
// GET /whales?asset=SOL
// 하나의 배치 요청 사용
GET /v1/whales?asset=BTC,ETH,SOL
// 3회 순차 요청 대비 ~200ms 절약

배치 제한

요청당 최대 심볼 수: 100
최대 시간 범위: 365일
최대 결과: 10,000행

쿼리 최적화

요청 최적화

필드 지정 — 필요한 필드만 요청
필터 사용 — 필터로 응답 크기 감소
페이지네이션 — offset 대신 limit 매개변수 사용
시간대 — 필요한 데이터만 요청

최적화된 쿼리
// 비효율적: 많은 데이터
GET /v1/whales?lookback=90d&limit=10000
// 효율적: 특정 데이터
GET /v1/whales?
  asset=BTC&
  metric=accumulation&
  lookback=7d&
  limit=100

응답 압축

Gzip 압축

요청 압축
// 요청에서 압축 활성화
fetch(url, {
  headers: {
    'Accept-Encoding': 'gzip, deflate'
  }
});
// API는 지원되는 경우 자동으로 압축합니다
// 일반적인 압축률: 70-80% 크기 감소

압축 절약

데이터 유형	압축되지 않음	압축됨	절약
JSON 응답	500KB	85KB	83%
대형 테이블	2MB	350KB	82%

비동기/병렬 패턴

동시 요청

병렬 요청
// 비효율적: 순차적
const btc = await fetch('/whales/BTC');
const eth = await fetch('/whales/ETH');
const sol = await fetch('/whales/SOL');
// 총 시간: ~300ms
// 효율적: 병렬
const [btc, eth, sol] = await Promise.all([
  fetch('/whales/BTC'),
  fetch('/whales/ETH'),
  fetch('/whales/SOL')
]);
// 총 시간: ~100ms (3배 빠름!)

성능 지표

핵심 지표

지표	목표	측정
P50 지연 시간	<50ms	중앙값 응답 시간
P95 지연 시간	<100ms	95번째 백분위수
P99 지연 시간	<500ms	99번째 백분위수
처리량	>1000 req/s	초당 요청 수

성능 모니터링

성능 모니터링
// 응답 시간 추적
const start = performance.now();
const response = await fetch(url);
const duration = performance.now() - start;
// 분석을 위해 기록
console.log(`요청이 ${duration}ms 걸렸습니다`);

벤치마킹

부하 테스트

통합을 벤치마킹하여 병목 현상을 식별하세요:

도구: Apache Bench, wrk 또는 Locust
현실적인 동시성 수준으로 테스트
평균뿐만 아니라 지연 시간 분포 측정
캐시가 따뜻하고 차가운 상태로 테스트

최적화 권장 사항

빠른 성과

HTTP 연결 풀링 활성화 (1-5배 개선)
로컬 캐싱 구현 (반복 요청에 대해 10-50배 개선)
일괄 작업 사용 (요청 수 2-5배 감소)
gzip 압축 활성화 (대역폭 3-5배 감소)

고급 최적화

히스토리 데이터에 CDN 캐싱 구현
로컬 캐싱을 위해 데이터베이스 연결 풀 사용
서킷 브레이커 패턴 구현
대용량 데이터셋에 스트리밍 응답 사용

최대 성능 달성

Smart Money API는 속도를 위해 구축되었습니다. 이러한 최적화 전략을 구현하여 100ms 미만의 지연 시간과 최대 처리량을 달성하세요.

성능 등급 보기

Pro 및 Enterprise 플랜에는 고급 캐싱 및 성능 기능이 포함됩니다.