所有 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 金鑰 →