goldprice.devgoldprice.dev는 금·은·구리 시세를 제공하는 REST API입니다. /v1/carat으로 KRW 기준 순도별 금 그램 가격을, /v1/prices로 현물 시세를 조회하세요. Free 플랜에는 월 5,000회 요청이 포함되며, 아래 요청은 모두 키 없이 실행할 수 있습니다.
API가 제공하는 데이터
모든 엔드포인트는 HTTPS를 통해 JSON을 반환합니다. 아래 표에서 각 엔드포인트의 응답 내용과 이용 가능한 최소 플랜을 확인하세요.
| 엔드포인트 | 응답 데이터 | 최소 플랜 |
|---|---|---|
/v1/prices | 금·은·구리 현물 시세 | Free |
/v1/carat | KRW 기준 순도별 금 그램 가격 | Free |
/v1/convert | 금속·통화·단위 간 환산 | Free |
/v1/bars | 일별 OHLC 과거 데이터 (Free: 최근 30일) | Free |
/v1/physical | 국가별 금·은 판매점 가격 | Basic |
첫 요청 보내기
이 요청은 KRW 기준 순도별 금 가격을 조회합니다. 키는 Authorization: Bearer 헤더에 넣어 보내세요. 키 없이도 비인증 요청 한도 안에서 같은 요청을 보낼 수 있습니다.
curl "https://api.goldprice.dev/v1/carat?currency=KRW" \ -H "Authorization: Bearer $GOLDPRICE_API_KEY"const res = await fetch("https://api.goldprice.dev/v1/carat?currency=KRW", { headers: { Authorization: `Bearer ${process.env.GOLDPRICE_API_KEY}` },})const data = await res.json()if (!res.ok) throw new Error(data.error)import os, requestsres = requests.get( "https://api.goldprice.dev/v1/carat?currency=KRW", headers={"Authorization": f"Bearer {os.environ['GOLDPRICE_API_KEY']}"}, timeout=10,)res.raise_for_status()data = res.json()응답 읽기
price_gram_24k부터 price_gram_10k까지 각 필드는 해당 순도의 금 그램 가격을 KRW 기준으로 나타냅니다. 정밀도를 유지하기 위해 문자열로 반환합니다. timestamp는 현물 시세의 UTC 시각입니다. 아래 예시는 2026년 10월 19일에 수집했으며 현재 시세가 아닙니다.
{ "currency": "KRW", "timestamp": "2026-10-19T13:50:02.288992Z", "price_gram_24k": "177484", "price_gram_22k": "162694", "price_gram_21k": "155299", "price_gram_20k": "147904", "price_gram_18k": "133113", "price_gram_16k": "118323", "price_gram_14k": "103533", "price_gram_10k": "73952"}플랜 비교
모든 플랜에서 현물 시세, 순도별 가격, 환산을 이용할 수 있습니다. 유료 플랜은 실시간 시세를 제공하며 플랜에 따라 더 긴 과거 데이터, 판매점 가격, 스트리밍을 지원합니다. 자세한 내용은 요금 페이지를 확인하세요.
| 플랜 | Free | Basic | Plus | Pro |
|---|---|---|---|---|
| 월 요금 (미국 달러) | $0 | $19 | $39 | $89 |
| 월 요청 수 | 5,000 | 100,000 | 300,000 | 1,000,000 |
| 분당 요청 수 | 10 | 60 | 120 | 300 |
| 현물 시세 | 15분 지연 | 실시간 | 실시간 | 실시간 |
| 일별 과거 데이터 | 30일 | 1년 | 전체, 금은 1996년부터 | 전체, 금은 1996년부터 |
| 국가별 판매점 가격 | 미제공 | 제공 | 제공 | 제공 |
| 스트리밍 | 미제공 | 미제공 | 제공 | 제공 |
| MCP 서버 | 제공 | 제공 | 제공 | 제공 |
| 상업적 이용 | 가능, goldprice.dev 링크 필요 | 제공 | 제공 | 제공 |
키 없이 체험하기
/v1/prices, /v1/spot/{symbol}, /v1/carat, /v1/convert는 키 없이 IP 주소당 분당 10회, 시간당 100회 요청할 수 있으며 Free 플랜 데이터를 제공합니다. 한도를 초과하면 API는 429를 반환하고 JSON 응답 본문에 어떤 한도를 초과했는지 표시합니다.
다음 단계
문서에서 각 엔드포인트와 매개변수를 확인한 다음, 무료 키를 받아 본인에게 할당된 요청 한도로 이용하세요.