自国通貨での価格
為替レートを使って、商品価格を自分の通貨に換算します。
ガイドを読む →すべてのAPI
過去の商品価格 API
A commodity prices API for 70 monthly series from the World Bank Pink Sheet. Read copper price history, fertilizer prices and agricultural benchmarks in USD, with units as published. ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
最初のリクエスト
金属の系列を探す
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/physical/series?category=metals" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例
{
"series": [
{
"series_id": "worldbank-cmo-copper",
"commodity": "copper",
"commodity_key": "copper",
"category": "metals",
"product": "copper",
"country": "WLD",
"price_type": "international_benchmark",
"basis": "settlement price",
"currency": "USD",
"unit": "metric_ton",
"unit_key": "tonne",
"unit_quantity": "1",
"frequency": "monthly",
"description": "Grade A copper, minimum 99.9935% purity, cathodes and wire bar shapes, exchange settlement price.",
"attribution": "The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0",
"coverage_start": "1960-01-01",
"coverage_end": "2026-09-30"
}
]
}エンドポイント
GET現物価格系列を検索/v1/commodities/physical/series
米国の週次小売燃料価格、日次の石油・ガススポット価格、月次の商品ベンチマークを調べられます。
パラメータ
commodity任意gasoline、diesel、copper、urea、rice、crude-oil、coffeeなどの商品で絞り込みます。系列検索で返されたcommodityの値を使用してください。
category任意対象カテゴリーはsofts、oils-oilseeds、metals、grains、energy、fertilizers、forestry、livestock-dairyです。燃料系列にはenergyを使用します。
country任意世界の指標価格にはWLD、欧州連合にはEUUを使用します。対象国コードはUSA、THA、JPN、AUS、ZAF、MYS、CMR、VNM、MEX、LKA、IND、KENです。米国の燃料にはUSAを使用します。
price_type任意燃料はretail_averageを使用します。EIAの日次スポット系列とWorld Bankの系列はinternational_benchmarkを使用します。ただし、たばこはimport_unit_valueを使用します。
currency任意建値通貨で絞り込みます。現在、両方のソースでUSDを使用しています。
limit任意1ページ当たりの最大件数。デフォルトは100です。
cursor任意前のページのnext_cursorを、同じフィルターとlimitで使用してください。nullは次のページがないことを示します。
レスポンスフィールド
series配列commodity、product、country、area、価格基準basis、currency、unit、frequency、attribution、対象期間を含む系列。空の配列は、一致する系列がないことを示します。
series[].series_id文字列系列検索で返される固定ID。
series[].currency文字列建値通貨。米国の燃料系列と月次指標価格系列は、どちらもUSDを使用します。
series[].unit / series[].unit_quantity文字列公表時の単位と価格の対象数量。燃料にはus_gallonを使用します。月次指標価格にはmetric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit、sheetのいずれかを使用します。数量は1ですが、合板のみ100枚当たりのUSD建てです。値の換算は行いません。
series[].unit_key文字列unit_keyは単位を標準的な表記に統一した値で、たとえばtroy_ounce、barrel、tonneです。unitは出典の表記をそのまま保持します。価格がセント建ての場合、price_scaleは0.01です。価格にこの値を掛けると、通貨単位の金額になります。
series[].attribution文字列データとともにレスポンスの出典情報を保持してください。ソース：米国エネルギー情報局。ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
series[].commodity / series[].category / series[].product文字列商品、カテゴリー、製品の定義。例：gasoline / energy / regular-gasoline、copper / metals / copper。系列検索で各系列の値を取得できます。
series[].commodity_key文字列commodity_key は、スポット、先物、予測、現物の各価格で商品を同じ名前で表します(gold、crude-oil など)。原油にはさらに benchmark(wti、brent、urals、dubai)が付き、先物には取引所の標準コードである exchange_mic が付きます。
series[].area文字列areaは地域範囲を示し、全国系列では省略されます。
series[].country文字列WLDは世界の指標価格を表します。EUUは欧州連合を表します。国にはISO alpha-3コードを使用します。米国の燃料の全国平均にはUSAを使用します。
series[].price_type文字列燃料はretail_averageを使用します。EIAの日次スポット系列と月次系列はinternational_benchmarkを使用します。ただし、たばこはimport_unit_valueを使用します。
series[].basis文字列basisは価格の定義を示し、情報源に記載がない場合は省略されます。
リファレンス全文 →
GET現物価格系列の詳細を取得/v1/commodities/physical/series/{series_id}
週次燃料または月次ベンチマークの1系列について、定義、単位、対象範囲を取得します。
パラメータ
series_id必須fuel-eia-usa-regular-gasolineやworldbank-cmo-copperなど、系列検索で返される固定IDを使用してください。
レスポンスフィールド
series_id文字列系列検索で返される固定ID。
currency文字列建値通貨。米国の燃料系列と月次指標価格系列は、どちらもUSDを使用します。
unit / unit_quantity文字列公表時の単位と価格の対象数量。燃料にはus_gallonを使用します。月次指標価格にはmetric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit、sheetのいずれかを使用します。数量は1ですが、合板のみ100枚当たりのUSD建てです。値の換算は行いません。
unit_key文字列unit_keyは単位を標準的な表記に統一した値で、たとえばtroy_ounce、barrel、tonneです。unitは出典の表記をそのまま保持します。価格がセント建ての場合、price_scaleは0.01です。価格にこの値を掛けると、通貨単位の金額になります。
attribution文字列データとともにレスポンスの出典情報を保持してください。ソース：米国エネルギー情報局。ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
commodity / category / product文字列商品、カテゴリー、製品の定義。例：gasoline / energy / regular-gasoline、copper / metals / copper。系列検索で各系列の値を取得できます。
commodity_key文字列commodity_key は、スポット、先物、予測、現物の各価格で商品を同じ名前で表します(gold、crude-oil など)。原油にはさらに benchmark(wti、brent、urals、dubai)が付き、先物には取引所の標準コードである exchange_mic が付きます。
area文字列areaは地域範囲を示し、全国系列では省略されます。
country文字列WLDは世界の指標価格を表します。EUUは欧州連合を表します。国にはISO alpha-3コードを使用します。米国の燃料の全国平均にはUSAを使用します。
price_type文字列燃料はretail_averageを使用します。EIAの日次スポット系列と月次系列はinternational_benchmarkを使用します。ただし、たばこはimport_unit_valueを使用します。
basis文字列basisは価格の定義を示し、情報源に記載がない場合は省略されます。
frequency文字列EIAの石油・ガススポット価格は日次、米国の燃料は週次、World Bankの指標価格は月次です。
リファレンス全文 →
GET最新の現物価格を取得/v1/commodities/physical/series/{series_id}/latest
週次燃料または月次ベンチマークの最新の利用可能な価格を、観測期間とともに取得します。
パラメータ
series_id必須fuel-eia-usa-regular-gasolineやworldbank-cmo-copperなど、系列検索で返される固定IDを使用してください。
レスポンスフィールド
series_id文字列系列検索で返される固定ID。
currency文字列建値通貨。米国の燃料系列と月次指標価格系列は、どちらもUSDを使用します。
unit / unit_quantity文字列公表時の単位と価格の対象数量。燃料にはus_gallonを使用します。月次指標価格にはmetric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit、sheetのいずれかを使用します。数量は1ですが、合板のみ100枚当たりのUSD建てです。値の換算は行いません。
unit_key文字列unit_keyは単位を標準的な表記に統一した値で、たとえばtroy_ounce、barrel、tonneです。unitは出典の表記をそのまま保持します。価格がセント建ての場合、price_scaleは0.01です。価格にこの値を掛けると、通貨単位の金額になります。
attribution文字列データとともにレスポンスの出典情報を保持してください。ソース：米国エネルギー情報局。ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
period_start / period_end日付開始日と終了日を含む観測日。燃料では両方に月曜日の調査日を使用します。月次観測値は、2026-09-01から2026-09-30のように、その月全体を対象とします。
price小数文字列unit_quantity単位当たりの、系列の通貨で公表された価格。系列の価格種別とbasisを併せて確認してください。
published_on日付公表日。情報源に記載がない場合は省略されます。
revision整数1から始まり、後続の公表でその期間の値が変更されると増加します。
リファレンス全文 →
GET現物価格の履歴を取得/v1/commodities/physical/series/{series_id}/observations
週次燃料または月次商品の価格履歴を、期間、公表単位、改定とともに取得します。
パラメータ
series_id必須fuel-eia-usa-regular-gasolineやworldbank-cmo-copperなど、系列検索で返される固定IDを使用してください。
start任意開始日を含みます。startとendは両方指定するか、両方省略してください。
end任意終了日は含まず、startより後の日付を指定します。指定した日付範囲と重なる観測値を返します。
limit任意1ページ当たりの最大件数。デフォルトは100です。
cursor任意前のページのnext_cursorを、同じフィルターとlimitで使用してください。nullは次のページがないことを示します。
レスポンスフィールド
series_id文字列系列検索で返される固定ID。
currency文字列建値通貨。米国の燃料系列と月次指標価格系列は、どちらもUSDを使用します。
unit / unit_quantity文字列公表時の単位と価格の対象数量。燃料にはus_gallonを使用します。月次指標価格にはmetric_ton、kilogram、barrel、cubic_meter、troy_ounce、mmbtu、dry_metric_ton_unit、sheetのいずれかを使用します。数量は1ですが、合板のみ100枚当たりのUSD建てです。値の換算は行いません。
unit_key文字列unit_keyは単位を標準的な表記に統一した値で、たとえばtroy_ounce、barrel、tonneです。unitは出典の表記をそのまま保持します。価格がセント建ての場合、price_scaleは0.01です。価格にこの値を掛けると、通貨単位の金額になります。
attribution文字列データとともにレスポンスの出典情報を保持してください。ソース：米国エネルギー情報局。ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
observations配列古い順に並んだ観測値。各観測値にはperiod_start、period_end、小数文字列のprice、revisionが含まれます。published_onは任意です。
observations[].period_start / observations[].period_end日付開始日と終了日を含む観測日。燃料では両方に月曜日の調査日を使用します。月次観測値は、2026-09-01から2026-09-30のように、その月全体を対象とします。
observations[].price小数文字列unit_quantity単位当たりの、系列の通貨で公表された価格。系列の価格種別とbasisを併せて確認してください。
observations[].published_on日付公表日。情報源に記載がない場合は省略されます。
observations[].revision整数1から始まり、後続の公表でその期間の値が変更されると増加します。
next_cursor文字列または null内部構造の解釈を必要としない継続トークン。nullは最終ページを示します。
リファレンス全文 →
ユースケース
カバレッジ
ソース
関連 API
よくある質問
銅の価格履歴はどう取得しますか?
worldbank-cmo-copper を observations エンドポイントとともに使います。日付範囲を選ぶには、start と end を一緒に渡します。銅価格は、メトリックトンあたり USD の月次の10進数文字列です。
このコモディティ API には肥料価格と米価格も含まれますか?
はい。肥料価格には category=fertilizers、尿素の価格系列には commodity=urea、米の価格ベンチマークには commodity=rice を使います。検索すると、最新価格と履歴のための系列 ID が返ります。
履歴はどこまでさかのぼれますか?
月次系列の最も古いものは1960年1月に始まります。それ以外は開始が遅く、終了したものもあります。系列ごとに coverage_start と coverage_end を確認してください。
どの単位とライセンスが適用されますか?
All prices use USD and the published unit and quantity. No unit conversion is applied. Keep the attribution with the data, which is licensed under CC BY 4.0. ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
データを使う前に何を確認すべきですか
A new month is added after each monthly publication. Individual series can lag or have ended. Barley and sorghum end in August 2020; Mexican shrimp ends in October 2023. Check coverage_end before treating a value as current. Most series use WLD for a world benchmark. Others identify a country or the European Union. ソース：The World Bank: World Bank Commodity Price Data (The Pink Sheet), CC BY 4.0
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。