모든 API

현물 금속 가격 API

금, 은, 백금, 팔라듐의 현물 가격과 선물 시장에서 도출한 WTI, 브렌트, 구리의 기준 가격을 조회하세요. 이 기준 가격은 실물 화물의 현물 가격이 아닙니다.

첫 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/spot/XAU/USD" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

응답 예시 예시 응답 · 실제 요청 아님

{
  "symbol": "XAU-USD",
  "price": "2500.00",
  "currency": "USD",
  "unit": "troy_ounce",
  "timestamp": "2026-08-21T12:00:00Z",
  "stale": true
}

GET현물 가격 또는 선물 기반 기준 가격을 조회합니다./v1/commodities/spot/{commodity}/{currency}

GET금, 은, 백금, 팔라듐, WTI 및 BRENT의 시가, 고가, 저가, 종가 바를 조회합니다. 구리 이력은 아직 제공되지 않습니다./v1/commodities/spot/{commodity}/{currency}/bars

금은 XAU, 은은 XAG, 백금은 XPT, 팔라듐은 XPD, WTI 원유는 WTI, 브렌트 원유는 BRENT, 구리는 XCU를 사용하세요.

금은 31개 통화로 표시되며, 은, 백금, 팔라듐, WTI, BRENT 및 XCU는 USD로만 표시됩니다.

애플리케이션에 호가의 타임스탬프를 표시하세요. 오래된 호가를 최신 시장 가격으로 표시해서는 안 됩니다. 시장이 닫혀 있는 동안에는 호가의 최신성이 떨어질 수 있습니다. 매일 21:00-22:00 UTC의 휴장 시간에는 stale: true를 반환합니다.

팔라듐 (영어)

가격은 어떤 단위로 표시되나요?

unit 필드는 귀금속의 경우 troy_ounce, WTI와 BRENT는 barrel, XCU는 pound입니다. 트로이온스는 일반 온스와 다릅니다.

어떤 통화를 사용할 수 있나요?

금은 31개 통화로 표시되며, 은, 백금, 팔라듐, WTI, BRENT 및 XCU는 USD로만 표시됩니다. 제공 범위 목록에 모든 원자재와 통화가 표시됩니다. 다른 조합은 404 currency_not_supported를 반환합니다.