パーム油現物価格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専用です。価格対象月を1つ選択します。既定では各レポート自身の月を使用します。

レスポンス

契約例

{
  "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キーで利用できます。