금 시세 API
금, 은, 백금, 팔라듐, 구리의 실시간 가격과 환율, 일별 내역, 캔들을 API 키와 간단한 GET 요청으로 받으세요.
참조
- 기본 URL
- https://goldapi.dev/api/v1
- 인증
- X-API-Key 헤더에 키 입력
- 응답 형식
- JSON
- 무료 요금제
- 시간당 100회 요청, 카드 불필요
curl --fail-with-body --max-time 10 "https://goldapi.dev/api/v1/price/XAU/USD" \ -H "X-API-Key: $API_KEY"const res = await fetch("https://goldapi.dev/api/v1/price/XAU/USD", { headers: { "X-API-Key": process.env.API_KEY }, signal: AbortSignal.timeout(10_000),});if (!res.ok) throw new Error("HTTP " + res.status);console.log(await res.json());import os, requestsres = requests.get( "https://goldapi.dev/api/v1/price/XAU/USD", headers={"X-API-Key": os.environ["API_KEY"]}, timeout=10,)res.raise_for_status()print(res.json())package mainimport ( "fmt" "io" "net/http" "os" "time")func main() { client := http.Client{Timeout: 10 * time.Second} req, err := http.NewRequest("GET", "https://goldapi.dev/api/v1/price/XAU/USD", nil) if err != nil { panic(err) } req.Header.Set("X-API-Key", os.Getenv("API_KEY")) res, err := client.Do(req) if err != nil { panic(err) } defer res.Body.Close() body, err := io.ReadAll(res.Body) if err != nil { panic(err) } if res.StatusCode != 200 { panic(fmt.Sprintf("HTTP %d: %s", res.StatusCode, body)) } fmt.Println(string(body))}import java.io.IOException;import java.net.URI;import java.net.http.HttpClient;import java.net.http.HttpRequest;import java.net.http.HttpResponse;import java.time.Duration;public class Main { public static void main(String[] args) throws Exception { HttpRequest request = HttpRequest.newBuilder(URI.create("https://goldapi.dev/api/v1/price/XAU/USD")) .header("X-API-Key", System.getenv("API_KEY")) .timeout(Duration.ofSeconds(10)) .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); if (response.statusCode() != 200) throw new IOException("HTTP " + response.statusCode()); System.out.println(response.body()); }}import Foundationvar request = URLRequest(url: URL(string: "https://goldapi.dev/api/v1/price/XAU/USD")!)request.setValue(ProcessInfo.processInfo.environment["API_KEY"], forHTTPHeaderField: "X-API-Key")request.timeoutInterval = 10let (data, response) = try await URLSession.shared.data(for: request)guard (response as? HTTPURLResponse)?.statusCode == 200 else { throw URLError(.badServerResponse) }print(String(data: data, encoding: .utf8)!)$context = stream_context_create(["http" => [ "header" => "X-API-Key: " . getenv("API_KEY"), "timeout" => 10,]]);$body = file_get_contents("https://goldapi.dev/api/v1/price/XAU/USD", false, $context);if ($body === false) throw new RuntimeException("Request failed");echo $body;응답 200
{
"symbol": "XAU",
"name": "Gold",
"currency": "USD",
"unit": "oz",
"price": 4072.1,
"gram": 130.921,
"karat": 24,
"updatedAt": "2026-11-07T03:18:40+02:00"
}
작업별 엔드포인트
앱을 위한 금속 데이터
실용 가이드
자주 묻는 질문
금 시세 API는 무료인가요?
네. Free 플랜에는 시간당 100회 요청, 금, 은, 구리, 백금, 팔라듐의 실시간 현물 시세, 환율이 포함됩니다. 신용카드는 필요하지 않습니다. Free 플랜은 보이는 링크를 표시하면 상업적으로 사용할 수 있습니다.
원자재 시세 데이터에 적합한 API인가요?
네. 모든 플랜에 금, 은, 구리, 백금, 팔라듐의 실시간 현물 시세와 다른 통화로의 환산이 포함됩니다. 월 $8의 Basic 플랜에는 일별 과거 데이터가 추가됩니다.
API는 어떤 출처의 데이터를 사용하나요?
현물 가격은 시장 데이터 소스에서 가져옵니다. 다른 통화 가격은 USD 현물 × 실시간 환율이며, EGP 금은 이집트 현지 시장도 따릅니다. 각 응답에는 계산 시각이 포함됩니다.
상업적으로 사용할 수 있나요?
모든 플랜에서 상업적 사용이 가능합니다. Free는 시세 근처에 goldapi.dev로 연결되는 보이는 링크가 필요합니다. 데이터 자체를 재배포하거나 재판매하려면 별도 계약이 필요합니다. 문의: [email protected].