コモディティAPIリファレンス
現物商品価格、系列検索、履歴。米国の週次燃料小売価格と世界銀行の月次指標価格を含みます。
ベースURL
このページでは、パーム油の現物価格、米国の燃料価格、商品の月次指標価格を扱います。 4種類すべての金属のスポット価格については、専用のリファレンスを参照してください: 貴金属スポット価格のリファレンス。 先物リファレンスは、製品がリリースされるまで利用できません。
https://api.narwhalapi.com/v1/commodities- すべてのリクエストで同じ Narwhal Bearer キーとアカウント共通のクォータを使用します。
- REST と MCP は同じ入力および出力スキーマを使用します。
現物価格の操作
| 操作 | REST パス | MCPツール |
|---|---|---|
| パーム油 の現物価格系列を検索 | /v1/commodities/palmoil/physical | commodities_list_palmoil_physical_series |
| パーム油 の最新現物価格を取得 | /v1/commodities/palmoil/physical/{series_id} | commodities_get_palmoil_physical_price |
| パーム油 の現物価格履歴を取得 | /v1/commodities/palmoil/physical/{series_id}/observations | commodities_get_palmoil_physical_observations |
| 現物価格系列を検索 | /v1/commodities/physical/series | commodities_list_physical_series |
| 現物価格系列の詳細を取得 | /v1/commodities/physical/series/{series_id} | commodities_get_physical_series |
| 最新の現物価格を取得 | /v1/commodities/physical/series/{series_id}/latest | commodities_get_physical_latest |
| 現物価格の履歴を取得 | /v1/commodities/physical/series/{series_id}/observations | commodities_get_physical_observations |
共有動作
- 現物系列の検索では、完全で権利承認済みの系列だけを返します。
- CPOとマレーシアのFFBは1つの価格数値を返します。インドネシアのFFBは樹齢別の完全な価格表を返します。
- 価格は元の通貨と単位のまま、小数を表す文字列で返します。
- 履歴は古い順で、指定したフィルターに紐づく不透明なカーソルを使用します。
- 欠落、重複、曖昧、または権利が混在する価格表は失敗として処理されます。
- 拒否または利用不能のリクエストは月間クォータを消費しません。
カバレッジ
米国の燃料データには、レギュラーガソリンと道路用2号ディーゼル燃料の週次系列20件が含まれます。各製品は全米平均と9地域を対象とし、米ガロン当たりのUSD建てで提供します。全米平均の履歴は、ガソリンが1990年8月、ディーゼル燃料が1994年3月から始まります。地域別系列はそれ以降に始まります。履歴は月曜日の調査後に毎週追加されます。ソース:米国エネルギー情報局
日次のスポット価格系列は3つあります。クッシングのWTI原油は1986年1月2日から、ブレント原油は1987年5月20日からで、いずれも1バレル当たりの米ドル建てです。ヘンリーハブ天然ガスは1997年1月7日からで、1 MMBtu当たりの米ドル建てです。Source: U.S.Energy Information Administration
月次指標価格は、ソフトコモディティ、油脂・油糧種子、金属、穀物、エネルギー、肥料、林産物、畜産物・乳製品にわたる70系列を対象とします。履歴は1960年まで遡ります。一部の系列は開始が遅い、または終了しています。価格はUSD建てで、公表時の単位を使用します。ソース:The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
本リリースは、インドネシアのCPO政府参考価格とFFB買取価格表、マレーシアのCPO国内受渡し市場平均価格とFFB地域別参考価格を対象とします。それぞれ意味と元の単位が異なる別系列です。
履歴の開始日は系列ごとに異なり、ソースの欠落を明示しています。FCPO先物は含みません。詳しくは Commodities のカバレッジ および次のもの: 方法論 で、制限の詳細を確認してください。
Narwhal APIキーで利用できます。
ドキュメント