코인검색기 웹훅 소개
본 문서는 조건검색식 시스템에서 포착된 코인 정보를 외부 서비스로 전달하기 위한 Webhook 연동 규격입니다.
개요
사용자가 설정한 조건검색식에 코인이 포착되면, 사전에 등록된 웹훅 URL로 HTTP POST 요청이 전송됩니다. 서버에서는 전송 성공(2xx 상태코드)을 기대합니다.
복잡한 거래소 API 연동 필요 없이, 간단한 설정만으로 실시간 시세 포착 및 조건 검색 알림을 원하는 서버나 봇(Telegram, Discord 등)으로 받아보세요.
주의사항 (Best Practices)
웹훅을 수신하는 서버를 개발할 때 다음 사항들을 권장합니다.
IP 화이트리스트 (White-listing)
코인검색기 웹훅 서버는 다음 고정 IP를 통해 외부 서버로 요청을 전송합니다. 방화벽(Firewall)이나 로드밸런서에서 아래 IP의 수신(Inbound)을 허용해 주세요.
발신 IP 주소: 64.176.226.33
멱등성(Idempotency) 보장
시스템 예외 혹은 네트워크 지연 상 동일한 데이터가 재전송되는 상황을 방지하기 위해 payload의 id 값을 활용하여 중복 요청을 필터링하는 방어 로직 구현을 강력히 권장합니다.
데이터 이중 검증 (자동매매 활용 시)
수신된 웹훅 데이터만 믿고 즉각적으로 거래소 매수/매도 주문을 넣는 것은 몹시 위험합니다. 네트워크 전송 딜레이나 일시적 호가 급변으로 인해 신호가 발생했던 가격과 봇의 체결 가격이 크게 다를 수 있습니다.
자동매매 봇을 구축하실 때는 반드시 거래소 API를 통해 최신 캔들(Candle) 차트 데이터와 현재 시장가 호가를 봇에서 한 번 더 불러와 교차 검증(Validation)한 뒤, 안전하게 주문 로직을 실행하실 것을 강력히 권장합니다.
보안 지침
웹훅 엔드포인트 URL에 고유한 비밀 값(Secret Token)을 쿼리스트링으로 포함하거나, 추후 서명(Signature) 검증 기능이 지원될 경우 이를 활용하여 신뢰할 수 있는 요청인지 확인하시길 바랍니다.
(예: https://your-domain.com/webhook?token=YOUR_SECRET_TOKEN)