메인 콘텐츠로 건너뛰기

KYA란

**KYA(Know Your Address)**는 암호화폐 주소에 대한 종합적인 프로파일링 및 리스크 평가 메커니즘입니다. 주소의 과거 행동, 연관 네트워크, 라벨 정보를 분석하여 완전한 리스크 프로파일을 구축합니다.
핵심 질문: 이 주소는 신뢰할 수 있는가?KYA는 주소와 상호작용하기 전에 해당 주소의 과거 행동과 리스크 상태를 완전히 이해할 수 있도록 도와줍니다.

KYA vs KYT

KYA와 KYT는 서로 다른 차원에서 리스크를 평가하는 상호 보완적인 리스크 관리 도구입니다:
차원KYTKYA
분석 대상개별 거래전체 주소
시간 차원실시간 스냅샷과거 누적
핵심 질문이 거래는 안전한가?이 주소는 신뢰할 수 있는가?
업데이트 빈도거래별 트리거주기적/온디맨드
데이터 깊이거래 수준프로파일 수준

프로파일링 차원

KYA는 세 가지 핵심 차원으로 주소 프로파일을 구축합니다:

엔티티 식별

주소 뒤에 있는 엔티티 유형을 식별하여 그 성격과 신뢰성을 파악합니다.

엔티티 분류

카테고리설명리스크 가중치식별 방법
CEX중앙화 거래소낮음알려진 핫월렛 주소, 입금 주소 패턴
DEX탈중앙화 거래소낮음-중간스마트 컨트랙트 식별, 라우터 주소
개인일반 사용자 주소중간행동 패턴 분석, 잔액 특성
컨트랙트스마트 컨트랙트가변온체인 코드 검증
알려진 범죄자확인된 범죄 주소매우 높음법 집행 보고서, 제재 목록

엔티티 식별 흐름

신뢰도 수준

엔티티 식별 결과에는 신뢰도 점수가 포함되어 신뢰성을 평가하는 데 도움을 줍니다:
수준신뢰도설명권장 활용
확인됨>95%공식 확인 또는 법 집행 보고직접 사용
높은 신뢰도80-95%강한 특성 매칭사용 권장
중간 신뢰도50-80%부분 특성 매칭참고용
낮은 신뢰도<50%추정참고만

행동 라벨

온체인 행동 특성에 기반하여 시스템이 자동으로 해당 라벨을 부여합니다.
온체인 생태계에서 주소의 역할을 반영합니다:
라벨정의리스크 함의
whale대규모 보유 주소 (>$1M)높은 시장 영향력
trader고빈도 거래 행동정상 활동
holder장기 보유, 이동 없음낮은 리스크
bot프로그래밍 거래 특성주의 필요
smart_money스마트 머니전문 트레이더

라벨 조합 리스크

특정 라벨 조합은 리스크 신호를 증폭시킵니다:
고위험 조합 예시mixer_user + high_value + new_address리스크 수준: HIGH사유: 새 주소가 믹서로부터 대규모 자금을 수신하는 것은 자금세탁 패턴과 일치
저위험 조합 예시whale + holder + exchange:binance리스크 수준: LOW사유: 거래소 연관 장기 대규모 보유자, 정상적인 행동

리스크 요인

리스크 평가를 정량화하기 위한 핵심 메트릭으로, 종합 리스크 점수 계산에 사용됩니다.

핵심 리스크 요인

요인설명계산 방법
블랙리스트 노출블랙리스트 주소와의 연관 정도직접/간접 노출 비율
이상 지수정상 행동에서의 이탈 정도통계적 이상 탐지
프라이버시 서비스 사용믹서/프라이버시 프로토콜 사용상호작용 이력 분석
지리적 리스크고위험 관할권 연관IP/거래소 상관관계
시간적 이상비정상 시간 패턴거래 시간 분석

사용 사례

1. 거래 상대방 실사

1

거래 상대방 주소 수집

OTC 거래 상대방의 지갑 주소 수집
2

주소 등록

POST https://api.chainstream.io/v1/kyt/address
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "address": "0x1234567890abcdef1234567890abcdef12345678"
}
3

리스크 평가 조회

GET https://api.chainstream.io/v1/kyt/addresses/{address}/risk
Authorization: Bearer <access_token>
4

결정

  • Severe/High → 거래 거절
  • Medium → 추가 KYC 요청
  • Low → 정상 진행

2. 일괄 주소 스크리닝

기존 사용자 주소 정기 스크리닝:
async function batchScreenAddresses(addresses) {
  const results = [];
  
  for (const address of addresses) {
    // 1. 주소 등록
    await fetch('https://api.chainstream.io/v1/kyt/address', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${accessToken}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ address })
    });
    
    // 2. 리스크 평가 조회
    const riskResponse = await fetch(
      `https://api.chainstream.io/v1/kyt/addresses/${address}/risk`,
      { headers: { 'Authorization': `Bearer ${accessToken}` } }
    );
    const risk = await riskResponse.json();
    
    results.push({
      address,
      risk: risk.risk,
      addressType: risk.addressType
    });
  }
  
  return results;
}
비즈니스 흐름:
  1. 사용자 주소 목록 내보내기
  2. 일괄 등록 및 리스크 조회
  3. 고위험 주소 필터링
  4. 후속 처리 트리거

3. 실시간 리스크 알림

지갑 사용자가 전송하기 전에 리스크 알림 제공:

데이터 요소

입력 데이터

필드필수설명
address조회할 주소

출력 데이터

{
  "address": "0x0038AC785dfB6C82b2c9A7B3B6854e08a10cb9f1",
  "risk": "Low",
  "riskReason": null,
  "addressType": "PRIVATE_WALLET",
  "cluster": null,
  "addressIdentifications": [],
  "exposures": [
    {
      "category": "sanctions",
      "value": 0.0
    }
  ],
  "triggers": [],
  "status": "COMPLETE"
}

응답 필드 설명

필드타입설명
addressstring조회된 주소
riskstring리스크 수준: Severe, High, Medium, Low
riskReasonstring리스크 사유 (null일 수 있음)
addressTypestring주소 유형: PRIVATE_WALLET, EXCHANGE, CONTRACT
clusterstring연관 클러스터 이름 (null일 수 있음)
addressIdentificationsarray주소 식별 라벨
exposuresarray리스크 노출 목록
triggersarray트리거된 리스크 규칙
statusstring분석 상태: COMPLETE, PENDING

KYT와의 시너지

실제로 KYA와 KYT를 함께 사용하여 종합적인 리스크 관리를 달성해야 합니다.

시너지 패턴

결정 매트릭스

KYT 결과KYA 결과종합 결정
SEVERE모두즉시 동결
HIGHHIGH/SEVERE검토 대기 동결
HIGHLOW/MEDIUM수동 검토
MEDIUMHIGH/SEVERE수동 검토
MEDIUMMEDIUM강화 모니터링
LOWLOW자동 승인
LOWHIGH모니터링 플래그

모범 사례

1. 캐싱 전략

KYA 결과를 적절히 캐싱할 수 있습니다:
리스크 수준권장 캐시 기간사유
SEVERE캐싱 불가업데이트가 있을 수 있음
HIGH1시간최신 데이터 필요
MEDIUM6시간성능 균형
LOW24시간저위험은 안정적

2. 점진적 업데이트

기존 주소 모니터링:
권장 접근 방식
  1. 초기 전체 조회로 기준선 설정
  2. HIGH 이상 주소에 대해 일일 점진적 업데이트
  3. MEDIUM 주소에 대해 주간 점진적 업데이트
  4. 월간 전체 새로고침

3. 임계값 조정

비즈니스 시나리오에 따라 임계값을 조정하세요:
시나리오권장 조정
고가치 고객MEDIUM 임계값 상향
신규 사용자기본 임계값 엄격 적용
일괄 스크리닝과도한 오탐 방지를 위해 약간 완화

다음 단계

컴플라이언스 통합 가이드

KYA 통합 시작하기

KYT 핵심 개념

거래 수준 리스크 관리 알아보기

API 인증

인증 방법 이해하기

KYA API 레퍼런스

API 문서 보기