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のような地域。1つの系列を正直に選択できる場合に限り省略します。
`producer_type`	はい	クエリ · smallholder	生産者に関する共通用語。最初の契約で受け付けるのは小規模農家のみです。
`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 — 完全な公開データでインターフェースを安全に満たせません。

拒否されたリクエストとサーバーエラーは月間クォータを消費しません。

カバレッジ

リアウは最初の最新データ対応アダプターです。その他の地域は、それぞれの履歴または検証ステータスを維持します。

Narwhal APIキーで利用できます。