과거 Palmoil FFB 가격 API

FFB 일정 과거 데이터 받기

엔드포인트 및 요청

REST 엔드포인트

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

계약 요청

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/oil-palm-ffb-price/observations?series_id=id-ri-oil-palm-ffb-smallholder-purchase-agreement&start=2026-08-01&end=2026-09-02&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

매개변수

이름	필수	유형	의미
`series_id`	예	쿼리 · 안정적인 Narwhal ID	실물 시계열 검색이 반환하는 시계열입니다.
`start`	아니요	쿼리 · YYYY-MM-DD	포함 하한입니다. end와 함께 제공해야 합니다.
`end`	아니요	쿼리 · YYYY-MM-DD	배타적 상한입니다. start보다 늦어야 합니다.
`limit`	아니요	쿼리 · 정수, 1~500	반환할 최대 완전 일정 수입니다. 기본값은 100입니다.
`cursor`	아니요	쿼리 · 불투명 문자열	동일한 시계열과 날짜 범위에 연결된 연속 토큰입니다.

응답

계약 예시

{
  "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",
  "observations": [
    {
      "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"
        }
      ]
    }
  ],
  "next_cursor": null
}

필드	유형	필수	의미
`series_id / commodity / country / area`	문자열	예	안정적인 식별 정보 및 실물 시장 범위입니다.
`producer_type / producer_arrangement`	문자열 또는 null	예	반환되는 모든 일정에 공통으로 적용되는 생산자 범위입니다.
`price_basis / currency / unit`	문자열	예	공유 값의 의미와 시세 표기 규칙입니다.
`observations`	배열	예	effective_from을 기준으로 가장 오래된 일정부터 정렬한 전체 일정입니다.
`next_cursor`	문자열 또는 null	예	불투명한 연속 토큰이며 마지막에는 null입니다.

오류 및 할당량

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

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

데이터 범위

과거 데이터에는 승인된 완전한 일정만 포함됩니다. 모든 지역 또는 모든 연도의 데이터가 완전하다는 의미는 아닙니다.

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