所有 API

大宗商品 API

带有原始单位和序列定义的现货金属和实物大宗商品价格。

首次请求

快速入门 →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/commodities/palmoil/physical?product=ffb&country=IDN" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
响应示例 示例响应 · 非实际请求结果
{
  "series": [
    {
      "series_id": "id-ri-oil-palm-ffb-smallholder-purchase-agreement",
      "commodity": "palmoil",
      "product": "ffb",
      "observation_type": "age_schedule",
      "period_type": "effective",
      "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"
    }
  ],
  "next_cursor": null
}

端点

现货金属价格 API

GET获取现货价格或基于期货的参考价格。/v1/commodities/spot/{commodity}/{currency}
GET获取黄金、白银、铂金、钯金、WTI 和 BRENT 的开盘价、最高价、最低价和收盘价价格柱。铜的历史数据暂不可用。/v1/commodities/spot/{commodity}/{currency}/bars

实物大宗商品价格 API

GET查找棕榈油序列/v1/commodities/palmoil/physical
GET查看棕榈油序列/v1/commodities/palmoil/physical/{series_id}
GET获取棕榈油观测值/v1/commodities/palmoil/physical/{series_id}/observations

来源与方法论

棕榈油序列

按产品、国家、地区、价格类型、货币和原始单位查找已纳入的 CPO 和 FFB 序列。

阅读方法说明 →

生效期间

每个已采纳的观测值都保留日期和修订信息,用于界定价格的适用期间。

实物价格历史数据

按来源定义的口径读取棕榈油观测值,不以合成值填补缺失或已排除的报告。

已上线的数据涵盖现货金属和实物大宗商品。每个已纳入的序列均保留其单位、价格类型、地理范围和生效期间;期货产品目前尚未公开。

探索相关页面

现货

报价货币因金属而异;请参阅覆盖范围。

探索 API →

实物

棕榈油和煤炭价格、美国燃油周度零售价格以及商品月度基准。保留发布时的单位。

探索 API →

常见问题

哪些大宗商品 API 已上线?

已上线的版本涵盖现货金属和实物大宗商品。期货不对外公开。

我可以获取历史价格吗?

可以。请求已纳入的棕榈油序列的观测值;响应会保留原始单位、生效日期、修订信息和来源数据缺口。

发起你的第一个请求

获取免费 API 密钥 →