自国通貨での価格
為替レートを使って、商品価格を自分の通貨に換算します。
ガイドを読む →すべてのAPI
米国燃料価格 API
ガソリン価格推移を1990年から、軽油価格を1994年から週次で提供。単位は米ガロンあたりUSD。出典は米国エネルギー情報局(U.S. Energy Information Administration)です。
最初のリクエスト
米国のガソリン系列を探す
curl --request GET \
--url "https://api.narwhalapi.com/v1/commodities/physical/series?commodity=gasoline" \
--header "Authorization: Bearer $NARWHAL_API_KEY"レスポンスの例
{
"series": [
{
"series_id": "fuel-eia-usa-regular-gasoline",
"commodity": "gasoline",
"category": "energy",
"product": "regular-gasoline",
"country": "USA",
"price_type": "retail_average",
"basis": "cash self-serve pump price incl. all taxes, 8:00 a.m. Monday",
"currency": "USD",
"unit": "us_gallon",
"unit_key": "gallon",
"unit_quantity": "1",
"frequency": "weekly",
"description": "United States: regular gasoline (all formulations), weekly average retail price in dollars per gallon from EIA's Monday survey (series EMM_EPMR_PTE_NUS_DPG.W).",
"attribution": "Source: U.S. Energy Information Administration",
"coverage_start": "1990-08-20",
"coverage_end": "2026-10-19"
}
],
"next_cursor": null
}エンドポイント
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
よくある質問
ガソリン価格 API は何をカバーしますか?
米国の平均と9つの地域におけるレギュラーガソリンと No. 2 オンハイウェイ軽油の小売平均です。
どれくらいの履歴が利用できますか?
米国のレギュラーガソリンは1990年8月20日、米国の軽油は1994年3月21日に始まります。地域別の系列はそれより遅く、ガソリンは1992年、軽油は1997年から始まり、各系列がそれぞれの coverage_start を示します。日付範囲を指定するには observations エンドポイントを使ってください。
地域はどう選びますか?
commodity=gasoline または commodity=diesel で系列を検索します。area と description を読み、その series_id を使って詳細、最新価格、履歴を取得します。
データを使う前に何を確認すべきですか
燃料価格 API は、米国平均、東海岸(PADD 1)、ニューイングランド(PADD 1A)、中部大西洋岸(PADD 1B)、南部大西洋岸(PADD 1C)、中西部(PADD 2)、メキシコ湾岸(PADD 3)、ロッキー山脈(PADD 4)、西海岸(PADD 5)、カリフォルニアを除く西海岸に使えます。出典：U.S。Energy Information Administration
無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。