시세는 얼마나 자주 갱신되나요?

현물 시세 엔드포인트는 60초마다 갱신될 수 있습니다. 다운로드한 워크플로는 시간마다 실행되며, 실행할 때마다 API를 한 번 호출합니다. 실행 간격을 바꾸기 전에 월 호출 한도에 미치는 영향을 확인하세요.

자동 갱신도 무료 플랜 한도 안에서 가능한가요?

시간마다 실행하면 가능합니다. 24 × 30으로 월 약 720회이며 무료 플랜의 5,000회 한도 안에 들어갑니다. 15분마다 실행하면 월 약 2,880회, 5분마다 실행하면 월 약 8,640회입니다. 여러 워크플로의 호출은 합산됩니다.

상업적으로 사용할 수 있나요?

모든 플랜에서 상업적 이용이 가능합니다. 유료 플랜은 표시 의무가 없으며, 무료 플랜은 가격 근처에 goldprice.dev 링크를 눈에 보이게 표시해야 합니다.

HTTP Request v4로 버전을 고정하는 이유는 무엇인가요?

다운로드 파일에는 HTTP Request typeVersion: 4.2 와 Schedule Trigger typeVersion: 1.2 가 지정되어 있습니다. 여기서 사용한 n8n 2.x 워크플로 내보내기 형식에 맞춘 설정입니다. 가져온 후 n8n이 마이그레이션 안내를 표시하면 게시 전에 확인하세요.

어떤 금속을 지원하나요?

금(XAU), 은(XAG), 구리(HG)를 지원합니다. 백금과 팔라듐은 어떤 플랜에서도 제공하지 않습니다. XAG-USD-SPOT 처럼 심볼의 금속 코드를 바꾸세요.

무료 플랜은 정말 무료인가요?

네. 월 5,000회 호출을 제공하며 카드나 만료 기한이 없습니다. /onboarding 에서 키를 발급받으세요.

Claude에게 워크플로 작성을 맡길 수 있나요?

네. Claude에 goldprice.dev MCP 서버를 연결하고 다음과 같이 요청하세요: HTTP Request v4.2로 /v1/spot/XAU-USD-SPOT을 시간마다 호출하는 n8n 2.x 워크플로를 만들어 주세요. X-API-Key에 Header Auth를 사용하고 내보내기 파일에는 인증 정보를 포함하지 마세요. 가져온 노드를 확인하고 수동 테스트를 마친 뒤 게시하세요.

실시간 금 시세 조회: n8n

n8n에서 실시간 금 시세 조회를 자동화하려면 인증 정보가 없는 goldprice.dev 워크플로 JSON을 가져오세요. X-API-Key라는 이름의 Header Auth 인증 정보를 만들어 HTTP Request v4.2 노드에 연결합니다. 비활성 상태인 워크플로는 Schedule Trigger v1.2로 api.goldprice.dev/v1/spot/XAU-USD-SPOT을 시간마다 호출합니다. 30일 기준 약 720회로 무료 플랜의 월 5,000회 한도 안에 들어갑니다. 수동 실행에 성공한 뒤에만 게시하세요.

goldprice.dev API 키 발급

goldprice.dev/onboarding에서 무료 계정을 만드세요. 대시보드에 ga_live_로 시작하는 키가 표시됩니다. 다음 단계에서 n8n 인증 정보에 저장하세요. 노드에 직접 붙여 넣지 마세요.

무료 플랜은 월 5,000회 호출과 31개 통화의 금 현물 시세를 제공합니다. 카드는 필요하지 않습니다.

인증 정보가 없는 워크플로 가져오기

**시간별 n8n 워크플로 JSON 다운로드** 후 n8n에서 파일에서 가져오기를 선택하세요. Schedule Trigger v1.2와 HTTP Request v4.2 노드가 포함되어 있습니다. 기본 상태는 비활성이며 API 키나 인증 정보 연결은 없습니다.

Header Auth 생성 및 연결

n8n에서 헤더 인증 정보를 만드세요. 이름은 X-API-Key로, 값은 goldprice.dev 키로 설정합니다. 금 시세 조회 노드를 열어 일반 인증 정보 유형 → 헤더 인증을 선택하고 만든 인증 정보를 연결하세요. 키를 n8n 인증 정보에 저장하면 내보낸 워크플로 JSON에 노출되지 않습니다.

n8n · HTTP 요청 노드 발췌

{  "parameters": {    "url": "https://api.goldprice.dev/v1/spot/XAU-USD-SPOT",    "authentication": "genericCredentialType",    "genericAuthType": "httpHeaderAuth",    "options": {      "response": {        "response": {          "neverError": false,          "responseFormat": "autodetect"        }      },      "timeout": 5000    }  },  "type": "n8n-nodes-base.httpRequest",  "typeVersion": 4.2,  "retryOnFail": true,  "maxTries": 3,  "waitBetweenTries": 2000,  "onError": "continueErrorOutput"}

수동 실행 후 결과 확인

워크플로 실행을 클릭하세요. 금 시세 조회에서 가격, computed_at, is_stale이 반환되는지 확인합니다. 매수호가와 매도호가는 유료 플랜 전용이며 없을 수 있습니다. 게시 전에 인증 오류를 해결하세요. 수동 실행에 성공하면 워크플로를 게시해 시간별 실행을 활성화하세요.

통화 또는 금속 변경

금 시세 조회에서 URL의 마지막 부분을 수정하세요. 심볼 형식은 METAL-CURRENCY-SPOT입니다. 여러 심볼을 조회하려면 입력 항목을 만들고 HTTP Request 노드에 https://api.goldprice.dev/v1/spot/{{ $json.symbol }}을 사용하세요.

n8n · 여러 통화의 입력 항목

[  { "symbol": "XAU-USD-SPOT" },  { "symbol": "XAU-INR-SPOT" },  { "symbol": "XAU-EUR-SPOT" },  { "symbol": "XAG-USD-SPOT" }]

예상 결과

JSON

{  "symbol": "XAU",  "quote_currency": "USD",  "unit": "troy_ounce",  "contract_type": "spot",  "price": "4012.75",  "is_stale": false,  "computed_at": "2026-08-18T08:00:00Z"}

HTTP Request 노드의 출력 패널에 전체 JSON이 표시됩니다. 이후 노드는 {{ $json.price }} 또는 {{ $json.computed_at }} 같은 표현식으로 각 필드를 참조합니다.

자주 발생하는 오류

코드	증상	해결 방법
401	HTTP Request 노드에서 `401 Unauthorized` 발생	API 키가 없거나 유효하지 않습니다. 인증 정보 → X-API-Key를 열고 대시보드의 새 키를 붙여 넣으세요. HTTP Request 노드의 인증 드롭다운에서 일반 인증 정보 유형 → 헤더 인증을 선택하고 해당 인증 정보가 연결되어 있는지 확인하세요.
429	오류 출력 분기에 간헐적으로 `429 Too Many Requests` 발생	실행 간격이 너무 짧거나 여러 워크플로가 같은 플랜을 사용하고 있습니다. 시간마다 실행하면 30일에 약 720회, 15분마다 실행하면 2,880회입니다. 실행 간격을 늘리고 API의 한도 초기화 안내에 따라 재시도하세요. 반복되는 실행 실패는 노드의 오류 출력에서 확인할 수 있습니다.
N/A	내보낸 워크플로 JSON에 API 키가 평문으로 포함됨	인증 정보를 사용하지 않고 URL이나 헤더 필드에 키를 붙여 넣은 상태입니다. 키를 삭제하고 3단계에 따라 Header Auth 인증 정보를 만든 뒤 인증 드롭다운에서 선택하세요. n8n은 인증 정보의 값을 내보내지 않지만, 직접 입력한 값은 그대로 내보냅니다.
N/A	수동 실행은 되지만 시간별 워크플로가 실행되지 않음	가져온 워크플로는 기본적으로 비활성 상태입니다. 수동 인증 테스트에 성공하면 게시하세요. Schedule Trigger는 게시된 워크플로에서만 실행됩니다.

더 활용하기

HTTP Request 뒤에 Postgres 노드를 추가해 {symbol, price, computed_at} 행을 저장하고 시계열 분석에 사용하세요
IF 노드에서 price > threshold 조건으로 분기하고 조건을 충족하면 Slack/Discord 알림을 보내세요
여러 입력 항목을 반복 처리해 워크플로 하나에서 금, 은, 구리를 추적하세요
오류 출력을 Slack 채널에 연결해 429 오류가 발생하면 알림을 받으세요

n8n에서 실시간 금 시세 조회하기