棕榈油实物价格方法说明

棕榈油实物观测值的来源、类型和修订方式。拥有 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 岁的每个年龄。各行按顺序排列、互不重叠，价格以表示正数的十进制字符串返回。任何一行缺失或含义不明，都会导致整份价格表被拒绝，而不会返回部分结果。

修订会替换整份价格表。主管机构将所有数据行作为同一项定价决定发布，因此不能单独修订其中一行。

period_start 和 period_end 描述印度尼西亚价格的有效期，包含起止两日。马来西亚每日观测值以报告日开始，到次日结束，但不包含结束日。
revision 从 1 开始，并在价格或完整价格表变化时更新。
重新获取相同数据不会产生修订版本。

历史数据采用稳定的 series_id。可选 start 和 end 边界必须同时提供，并构成半开区间。印度尼西亚价格的生效期间只要与该区间重叠就会纳入结果；马来西亚每日价格则按报告日期筛选。结果按时间从早到晚排列，并保持价格表完整。

获取后续每一页时，保持所有请求参数不变，包括 limit 及任何 price_month。已发布数据变化时会返回 cursor_expired；请不带游标重新开始分页。

历史数据包含已接受的价格和完整价格表。印度尼西亚 CPO 包含 68 个生效期间；马来西亚 CPO 包含 1,457 份日报，马来西亚 FFB 包含 71 个月的每日数据。日期范围不保证覆盖连续完整。

无法获取的报告和相互矛盾的数值不会纳入已发布的历史数据。马来西亚 CPO 有 289 个报告缺失日期和一份数据不一致的报告。马来西亚 FFB 因来源格式中的数据不一致而排除了四个月。缺失值不会变成零，也不会被假定为节假日。不包含 FCPO 期货。