팜유 실물 가격 API

최신 승인 팜유 관측값 가져오기

엔드포인트 및 요청

REST 엔드포인트

GET /v1/commodities/palmoil/physical/{series_id}

계약 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical/id-ri-oil-palm-ffb-smallholder-purchase-agreement" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP 사용 항목 commodities_get_palmoil_physical_price. REST와 MCP는 동일한 스키마, 계정 할당량, 권한 확인 및 문제 형식을 공유합니다.

매개변수

이름	필수	유형	의미
`series_id`	예	경로 · 고정 Narwhal ID	검색 API가 반환한 ID를 사용합니다.
`price_month`	아니요	쿼리 · YYYY-MM	MPOB CPO에만 해당합니다. 가격 대상 월 하나를 선택하며, 기본값은 각 보고서 자체의 월입니다.

응답

계약 예시

{
  "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
  "currency": "IDR",
  "unit": "kilogram",
  "period_start": "2026-08-26",
  "period_end": "2026-09-01",
  "revision": 1,
  "prices": [
    {
      "tree_age_min_years": 3,
      "tree_age_max_years": 3,
      "price": "2998.31"
    },
    {
      "tree_age_min_years": 4,
      "tree_age_max_years": 4,
      "price": "3347.20"
    },
    {
      "tree_age_min_years": 5,
      "tree_age_max_years": 5,
      "price": "3595.38"
    },
    {
      "tree_age_min_years": 6,
      "tree_age_max_years": 6,
      "price": "3734.94"
    },
    {
      "tree_age_min_years": 7,
      "tree_age_max_years": 7,
      "price": "3818.86"
    },
    {
      "tree_age_min_years": 8,
      "tree_age_max_years": 8,
      "price": "3865.46"
    },
    {
      "tree_age_min_years": 9,
      "tree_age_max_years": 9,
      "price": "3878.72"
    },
    {
      "tree_age_min_years": 10,
      "tree_age_max_years": 20,
      "price": "3836.93"
    },
    {
      "tree_age_min_years": 21,
      "tree_age_max_years": 21,
      "price": "3770.94"
    },
    {
      "tree_age_min_years": 22,
      "tree_age_max_years": 22,
      "price": "3695.31"
    },
    {
      "tree_age_min_years": 23,
      "tree_age_max_years": 23,
      "price": "3609.33"
    },
    {
      "tree_age_min_years": 24,
      "tree_age_max_years": 24,
      "price": "3544.29"
    },
    {
      "tree_age_min_years": 25,
      "tree_age_max_years": 25,
      "price": "3490.84"
    },
    {
      "tree_age_min_years": 26,
      "tree_age_max_years": 26,
      "price": "3471.62"
    },
    {
      "tree_age_min_years": 27,
      "tree_age_max_years": 27,
      "price": "3441.82"
    },
    {
      "tree_age_min_years": 28,
      "tree_age_max_years": 28,
      "price": "3385.41"
    },
    {
      "tree_age_min_years": 29,
      "tree_age_max_years": 29,
      "price": "3344.02"
    },
    {
      "tree_age_min_years": 30,
      "tree_age_max_years": 30,
      "price": "3249.41"
    }
  ]
}

필드	유형	필수	의미
`series_id`	문자열	예	안정적인 실물 시계열 식별 정보입니다.
`currency / unit`	문자열	예	통화와 원래 단위: 인도네시아 FFB 가격표는 kilogram, CPO는 metric_ton, 말레이시아 FFB 기준값은 one_percent_oer입니다.
`period_start / period_end`	날짜	예	유효 기간에 따른 가격은 시작일과 종료일을 모두 포함합니다. MPOB는 보고일부터 다음 날까지의 기간을 사용하되, 종료일인 다음 날은 포함하지 않습니다.
`revision`	정수	예	가격 또는 완전한 가격표의 개정 번호입니다.
`price or prices`	십진수 문자열 또는 완전한 배열	예	양의 십진수 문자열 가격 또는 tree_age_min_years, tree_age_max_years 및 price가 포함된 완전한 prices 배열입니다. 수령의 최솟값과 최댓값은 모두 범위에 포함됩니다. 말레이시아 FFB는 one_percent_oer 단위를 유지합니다.
`price_month`	YYYY-MM	아니요	MPOB CPO 가격에 필요하며 가격 대상 월을 지정합니다. period_start와 period_end는 보고일 관측 구간을 나타냅니다.

오류 및 할당량

400 invalid_query — 코드, 지역, 날짜 범위, 제한 또는 선택기가 잘못되었습니다.
401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
403 plan_upgrade_required — 요청 기간 또는 시작이 요금제의 과거 데이터 범위(Free 12개월, Basic 5년, Pro 전체)보다 이전입니다.
404 palmoil_series_not_found — 요청과 일치하는 완전한 승인 데이터가 없습니다.
429 rate_limit_exceeded 또는 quota_exhausted — 공유 허용량이 소진되었습니다.
503 palmoil_unavailable — 완전한 발표로 인터페이스를 안전하게 충족할 수 없습니다.

거부된 요청과 서버 오류는 월간 할당량을 소비하지 않습니다.

데이터 범위

CPO와 말레이시아 FFB는 스칼라 가격을 반환합니다. 인도네시아 FFB는 수령별 가격표 전체를 보존합니다. 최신 보고서에 거래가 없다고 명시되어 있으면 과거 가격을 현재 가격처럼 제시하지 않습니다.

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