goldprice.devPlus 또는 Pro 계정에서 금값 알림을 설정하세요. Free와 Basic에서는 API 조회를 예약하고 별도의 알림 도구를 연결하세요. 2026년 10월 28일 03:44 UTC 기준 현재 가격은 트로이온스당 US$4,044.16입니다. 무료 가격은 십오 분 지연됩니다.
- Plus와 Pro는 각각 기본 제공 가격 알림 다섯 개를 포함합니다.
- 기본 제공 알림은 실시간 가격을 확인하고 지정한 URL로 서명된 POST 요청을 보냅니다.
- Free와 Basic에서는 조회를 예약하고 마지막 상태를 저장하세요.
기본 제공 알림을 만드세요
Plus와 Pro는 각각 가격 알림 다섯 개를 포함합니다. Free와 Basic에는 포함되지 않습니다. 요금을 비교한 뒤 로그인하고 계정 알림에서 만드세요. 각 알림은 금, 은, 구리 중 한 금속을 확인합니다.
조건을 선택하세요. 기준가의 상향, 하향 또는 양방향 돌파, 한 시간 또는 스물네 시간 동안의 변동률, 일일 종가 중에서 고를 수 있습니다. 알림은 실시간 가격을 확인합니다. 기준가 또는 변동률 알림은 각각 시간당 최대 한 번, 일일 종가 알림은 UTC 기준 하루에 한 번 전송됩니다.
Free 또는 Basic에서 조회를 예약하세요
Free와 Basic에서는 아래 요청을 십오 분마다 실행하세요. /v1/spot/XAU-USD-SPOT에서 트로이온스당 금값을 읽습니다. 같은 통화와 단위로 기준가를 정하세요. 키 없는 요청은 키나 가입이 필요하지 않아 계정 없이 시작할 수 있습니다.
이 일정은 시간당 네 건, 하루 아흔여섯 건, 월 약 이천구백 건의 요청을 보냅니다. IP당 분당 열 건과 시간당 백 건인 키 없는 요청 한도, 월 오천 건인 무료 키 허용량 안에 들어갑니다.
curl "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT"전송과 서명을 확인하세요
기본 제공 알림은 지정한 URL로 JSON 본문이 담긴 서명된 POST 요청을 보냅니다. 공개 호스트 이름과 443 포트의 https를 사용하세요. 사설 주소나 로컬 주소는 허용되지 않습니다. 본문에는 event, alert_id, kind, symbol, direction, price, observed_at이 포함됩니다. 조건별 필드는 level, percent와 window 및 reference_price, 또는 date와 close입니다.
Webhook-Signature 헤더 형식은 t=<unix time>,v1=<HMAC SHA-256 of "<t>.<body>" with your signing secret>입니다. 서명 비밀키는 알림을 만들 때 한 번만 표시되므로 저장하세요. 수신한 본문으로 서명을 검증하고, 생성된 지 오 분이 지난 서명은 거부하세요.
알림 페이지에서 테스트 요청을 보내 수신 URL을 확인하세요. goldprice.dev는 이메일이나 SMS를 보내지 않습니다. POST 요청은 채팅 도구의 수신 웹훅이나 소규모 서버처럼 직접 관리하는 URL로 전송됩니다.
예약 조회의 상태를 저장하세요
예약 조회에서는 가격을 비교하기 전에 is_stale과 computed_at을 확인하세요. 무료 가격은 십오 분 지연됩니다. 첫 유효 조회값으로 가격이 기준가보다 높은지 낮은지 판단하고 그 상태를 저장하세요.
이후 유효 조회값이 기준가를 돌파하면 알림을 보내세요. 상향 돌파는 기준가 미만에서 기준가 이상으로 바뀌는 경우입니다. 하향 돌파는 반대로 비교하세요. 기준가의 같은 쪽에 머무르면 알림을 반복 전송하지 않아야 합니다. 조회 사이에 돌파했다가 되돌아오면 놓칠 수 있습니다.
설정 튜토리얼을 따라 하세요
가격 알림 튜토리얼은 가격을 확인하고 마지막 상태를 저장한 뒤 채팅 서비스의 수신 웹훅으로 전송하는 스크립트를 제공합니다. 예약 요청부터 알림 전송까지 작동하는 구성을 따라 만들 수 있습니다.
스크립트 없이 설정하려면 예약 워크플로 튜토리얼이나 을 따라 하세요. 어떤 방식을 사용해도 데이터의 최신 여부, 단위 일치, 저장된 상태를 확인하세요. 알림은 선택한 도구를 통해 전송됩니다.