株価指数APIリファレンス

概要

18の株価指数とボラティリティ指数の水準と水準の履歴。すべてのリクエストに Bearer キーが必要で、REST と MCP は同じクレジット残高を使います。

ID は指数の標準コードです。たとえば S&P 500 は SPX、Nasdaq-100 は NDX、ダウ工業株30種平均は DJI です。大文字小文字は問いません。一覧ルートは、すべての ID を名称、地域、通貨とともに返します。

指数の日次履歴が揃うと、価格には前日終値、変化、パーセント単位の変化が含まれます。

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

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

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

• 履歴は、保有している時点から始まります。S&P 500 は2023年2月からです。
• ボラティリティ指数(VIX、OVX、GVZ)は金額ではないため、レスポンスに通貨は含まれません。
• 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/indices

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

MCP: ツール indices, action list。

パラメータ

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

レスポンスフィールド

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

{
  "indices": [
    {
      "id": "SPX",
      "name": "S&P 500",
      "region": "us",
      "currency": "USD"
    },
    {
      "id": "VIX",
      "name": "Cboe Volatility Index",
      "region": "us"
    }
  ]
}

指数系列1件の最新価格

GET /v1/indices/{id}/price

最新価格です。market_session は系列の取引時間にもとづき open または closed になります。closed の系列は直近価格を返し、stale が true になるのは、open の系列で直近15分以内の価格がない場合のみです。previous_close は前取引日の終値で、change_percent はパーセント単位です。

MCP: ツール indices, action price。

パラメータ

レスポンスフィールド

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

{
  "id": "SPX",
  "name": "S&P 500",
  "currency": "USD",
  "price": "7696.46",
  "previous_close": "7681.2",
  "change": "15.26",
  "change_percent": "0.2",
  "market_session": "open",
  "timestamp": "2026-10-29T18:38:00Z",
  "stale": false
}

最大50の指数系列の最新価格

GET /v1/indices/prices

指定した各 ID の最新価格を返します。価格を返した ID ごとに1回の呼び出しとして数え、一括で課金します。解決できた ID の分を残高で支払えない場合、リクエスト全体が 402 insufficient_credits で拒否されます。価格を返さなかった ID は errors に(id として)並び、課金されません。どの ID も解決できなくてもレスポンスは 200 で、prices は空になります。previous_close は前取引日の終値で、change_percent はパーセント単位です。

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

MCP: ツール indices, action prices。

パラメータ

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices/prices?ids=SPX,NDX,DJI"

{
  "prices": [
    {
      "id": "SPX",
      "name": "S&P 500",
      "currency": "USD",
      "price": "7696.46",
      "previous_close": "7681.2",
      "change": "15.26",
      "change_percent": "0.2",
      "market_session": "open",
      "timestamp": "2026-10-29T18:38:00Z",
      "stale": false
    },
    {
      "id": "NDX",
      "name": "Nasdaq-100",
      "currency": "USD",
      "price": "27310.5",
      "previous_close": "27264.9",
      "change": "45.6",
      "change_percent": "0.17",
      "market_session": "open",
      "timestamp": "2026-10-29T18:38:00Z",
      "stale": false
    }
  ],
  "errors": [
    {
      "id": "XX",
      "code": "not_found"
    }
  ]
}

指数系列1件の価格バー

GET /v1/indices/{id}/bars

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

MCP: ツール indices, action bars。

パラメータ

レスポンスフィールド

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/indices/SPX/bars?interval=1d&start=2026-10-01"

{
  "id": "SPX",
  "currency": "USD",
  "bars": [
    {
      "timestamp": "2026-10-28T00:00:00Z",
      "open": "7655.1",
      "high": "7702.4",
      "low": "7640.8",
      "close": "7681.2"
    }
  ],
  "next_cursor": null
}

エラー

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