現物コモディティ系列 API

地域別に Palmoil FFB 系列を検索

エンドポイントとリクエスト

REST エンドポイント

GET /v1/commodities/physical/{commodity}/{country}

契約リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/physical/OIL-PALM-FFB/IDN?area=ID-RI&currency=IDR" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCPの使用 commodities_discover_physical_series。RESTとMCPは同じスキーマ、アカウントクォータ、権限チェック、問題の形式を共有します。

パラメータ

名前	必須	種別	意味
`commodity`	はい	パス · カタログコード	安定したコモディティコード。Palmoil の範囲では OIL-PALM-FFB を使用します。
`country`	はい	パス · ISO 3166-1 alpha-3	現物市場を管轄する国。最初に調査した国はIDNです。
`area`	いいえ	クエリ · ISO 3166-2 または Narwhal 地域	ID-RI（リアウ）のような、行政上またはソースが定義する市場地域。
`currency`	いいえ	クエリ · ISO 4217	公開された通貨で系列を絞り込みます。

レスポンス

契約例

{
  "commodity": "OIL-PALM-FFB",
  "country": "IDN",
  "series": [
    {
      "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",
      "coverage_start": "2026-08-19",
      "coverage_end": "2026-09-01",
      "latest_released_on": "2026-08-26",
      "schedule_count": 2
    }
  ]
}

フィールド	種別	必須	意味
`commodity / country`	文字列	はい	指定された現物市場の範囲。
`series`	配列	はい	安定したseries_id順に並べた、承認済み系列の完全版。
`series_id`	文字列	はい	履歴操作で使用する安定した識別情報。
`area / producer_type / producer_arrangement`	文字列または null	はい	正確な市場と生産者の範囲。
`coverage_start / coverage_end`	日付	はい	承認済み系列における最初と最後の有効日。
`latest_released_on / schedule_count`	日付と整数	はい	最新の公式リリース日と承認済みスケジュール数。

エラーとクォータ

400 invalid_query — コード、地域、日付範囲、上限、セレクターが無効です。
401 invalid_api_key — Bearer キーがないか拒否されました。
404 physical_series_not_found — リクエストに一致する完全な承認済みデータがありません。
429 rate_limit_exceeded または quota_exhausted — 共有枠を使い切りました。
503 physical_price_unavailable — 完全な公開データでインターフェースを安全に満たせません。

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

カバレッジ

完全で承認済みの系列だけが表示されます。最初に選択された国はインドネシアです。

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