현물 금속 API 레퍼런스

금, 은, 백금, 팔라듐의 현물 가격과 WTI, 브렌트, 구리의 기준 가격을 단위 및 UTC 타임스탬프와 함께 제공합니다.

인증 및 요청

Authorization 헤더에 Bearer 방식으로 API 키를 보내세요. 제품 개요 →

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

작업

엔드포인트	작업
`GET /v1/commodities/spot/{commodity}/{currency}`	현물 가격 또는 선물 기반 기준 가격을 조회합니다.
`GET /v1/commodities/spot/{commodity}/{currency}/bars`	금, 은, 백금, 팔라듐, WTI 및 BRENT의 시가, 고가, 저가, 종가 바를 조회합니다. 구리 이력은 아직 제공되지 않습니다.

매개변수

필드	의미
`commodity`	경로 매개변수입니다. XAU, XAG, XPT, XPD, WTI(WTI 원유), BRENT(브렌트 원유) 또는 XCU(구리)입니다.
`currency`	경로 매개변수이며 대문자로 입력합니다. 금: USD, AUD, BGN, BRL, CAD, CHF, CNY, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KRW, MXN, MYR, NOK, NZD, PHP, PLN, RON, SEK, SGD, THB, TRY 또는 ZAR. 은, 백금, 팔라듐, WTI, BRENT 및 XCU: USD만 지원합니다.
`interval`	바 전용. 1m, 5m, 15m, 1h, 4h 또는 1d(기본값).
`start / end`	바 전용. 전체 구간 경계에 맞춘 UTC 시각입니다(4h는 00시, 04시, 08시 등, 1d는 자정). 시작은 포함하고 끝은 제외합니다.
`limit / cursor`	바 전용. 기본값은 100, 최댓값은 500입니다. 동일한 쿼리로 next_cursor를 재사용하세요.

시세 필드

필드	의미
`symbol, currency, unit`	심볼과 표시 통화입니다. unit은 귀금속의 경우 troy_ounce, WTI와 BRENT는 barrel, XCU는 pound입니다.
`price`	하나의 양수 참고 가격을 십진수 문자열로 나타냅니다.
`timestamp, stale`	시세 UTC 타임스탬프 및 명시적인 최신 상태 플래그입니다.
`bars`	바 전용. 확정된 바를 오래된 순서로 반환합니다. 각 바에는 timestamp(바의 시작 시각)와 소수점 이하 네 자리 문자열인 open, high, low, close가 있습니다. USD 이외 통화로 표시한 금은 close만 제공합니다.
`next_cursor`	바 전용. 이어서 조회할 커서이며, 남은 바가 없으면 null입니다.

응답 예시: GET /v1/commodities/spot/{commodity}/{currency}.

시세 응답

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

데이터 해석

WTI, BRENT 및 XCU는 선물 시장에서 도출한 기준 가격이며, 실물 화물의 현물 가격이 아닙니다. 가격과 함께 단위와 타임스탬프를 표시하세요. 타임스탬프는 해당 가격이 속한 분의 시작 시각입니다. 매일 21:00-22:00 UTC의 휴장 시간에는 stale: true를 반환합니다. 시장이 닫혀 있는 동안 시세가 오래된 값일 수 있으므로 최신 시장 가격으로 표시하지 마세요. 다른 원자재 또는 통화 조합은 404를 반환합니다. 금, 은, 백금, 팔라듐, WTI 및 BRENT의 가격 이력을 제공하며, XCU의 가격 이력은 제공하지 않습니다. 빈 구간을 채우지 않으며, 누락된 바는 그대로 둡니다. 분 단위 바는 30일간, 시간 및 일 단위 바는 무기한 보관하며, 이용 범위는 요금제의 과거 데이터 조회 기간으로 제한됩니다. WTI와 BRENT의 15분 및 시간 단위 이력은 2020년부터 제공됩니다.

오류 형식 및 할당량 →

MCP 도구

commodities_get_spot_pricecommodities_get_price_history

MCP를 통해 연결 →