過去の 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キーで利用できます。