원자재 API 레퍼런스

실물 원자재 가격, 시계열 검색 및 이력을 제공합니다. 미국 주간 연료 소매 가격과 세계은행 월간 기준 가격을 포함합니다.

기본 URL

이 페이지는 실물 팜유, 미국 연료 가격, 월간 원자재 기준 가격을 다룹니다. 네 가지 금속 모두의 현물 가격은 별도의 레퍼런스를 참고하세요: 현물 금속 레퍼런스. 선물 레퍼런스는 해당 제품이 출시될 때까지 제공되지 않습니다.

REST 기본 경로

https://api.narwhalapi.com/v1/commodities

모든 요청은 같은 Narwhal Bearer 키와 공유 계정 할당량을 사용합니다.
REST와 MCP는 동일한 입력 및 출력 스키마를 사용합니다.

실물 가격 작업

실물 가격 작업
작업	REST 경로	MCP 도구
팜유 실물 가격 시계열 찾기	`/v1/commodities/palmoil/physical`	`commodities_list_palmoil_physical_series`
최신 팜유 실물 가격 가져오기	`/v1/commodities/palmoil/physical/{series_id}`	`commodities_get_palmoil_physical_price`
팜유 실물 가격 과거 자료 가져오기	`/v1/commodities/palmoil/physical/{series_id}/observations`	`commodities_get_palmoil_physical_observations`
실물 가격 시계열 검색	`/v1/commodities/physical/series`	`commodities_list_physical_series`
실물 가격 시계열 상세 정보 조회	`/v1/commodities/physical/series/{series_id}`	`commodities_get_physical_series`
최신 실물 가격 조회	`/v1/commodities/physical/series/{series_id}/latest`	`commodities_get_physical_latest`
실물 가격 이력 조회	`/v1/commodities/physical/series/{series_id}/observations`	`commodities_get_physical_observations`

공유 동작

실물 시계열 검색은 완전하고 권리가 승인된 시계열만 반환합니다.
CPO와 말레이시아 FFB는 스칼라 가격 하나를 반환합니다. 인도네시아 FFB는 수령별 가격표 전체를 반환합니다.
가격은 원래 통화와 단위의 십진수 문자열로 유지됩니다.
과거 데이터는 오래된 항목부터 정렬되며 필터에 연결된 불투명 커서를 사용합니다.
가격표가 누락되거나 서로 겹치거나 모호하거나 이용 권한이 혼재하면 제공을 차단하고 오류를 반환합니다.
거부되었거나 이용할 수 없는 요청은 월간 할당량을 소비하지 않습니다.

데이터 범위

미국 연료 데이터는 일반 휘발유와 도로용 2호 경유의 주간 시계열 20개를 포함합니다. 각 제품은 미국 평균과 9개 지역을 다루며 가격은 미국 갤런당 USD입니다. 미국 평균 이력은 휘발유가 1990년 8월, 경유가 1994년 3월부터 시작합니다. 지역별 시계열은 더 늦게 시작합니다. 이력은 매주 월요일 조사 후 추가됩니다. 출처: 미국 에너지정보청

일별 현물 가격 시계열 3개가 제공됩니다. 쿠싱의 WTI 원유는 1986년 1월 2일부터, 브렌트 원유는 1987년 5월 20일부터이며 둘 다 배럴당 미국 달러로 표시됩니다. 헨리 허브 천연가스는 1997년 1월 7일부터이며 MMBtu당 미국 달러로 표시됩니다. 출처: U.S. Energy Information Administration

미국 연료 가격 API 살펴보기 (영어)

월간 기준 가격은 소프트 원자재, 유지 및 유지종자, 금속, 곡물, 에너지, 비료, 임산물, 축산물 및 유제품에 걸친 시계열 70개를 다룹니다. 이력은 1960년까지 거슬러 올라갑니다. 일부 시계열은 늦게 시작하거나 종료되었습니다. 가격은 USD이며 발표된 단위를 사용합니다. 출처: The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0

원자재 가격 이력 API 살펴보기 (영어)

이 릴리스는 인도네시아 CPO 정부 기준 가격, 인도네시아 FFB 구매 가격표, 말레이시아 CPO 현지 인도 기준 시장 평균 가격 및 말레이시아 FFB 지역 기준 가격을 다룹니다. 이들은 의미와 원래 단위가 서로 다른 별도의 시계열입니다.

과거 데이터는 시작일이 서로 다르며, 출처 데이터의 누락 구간은 문서에 명시되어 있습니다. FCPO 선물은 포함되지 않습니다. 참고 문서: Commodities 데이터 범위 및 다음 방법론 —정확한 제한은 이 문서들을 확인하세요.

Narwhal API 키로 사용할 수 있습니다.