Palmoil FFB 가격 API

최신 FFB 일정 받기

엔드포인트 및 요청

REST 엔드포인트

GET /v1/commodities/oil-palm-ffb-price

계약 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price?country=IDN&area=ID-RI&producer_type=smallholder&producer_arrangement=purchase_agreement" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

매개변수

이름	필수	유형	의미
`country`	예	쿼리 · ISO 3166-1 alpha-3	공식 일정을 관할하는 국가입니다. 처음 조사한 국가는 IDN입니다.
`area`	아니요	쿼리 · ISO 3166-2 또는 Narwhal 지역	ID-RI(리아우)와 같은 영역입니다. 하나의 시계열을 정직하게 선택할 수 있을 때만 생략하십시오.
`producer_type`	예	쿼리 · 소규모 생산자	전 세계 생산자 용어입니다. 첫 번째 계약은 소규모 생산자만 허용합니다.
`producer_arrangement`	아니요	쿼리 · purchase_agreement 또는 supported_scheme	기관이 구분하는 경우 생산자 형태입니다.

응답

계약 예시

{
  "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
  "commodity": "OIL-PALM-FFB",
  "country": "IDN",
  "area": "ID-RI",
  "producer_type": "smallholder",
  "producer_arrangement": "purchase_agreement",
  "price_basis": "official_purchase_schedule",
  "currency": "IDR",
  "unit": "kilogram",
  "effective_from": "2026-08-26",
  "effective_to": "2026-09-01",
  "released_on": "2026-08-26",
  "revision": 1,
  "prices": [
    {
      "tree_age_min_years": 9,
      "tree_age_max_years": 9,
      "price": "3878.72"
    }
  ]
}

필드	유형	필수	의미
`series_id`	문자열	예	안정적인 실물 시계열 식별 정보입니다.
`commodity / country / area`	문자열	예	OIL-PALM-FFB와 정확한 지리적 범위입니다.
`producer_type / producer_arrangement`	문자열 또는 null	예	공식 일정이 사용하는 생산자 범위입니다.
`price_basis / currency / unit`	문자열	예	처음 조사한 범위의 공식 구매 일정, IDR 및 킬로그램입니다.
`effective_from / effective_to / released_on`	날짜	예	일정 날짜와 공식 발표일을 포함합니다.
`revision`	정수	예	전체 일정 수정 번호입니다.
`prices`	배열	예	십진 문자열 가격이 포함된 겹치지 않는 전체 수령 연령 구간입니다.

오류 및 할당량

400 invalid_query — 코드, 지역, 날짜 범위, 제한 또는 선택기가 잘못되었습니다.
401 invalid_api_key — Bearer 키가 누락되었거나 거부되었습니다.
404 physical_price_not_found — 요청과 일치하는 완전한 승인 데이터가 없습니다.
409 physical_series_ambiguous — 선택기가 둘 이상의 시계열과 일치합니다.
429 rate_limit_exceeded 또는 quota_exhausted — 공유 허용량이 소진되었습니다.
503 physical_price_unavailable — 완전한 발표로 인터페이스를 안전하게 충족할 수 없습니다.

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

데이터 범위

리아우는 첫 번째 최신 Adapter입니다. 다른 지역은 각자의 과거 데이터 또는 검증 상태를 유지합니다.

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