先物APIリファレンス

概要

29の先物(商品、株価指数、米国債、通貨)の価格と価格履歴。すべてのリクエストに Bearer キーが必要で、REST と MCP は同じクレジット残高を使います。

ID は取引所のルートコードです。たとえば WTI 原油は CL、金は GC、E-mini S&P 500 は ES、ユーロは 6E です。大文字小文字は問いません。一覧ルートは、すべての ID を名称、カテゴリ、取引所、通貨、単位とともに返します。

各系列は期近限月の契約を端から端までつないだもので、調整はしていません。期近限月が切り替わる日には、価格が前の契約から次の契約へ段差を描きます。この段差は、取引されたとおりにデータに含まれます。

ベースURL： https://api.narwhalapi.com。 MCP ツールは次のとおりです： futures, with one action 以下の各ルートに対応します。

すべてのアカウントで利用できるもの

参照： 料金表 で、呼び出し1回の料金を確認できます。ルートに別の記載がない限り、リクエストはそのAPIの料金で課金されます。

• 先物の価格には、前日終値、変化、出来高がありません。ロールをまたぐ変化は誤った値になるため、API は算出しません。
• 価格とバーは、取引されたとおりの期近限月です。ロール日ごとに段差が生じます。CL は 2026年10月19日に約4ドルの段差が出ました。この段差を1日の値動きと読まないでください。
• market_session は、契約の公表された取引時間にもとづき open または closed になります。closed の系列は直近価格を返し、古い値(stale)にはなりません。open の系列は、価格が15分より古いと古い値(stale)になります。
• 日次バーは1取引日分で、00:00 UTC に現れます。当日の途中のバーは表示されません。
• 1分バーは12か月分を保持し、1回のリクエストで取得できるのは最大5日分です。
• バッチは最大50件の ID を受け付け、価格を返した ID ごとに1回の呼び出しとして数えます。不明な ID は errors に並び、数えません。

エンドポイント

すべてのルートは GET で、キーを次のヘッダーで渡す必要があります: Authorization: Bearer ヘッダー。例はレスポンスの形を示すもので、ライブデータではありません。

価格を提供している先物

GET /v1/futures

価格を提供しているすべての先物系列を、ID 順に名称と単位とともに返します。自社の一覧から読むため、すべてのアカウントで利用でき、1回の呼び出しとして数えます。

MCP: ツール futures, action list。

パラメータ

このルートにパラメーターはありません。

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/futures"

{
  "futures": [
    {
      "id": "CL",
      "name": "WTI Crude Oil",
      "category": "energy",
      "exchange": "NYMEX",
      "currency": "USD",
      "unit": "usd_per_barrel"
    },
    {
      "id": "GC",
      "name": "Gold",
      "category": "metals",
      "exchange": "COMEX",
      "currency": "USD",
      "unit": "usd_per_troy_ounce"
    }
  ]
}

先物系列1件の最新価格

GET /v1/futures/{id}/price

最新価格です。market_session は系列の取引時間にもとづき open または closed になります。closed の系列は直近価格を返し、stale が true になるのは、open の系列で直近15分以内の価格がない場合のみです。先物の価格には、前日終値、変化、出来高がありません。系列は期近限月を端から端までつないだもので調整していないため、ロール日ごとに段差があります。

MCP: ツール futures, action price。

パラメータ

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/futures/CL/price"

{
  "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
}

最大50の先物系列の最新価格

GET /v1/futures/prices

指定した各 ID の最新価格を返します。価格を返した ID ごとに1回の呼び出しとして数え、一括で課金します。解決できた ID の分を残高で支払えない場合、リクエスト全体が 402 insufficient_credits で拒否されます。価格を返さなかった ID は errors に(id として)並び、課金されません。どの ID も解決できなくてもレスポンスは 200 で、prices は空になります。先物の価格には、前日終値、変化、出来高がありません。系列は期近限月を端から端までつないだもので調整していないため、ロール日ごとに段差があります。

ID は最大50件まで送れます。バッチは一括で課金されます。解決できた ID の分を残高で払えない場合、リクエスト全体が 402 insufficient_credits を返します。

MCP: ツール futures, action prices。

パラメータ

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/futures/prices?ids=CL,GC,ES"

{
  "prices": [
    {
      "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
    },
    {
      "id": "GC",
      "name": "Gold",
      "exchange": "COMEX",
      "currency": "USD",
      "unit": "usd_per_troy_ounce",
      "price": "4021.3",
      "market_session": "open",
      "timestamp": "2026-10-29T18:38:00Z",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "XX",
      "code": "not_found"
    }
  ]
}

先物系列1件の価格バー

GET /v1/futures/{id}/bars

日次(1d。1取引日につき1バー)または1分(1m)のバーを古い順に返します。1日のバーは、その翌日の 00:00 UTC に出ます。当日の途中のバーは表示されません。1分バーは12か月分を保持します。履歴はすべてのアカウントで全期間を取得できます。1ページ最大5,000バーで、next_cursor を返します。1ページにつき1回の呼び出しです。

バーは加工していない期近限月の価格です。そのため、ロール日にはバーが前のバーの終値から離れて始まることがあります。

MCP: ツール futures, action bars。

パラメータ

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/futures/ES/bars?interval=1d&start=2017-04-03&end=2017-04-05"

{
  "id": "ES",
  "currency": "USD",
  "bars": [
    {
      "timestamp": "2017-04-03T00:00:00Z",
      "open": "2357.5",
      "high": "2363.25",
      "low": "2340",
      "close": "2354.5"
    }
  ],
  "next_cursor": null
}

エラー

エラーは共通の problem 形式で返され、次のコードを含みます: request_id。参照： APIエラーとクレジット で形式とクレジットヘッダーを確認できます。失敗したリクエストには課金されません。