Palmoil physical series API

Find admitted Palmoil physical series by product and country

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

REST エンドポイント

GET /v1/commodities/palmoil/physical

契約リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical?product=ffb&country=IDN&area=ID-RI&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

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

パラメータ

名前	必須	種別	意味
`product`	いいえ	query · ffb or cpo	Filter by the physical product.
`country`	いいえ	クエリ · ISO 3166-1 alpha-3	Filter by country, such as IDN.
`area / grade / brand`	いいえ	query · discovery filters	Filter typed metadata without adding URL levels.
`limit / cursor`	いいえ	query · 1–500 and opaque cursor	Paginate stable discovery results.

レスポンス

契約例

{
  "series": [
    {
      "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
      "commodity": "palmoil",
      "product": "ffb",
      "country": "IDN",
      "area": "ID-RI",
      "producer_type": "smallholder",
      "producer_arrangement": "purchase_agreement",
      "price_type": "official_purchase_schedule",
      "currency": "IDR",
      "unit": "kilogram",
      "coverage_start": "2026-08-19",
      "coverage_end": "2026-09-01",
      "frequency": "weekly"
    }
  ]
}

フィールド	種別	必須	意味
`series`	配列	はい	安定したseries_id順に並べた、承認済み系列の完全版。
`series_id`	文字列	はい	履歴操作で使用する安定した識別情報。
`area / producer_type / producer_arrangement`	文字列または null	はい	正確な市場と生産者の範囲。
`product / country / area / grade / brand`	文字列または null	はい	Typed physical-market metadata.
`frequency / coverage_start / coverage_end`	string and dates	はい	Cadence and accepted history bounds.

エラーとクォータ

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

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

カバレッジ

Only admitted series appear. Malaysia is not currently admitted.

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