全履歴をバックフィルする
履歴をすべてページ単位で取得してファイルに保存し、途中で止まっても再開します。
ガイドを読む →13のコモディティ先物の最新価格と、日足または1分足の履歴を、RESTまたはMCPで取得できます。各系列は期近限月の契約なので、ロール日には価格に段差が生じます。
curl --request GET \
--url "https://api.narwhalapi.com/v1/futures/CL/price" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"id": "CL",
"name": "WTI Crude Oil",
"commodity_key": "crude-oil",
"benchmark": "wti",
"exchange": "NYMEX",
"exchange_mic": "XNYM",
"currency": "USD",
"unit": "usd_per_barrel",
"unit_key": "barrel",
"price": "102.11",
"market_session": "open",
"timestamp": "2026-10-29T18:38:00Z",
"stale": false
}/v1/futures価格を算出しているすべての先物契約を、名称、カテゴリ、取引所、通貨、単位とともに一覧表示します。
futuresオブジェクトの配列価格を算出しているすべての契約。それぞれにid、名称、カテゴリ、取引所、通貨、単位が付きます。
/v1/futures/{id}/price1つの契約の最新価格を取得します。
id必須先物 ID。取引所のルートコードです(例: CL、GC、ES、6E)。大文字小文字は問いません。系列は連続した期近限月で、調整していないため、ロール日ごとに段差があります。
id文字列ルートコード(例: CL)。
name文字列契約の正式名称。
commodity_key文字列商品の固定キー。スポット、先物、予測、現物価格で共通です(例: gold、crude-oil)。これらを結合するのに使います。株価指数、金利、通貨の先物では省略されます。
benchmarkwti、brent、urals、dubai のいずれか原油のベンチマーク(wti、brent、urals、dubai)。原油のみで送られます。これがない原油の行は、原油全体を指します。
exchange文字列契約が取引されている取引所。
exchange_mic文字列取引所の ISO 10383 市場識別コード(例: XNYM)。
currency文字列価格の通貨。
unit文字列価格の単位(例: usd_per_barrel、index_point)。
unit_key文字列単位の正規の小文字名。その単位を使うすべての面で同じです(例: barrel、troy_ounce、mmbtu、tonne)。unit は提供元の表記をそのまま保持します。
price_scale文字列価格が補助単位で表示されている場合にのみ送られます。price にこの値を掛けると currency 建ての価格になります。0.01 は price がセント建てであることを示し、unit が cent_per_bushel で price が 450 なら、1ブッシェルあたり 4.50 USD です。
/v1/futures/prices最大50契約の最新価格を1回の呼び出しで取得します。
ids必須カンマ区切りの ID。重複を除いて最大50件です。各 ID は単一価格ルートと同じ規則に従います。価格を返した ID ごとに1回の呼び出しとして数えます。
pricesオブジェクトの配列価格が返ったidごとに1件。1件分の価格のフィールドが含まれます。
errorsオブジェクトの配列価格を返さなかったID。それぞれコードnot_foundが付きます。料金はかかりません。
/v1/futures/{id}/bars1つの契約の日足または1分足バーを、古い順に取得します。価格は調整前の期近限月の価格なので、ロール日には段差が生じます。
id必須先物 ID。取引所のルートコードです(例: CL、GC、ES、6E)。大文字小文字は問いません。系列は連続した期近限月で、調整していないため、ロール日ごとに段差があります。
interval任意1d(取引日ごとに1本のバー。そのバーが属する日付で表示)または 1m(1分足。12か月間保持)。それ以外は 400 invalid_interval になります。
start任意最初のバー。1d: 日付(YYYY-MM-DD)、その日を含みます。省略すると最も古いバーになります。1m: UTC時刻(YYYY-MM-DDTHH:MM:SSZ、または 00:00 UTC とみなす日付)、その時刻を含みます。省略すると end の1日前になります。
end任意最後のバー。1d: 日付、その日を含みます。省略すると直近の確定済みの日になります。1m: UTC時刻、その時刻を含みません。省略すると現在時刻、または start の5日後になります。1m では start と end の間隔は最大5日です(400 range_too_large)。
cursor任意前のページの next_cursor。パラメーターは同じものを指定します。
id文字列ルートコード(例: CL)。
commodity_key文字列商品の固定キー。スポット、先物、予測、現物価格で共通です(例: gold、crude-oil)。これらを結合するのに使います。株価指数、金利、通貨の先物では省略されます。
benchmarkwti、brent、urals、dubai のいずれか原油のベンチマーク(wti、brent、urals、dubai)。原油のみで送られます。これがない原油の行は、原油全体を指します。
currency文字列価格の通貨。
price_scale文字列価格が補助単位で表示されている場合にのみ送られます。price にこの値を掛けると currency 建ての価格になります。0.01 は price がセント建てであることを示し、unit が cent_per_bushel で price が 450 なら、1ブッシェルあたり 4.50 USD です。
start文字列範囲の開始日が後ろへずらされた場合にのみ送られます。
end文字列送られません。価格はすべてのアカウントでリアルタイムだからです。
barsオブジェクトの配列バーは古い順です。それぞれに timestamp、open、high、low、close があり、出来高はありません。
next_cursor文字列次のページを読むには、この値を渡します。最後のページでは null です。
13銘柄。エネルギー:WTI原油、ヘンリーハブ天然ガス、RBOBガソリン、NYハーバーULSD。金属:金、銀、プラチナ、銅。穀物:トウモロコシ、小麦、大豆。畜産:生牛、リーンホッグ。
スポットAPIでは、金は多くの通貨で、銀、プラチナ、パラジウムは米ドルで提示されます。コモディティ先物は、期近限月の契約を米ドルで、その契約固有の単位で提示します。金先物(GC)と金スポット(XAU)は別の価格です。
各系列は期近限月の契約を端から端までつなげたもので、調整は行っていません。期近限月が切り替わると、系列は次の契約に移り、価格はその契約の価格に段差が生じます。CLは2026年10月19日に約$4の段差が出ました。価格とバーは取引された通りの段差をそのまま示すので、1日の値動きと読まないでください。このため、先物価格には前日終値も変化もありません。ロールをまたぐ変化は誤りになるためです。
各レスポンスには単位が付きます。CLは usd_per_barrel、NGは usd_per_mmbtu、RBとHOは usd_per_gallon、GC、SI、PLは usd_per_troy_ounce、HGは usd_per_pound です。穀物は cent_per_bushel、畜産は cent_per_pound なので、これらの価格はドルではなくセント建てです。
価格はすべてのアカウントでリアルタイムです。日足は2017年4月までさかのぼり、すべてのアカウントで全履歴を取得できます。
1,000回あたり$2で、プリペイドのクレジットから差し引かれます。すべてのアカウントに、最初の12か月間、毎月$10分の無料クレジットが付与されます。
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。