棕櫚油實體價格方法說明

棕櫚油實體商品觀測值的來源、類型分類與修訂方式。使用 Narwhal API 金鑰即可存取

價格是什麼意思

每筆實體商品觀測值都保留產品、來源定義的價格類型、期間類型、原始貨幣與單位。印尼 FFB 收購價目表會將所有一同發布的樹齡資料列保留在同一份價目表中。CPO 價格與馬來西亞 FFB 參考價仍為單一數值的觀測值。

馬來西亞 CPO 採用本地交貨的市場平均價，以每公噸 MYR 計價。馬來西亞 FFB 採用已發布的油廠交貨參考價，以每 1% 出油率（OER）的 MYR 計價。Narwhal 不會假設出油率，也不會將該參考價換算為每公噸收購價。

這些觀測值並非期貨結算價或交易訊號。探索介面會定義每個已納入序列的確切價格含義與地理範圍。

印尼 FFB 價目表來自省級主管機構。印尼 CPO 參考價來自 Ministry of Trade 的決定。馬來西亞 CPO 市場平均價與 FFB 地區參考價來自 Malaysian Palm Oil Board (MPOB)。

Narwhal 僅提供具有有效授權紀錄且最新發布版本完整的來源。授權一旦撤回，探索結果、最新資料與歷史資料會立即隱藏。

series_id 是一個實體市場序列的穩定路由識別碼。
commodity 是 palmoil 和 product 用於區分 ffb 和 cpo。
country 是 ISO 3166-1 alpha-3； area 在適用時使用 ISO 3166-2，或使用 Narwhal 定義的 nwl-* 識別碼，例如 nwl-mys-north。全國序列的 area=null。
producer_type 在適用時標示生產者範圍。印尼 FFB 價目表可能指定小農；這並非適用於所有 CPO 或馬來西亞參考價的標籤。
producer_arrangement 是 purchase_agreement, supported_scheme，或 null。

來源術語，例如 mitra swadaya, 等離子，以及 pekebun 仍保留為證據中繼資料，不會成為整個 API 通用的列舉值。

所有一同發布的樹齡資料列都保留在同一份價目表中。樹齡範圍包含上下限：10–20 歲區間涵蓋 10 至 20 歲的每個年齡。各列依序排列，樹齡範圍互不重疊，價格為正值的十進位數值字串。任何一列缺漏或含義不明，都會使整份價目表被拒絕，而非回傳部分結果。

修訂會替換整份價目表。由於主管機構將這些資料列作為同一項定價決定發布，因此無法單獨修訂其中一列。

歷史資料採用穩定的 series_id。可選 start 和 end 這兩個界限必須同時提供，並構成半開區間。印尼的生效期間只要與該區間重疊，就會納入結果；馬來西亞每日價格則按報告日期篩選。結果由舊到新排列，並保留完整價目表。

取得後續每一頁時，請保持所有請求參數不變，包括 limit 及任何 price_month。發布版本變更時會回傳 cursor_expired；請移除游標後重新開始。

歷史資料包含已接受的價格與完整價目表。印尼 CPO 包含 68 個生效期間；馬來西亞 CPO 包含 1,457 份每日報告，馬來西亞 FFB 包含 71 個月的每日資料列。日期界限不代表保證期間內的資料連續完整。

無法取得的報告與相互矛盾的數值不會納入已發布的歷史資料。馬來西亞 CPO 有 289 個報告無法取得的日期，以及一份資料不一致的報告。馬來西亞 FFB 因不同來源格式的內容不一致，排除了四個月。缺失值不會被改為零，也不會被視為假日。不包含 FCPO 期貨。