데이터와 산출 방식
숫자는 어디서 오고, 얼마나 자주 갱신되며, AI 글은 어떻게 만들어지고, 무엇이 틀릴 수 있는지 설명합니다.
최종 수정: 2026년 8월 24일
CryptoGuide는 정보 서비스입니다. 여기 보이는 거의 모든 것은 공개된 제3자 소스에서 가져와 다시 조합한 것이며, 우리는 거래소를 운영하지도, 자금을 보관하지도, 자체 시세를 만들지도 않습니다. 이 페이지는 각 기능이 무엇을 바탕으로 하는지, 얼마나 최신인지, 자동 생성 글이 어떻게 만들어지는지, 그리고 어떤 한계가 있는지를 쉬운 말로 적어 둔 것입니다. 실제로 돌아가는 코드와 일치하도록 썼고, 소스나 주기가 바뀌면 이 페이지도 함께 고칩니다.
데이터는 어디서 오나
각 기능은 정해진 순서대로 하나 이상의 공개 소스를 읽습니다. 첫 소스가 실패하거나 호출을 제한하면 다음 소스를 시도합니다.
크립토 시세 (대시보드·티커·워치리스트·포트폴리오)
대시보드의 BTC·ETH·SOL과 8개 코인 티커(BTC, ETH, SOL, BNB, XRP, ADA, DOGE, AVAX)의 USD 시세는 CoinGecko → CoinPaprika → Binance 순으로 가져옵니다. 브라우저가 Binance에 접속할 수 있는 환경에서는 티커가 Binance 공개 WebSocket으로 실시간 갱신되고, 접속이 막힌 환경(예: 미국 네트워크)에서는 30초마다 우리 서버의 스냅샷을 받아 옵니다. 워치리스트·포트폴리오 평가액은 Binance USDT 현물 가격을 먼저 쓰고 CoinPaprika를 예비로 씁니다. 같은 심볼을 쓰는 코인이 여럿이면 순위가 가장 높은 코인으로 봅니다.
글로벌 시장
NASDAQ, S&P 500, KOSPI, 금, WTI 원유, 달러 인덱스는 Yahoo Finance 차트 엔드포인트에서 가져오며 미러 호스트를 예비로 둡니다. 일간 등락률은 현재가를 전일 종가와 비교한 값입니다.
공포·탐욕 지수
크립토 공포·탐욕 지수는 Alternative.me가 발표하는 값이며, 수치와 분류를 그대로 보여 줍니다. 제공처는 이 지수를 하루 한 번 정도 갱신합니다.
뉴스
헤드라인은 지역이 고르게 섞인 6개 RSS 피드에서 모읍니다. CoinDesk·Cointelegraph(미국), BeInCrypto·CryptoNews(유럽), AMBCrypto·TokenPost(아시아)입니다. 한 매체가 화면을 독점하지 않도록 매체당 한 번에 최대 8건만 가져오고, 링크 기준으로 중복을 제거한 뒤 제목·링크·출처·게시 시각을 저장합니다. 각 헤드라인 아래 요약은 우리가 자동으로 작성합니다(아래 ‘AI 글은 어떻게 만들어지나’ 참고). ‘시장 심리(뉴스 톤)’ 게이지는 최근 24시간 기사별 톤을 합산한 것으로, 헤드라인이 어떻게 읽히는지를 나타낼 뿐 시장이 어디로 갈지를 말하지는 않습니다.
차트 패턴
패턴과 지지·저항선 탐지는 Binance 캔들(OHLC) 데이터로 돌아가며, 심볼·주기당 200개 캔들을 씁니다. 탐지 자체는 정해진 기하학적 규칙이지 AI 모델이 아닙니다. 신뢰도 점수는 캔들이 그 형태에 얼마나 들어맞는지를 재는 값이며, 가격이 다음에 어디로 갈지는 말해 주지 않습니다.
온체인
웨일 트래커는 Blockchair에서 500만 달러 이상 비트코인 거래 최근 15건을 가져오고, Blockchair를 쓸 수 없을 때는 blockchain.info 미확인 거래 샘플에서 가장 큰 거래들로 대체합니다. 거래소 유입·유출은 추정치입니다. 그 샘플의 입력·출력을 공개된 거래소 지갑 목록과 대조하므로 전체 흐름이 아니라 샘플을 반영합니다. 네트워크 활동(활성 주소, 거래 수, 해시레이트, 채굴자 수익, 30일)은 blockchain.info 차트에서, 스테이블코인 공급량(USDT·USDC·DAI 시가총액)은 CoinGecko에서 가져옵니다.
크립토 지도
매장과 ATM은 자원봉사자들이 기여한 OpenStreetMap 데이터를 바탕으로 한 BTCMap에서 가져옵니다. 위치·이름·주소·분류·결제 태그(온체인/라이트닝)를 가져오고, 결제 태그가 없는 항목은 비트코인을 받는 것으로 간주합니다. 온라인 서비스 목록과 국가별 규제 상태는 우리가 직접 정리합니다(아래 지도 관련 안내 참고).
AI 브리핑과 리포트
데일리 브리핑과 주간·월간·분기 리포트는 위 입력값으로 작성됩니다. 현재 BTC·ETH·SOL 시세, 공포·탐욕 지수, 최근 24시간 게시된 헤드라인, 리포트의 경우 온체인 시계열까지입니다. 그 밖의 것은 들어가지 않습니다.
얼마나 자주 갱신되나
두 가지가 중요합니다. 우리가 소스에 얼마나 자주 묻는지, 그리고 화면이 우리에게 얼마나 자주 묻는지입니다. 아래 숫자는 코드에 있는 값 그대로입니다.
| 기능 | 갱신 주기 |
|---|---|
| 크립토 시세 (대시보드) | 서버는 시세를 20초 동안 유지하고, 페이지는 30초마다 다시 가져옵니다. |
| 실시간 티커 | 브라우저에서 Binance에 닿으면 WebSocket으로 실시간. 아니면 서버가 15초마다 갱신하는 스냅샷을 페이지가 30초마다 받아 옵니다. |
| 워치리스트·포트폴리오 시세 | 서버가 가격 목록을 15초 동안 유지합니다. |
| 글로벌 시장 | 60초마다. |
| 공포·탐욕 지수 | 5분마다 확인. 지수 자체는 하루 한 번 정도 바뀝니다. |
| 뉴스 | 30분마다 새 헤드라인을 수집하고, 같은 작업에서 요약까지 작성합니다(한 번에 최대 20건). 남은 것은 후속 작업이 처리합니다. |
| AI 마켓 브리핑 | 하루 한 번, 한국 시간 아침에 표준·상세 두 버전으로. |
| 리서치 리포트 | 주간·월간·분기. |
| 웨일 거래 | 서버가 목록을 60초 동안 유지합니다. |
| 네트워크 활동·스테이블코인 공급량 | 10분마다. |
| 차트 패턴 | 캔들을 5분 동안 캐시합니다. |
| 알림 | 조건을 약 1분마다 평가하므로 알림은 보통 이벤트 후 몇 분 안에 도착합니다. 초 단위는 아닙니다. |
| 크립토 지도 | 매장·ATM 데이터는 BTCMap에서 하루 한 번 정도 동기화합니다(마지막 동기화 이후 바뀐 항목만). 규제 상태는 우리가 수정할 때 바뀝니다. |
소스가 멈추면 어떻게 되나
모든 시세 호출에는 짧은 타임아웃과 한 번의 재시도가 있습니다. 소스가 호출 제한으로 응답하면 60초 동안 그 소스를 건너뛰고 다음 소스로 넘어갑니다. 모든 소스가 실패하면 마지막으로 받았던 값을 보여 주고 오래된 값(stale)으로 표시합니다(API는 stale: true를 돌려주고, 대시보드는 마지막 값을 화면에 유지합니다). 빈자리를 지어낸 숫자로 채우는 일은 없습니다. 한 번도 값을 받은 적이 없다면 그 영역은 값이 올 때까지 그냥 비어 있습니다.
AI 글은 어떻게 만들어지나
뉴스 요약, 데일리 마켓 브리핑, 리서치 리포트, 포트폴리오 해설은 대형 언어 모델(설정된 경우 Anthropic의 Claude)이 자동으로 작성합니다. 모델은 위에 적힌 입력값만 봅니다. 웹 접근도, 이용자에 대한 기억도 없습니다. 생성된 모든 글에는 어떤 모델이 썼는지 표시됩니다.
글이 지켜야 하는 규칙
- 주어진 데이터와 헤드라인에 근거해야 합니다. 지어낸 사실·숫자·사건은 안 됩니다.
- 단정적 예측 금지. ‘~할 가능성’, ‘~로 보입니다’는 되지만 가격이 어떤 수준에 도달할 것이라고 말할 수는 없습니다.
- 매수·매도·진입·청산·리밸런싱 지시 금지. 진입가·목표가·손절가도 제시하지 않습니다.
- 수익 보장이나 ‘무위험’ 표현 금지.
- 비개인화: 브리핑과 리포트는 한 번 생성되어 모두에게 동일하게 보입니다. 포트폴리오 해설은 분산 지표를 설명할 뿐이며, 모델에는 비중(%)과 지표값만 전달되고 금액·이용자와 연결된 보유 내역·식별자는 전달되지 않습니다. 해설은 보여 준 뒤 폐기됩니다.
자동 검사
게시 전에 결과물은 자동 검사를 거칩니다. 길이, 형식 오류, 그리고 한국어·영어 금지 표현 목록(단정적 예측, 매매 지시, 수익 보장)입니다. 검사에 걸리면 한 번 다시 생성하고, 그래도 걸리면 게시하지 않고 ‘보류’로 표시합니다. 모델 호출에는 하루 상한도 있어서, 상한에 닿으면 남은 항목은 다음 날로 넘어갑니다.
모델을 쓸 수 없을 때
요약과 브리핑은 자동으로 생성됩니다. 언어 모델을 쓸 수 없을 때는 규칙 기반 템플릿이 같은 숫자와 헤드라인으로 글을 대신 작성하며, 이때 AI 라벨에는 모델명 대신 ‘mock-v1’이 표시됩니다. 다른 자동 생성 글과 똑같이 대하시면 됩니다. 직접 읽어 보기 위한 출발점이지 결론이 아닙니다.
이 중 어느 것도 권유가 아닙니다. 말투는 의도적으로 서술형이며, 어떤 문장이 조언처럼 읽힌다면 그것은 버그이고 알려 주시면 고치겠습니다.
알려진 한계
지연
시세는 시장보다 최대 30초 정도, 글로벌 시장 시세는 최대 1분, 뉴스는 최대 30분, 공포·탐욕 지수는 하루까지 늦을 수 있습니다. 여기 있는 어떤 것도 매매 타이밍용으로는 적합하지 않습니다.
제3자 정확성
우리는 소스를 그대로 전달할 뿐 검증하지 않습니다. 원천의 오류(잘못 찍힌 가격, 잘못 태그된 매장, 오래된 RSS 항목)는 여기에도 그대로 나타납니다.
범위
대시보드는 3개 코인, 티커는 8개를 다룹니다. 워치리스트·포트폴리오는 Binance나 CoinPaprika에 있는 심볼이면 됩니다. 글로벌 시장은 6개 종목, 뉴스는 영어·한국어 매체 6곳입니다. 지도는 BTCMap 기여자들이 등록한 곳만 보여 주며, 많은 지역에서 이는 실제로 크립토를 받는 매장의 일부에 불과합니다.
지역 차이
일부 네트워크(예: 미국)에서는 Binance에 접속할 수 없습니다. 그런 환경에서는 티커가 스트리밍 대신 주기 조회로 동작하고, 차트 패턴은 다른 소스를 추가하기 전까지 ‘캔들 데이터를 불러올 수 없습니다’로 표시될 수 있습니다.
심볼 중복
같은 심볼을 쓰는 코인이 많습니다. 워치리스트·포트폴리오 시세에서는 그 심볼을 가진 코인 중 순위가 가장 높은 코인으로 해석하는데, 대개는 맞지만 항상 의도한 코인이라는 보장은 없습니다.
추정치
거래소 유입·유출은 미확인 거래 샘플을 공개 지갑 목록과 대조해 계산한 값이라 실제 총량과 다릅니다. 패턴 신뢰도는 형태 점수이지 확률이 아닙니다.
AI 글
근거를 주고 검사를 거쳐도 모델 출력은 헤드라인을 잘못 읽거나, 한 가지 세부 사항에 과하게 무게를 두거나, 어색하게 표현할 수 있습니다. 보류된 항목은 보이지 않지만, 게시된 항목도 틀릴 수 있습니다. 템플릿 대체본은 뉘앙스가 한 단계 더 떨어집니다.
가용성
예약 작업(뉴스, 브리핑, 지도 동기화, 알림)은 늦어질 수 있습니다. 그럴 때는 각 페이지의 시각 표시로 데이터가 얼마나 오래됐는지 확인할 수 있습니다.
크립토 지도: 추가 안내
- 매장 데이터는 커뮤니티가 관리합니다. 핀이 있다는 것은 누군가 OpenStreetMap/BTCMap에 그 장소를 등록하고 비트코인을 받는다고 적었다는 뜻이지, 우리가 확인했다는 뜻이 아닙니다. 가게는 문을 닫고, 크립토 결제를 그만두고, 이사합니다. ‘확인일’이 표시된 경우 그것은 기여자가 기록한 마지막 조사 날짜입니다.
- 지도 데이터에서는 비트코인 온체인과 라이트닝 수용 여부만 보여 줍니다. 온라인 서비스에 표시된 코인은 우리가 직접 정리한 목록에서 옵니다.
- 국가별 규제 상태는 우리가 다섯 가지 거친 단계(우호적 / 규제됨 / 제한 / 금지 / 불명확)로 요약한 것으로, 일부 국가만 다루며 손으로 수정합니다. 읽기 위한 출발점이지 법률 자문이 아닙니다. 한 나라 안에서도 규칙이 다르고 자주 바뀌며, 우리 라벨은 변화보다 몇 주 이상 늦을 수 있습니다.
- 지도는 어떤 거래도 중개·검증·보증하지 않으며, 표시된 장소에서 이용자가 하는 어떤 일에도 우리는 당사자가 아닙니다.
우리가 보관하는 이용자 정보
정식 문서는 개인정보처리방침입니다. 여기는 데이터베이스에 실제로 들어 있는 것을 기준으로 한 짧고 실용적인 목록입니다.
계정
이메일·이름·프로필 이미지(Clerk가 관리), 그리고 언어·시간대·국가 코드.
동의 기록
어떤 버전의 문서에 언제 동의했는지, 그 순간의 IP 주소와 브라우저 문자열. 동의의 증빙으로 보관합니다.
구독
Stripe 고객·구독 식별자. 카드 정보는 우리 서버를 거치지 않습니다.
이용자 콘텐츠
포트폴리오와 보유 내역, 워치리스트, 저장한 기사·리포트, 알림, 알림 규칙, 알림 채널 설정(이용자가 입력한 텔레그램 채팅 ID나 이메일 주소), 발송 이력.
리퍼럴
추천 코드, 누가 누구를 추천했는지, 가입 IP의 솔트 해시(원본 주소는 보관하지 않음).
API (Whale 플랜)
각 API 키의 해시와 짧은 접두사(전체 키는 한 번만 보여 주고 저장하지 않음), 키·엔드포인트별 일일 호출 수, 웹훅 URL과 시크릿.
이용 신호
기능별로 한 시간에 한 줄, 서비스를 사용했다는 기록. 환불 자격 판단용이며 분석용이 아닙니다.
보안 로그
계정 삭제, 데이터 내보내기, 관리자 작업, 차단된 요청을 IP·브라우저 문자열과 함께 기록합니다. 이 로그는 추가만 되며 계정을 삭제해도 남습니다. 이용자 레코드와의 연결은 끊기지만, 항목에는 작업을 한 이메일 주소가 남습니다.
양식
유료 플랜 대기자 신청(이메일·플랜·언어)과 Enterprise 문의(업무용 이메일·소속·팀 규모·활용 목적).
제품 이벤트
어떤 기능이 쓰이는지 파악하기 위한 가벼운 이벤트(이벤트명·페이지·언어).
보관하지 않는 것
- 카드 번호(Stripe가 보관).
- 가입 IP 원본 주소(솔트 해시만).
- 포트폴리오 AI 해설(요청 시 생성해 돌려주고 폐기).
- API 키 전문이나 웹훅 발송 내용.
프로필에서 계정에 저장된 모든 것을 JSON으로 내보낼 수 있고, 계정을 삭제할 수 있습니다. 삭제하면 보안 로그를 제외한 위 항목이 모두 함께 삭제됩니다.
정정 요청과 문의
숫자가 이상하거나, 매장 핀이 오래됐거나, 규제 라벨이 뒤처졌거나, AI 문장이 조언처럼 읽힌다면 알려 주세요. 어느 페이지에서 대략 언제 보았는지, 가능하면 스크린샷도 함께 보내 주시면 좋습니다. 우리 쪽 문제는 고치고, 원천의 문제는 해당 소스에 알립니다.
cryptoguidesbs@gmail.com로 메일 보내기매장 핀은 BTCMap/OpenStreetMap에서 직접 수정하는 편이 가장 빠를 때가 많습니다. 다음 동기화 때 반영됩니다.