개발자 · API 문서

공개 데이터와 분석 결과 구조

TRACEKR이 어떤 데이터를 조회하고 어떤 기준으로 후보 경로를 만드는지 개발자 관점에서 설명합니다.마지막 업데이트 · 2026년 9월 18일
01

공개 API 제공 상태

현재 TRACEKR 자체의 외부 REST API는 제공하지 않습니다. 브라우저가 TRACEKR의 허용 목록 기반 읽기 전용 중계 경로를 호출하고, 서버가 Blockscout, TRON Grid, XRP Ledger·XRPSCAN, Blockstream과 Solana 공개 제공자에서 필요한 기록을 조회합니다. 지원되는 주소는 GoPlus Security API에서 알려진 위험 기록도 확인합니다. 존재하지 않는 API 키나 엔드포인트를 발급하지 않습니다.

02

분석 결과 핵심 필드

다운로드 보고서의 원본 JSON에는 체인, 조회 주소, 노드, 전송 경로, 거래소 후보, 추적 경계와 경고가 포함됩니다.

{
  "chain": "ethereum",
  "query": "0x…",
  "nodes": [{ "address": "0x…", "hop": 1, "stopReason": "known_service" }],
  "edges": [{ "hash": "0x…", "asset": "USDT", "amount": "100" }],
  "warnings": []
}
03

안전 제한

공개 제공자 보호와 오판 방지를 위해 사용이 많은 EVM 6개 체인을 먼저 확인하고 필요할 때 나머지 체인을 조회합니다. 네트워크 탐색 동시 3개, 상세 추적 동시 2개, 주소별 주요 분기 8개, 최대 5단계로 제한합니다.

  • 같은 조회는 짧은 시간 동안 합쳐서 외부 요청 1회로 처리
  • 429·5xx 응답은 Retry-After를 우선해 재시도
  • 중간 분기 실패는 다른 성공 경로와 분리
  • 대량 거래 허브는 다른 고객 출금을 따라가지 않도록 중단
  • 공개 라벨은 신원 확정 자료가 아님

주소를 알고 있다면 바로 확인하세요

회원가입이나 지갑 연결 없이 공개 블록체인 기록을 조회합니다.

자금 흐름 찾기