ヒストリカルバー

指定した証券の過去の OHLCV（始値・高値・安値・終値・出来高）の価格バー データを取得します。指定したインターバルに基づいて集計された価格データを返します。複数の ticker シンボルおよび相対日付を含むさまざまな期間指定をサポートします。

GET /api/v2/bars

ヒストリカル価格バー

cURL

curl --request GET \
  --url 'https://api.example.com/api/v2/bars?token='

レスポンス (200 OK)

[
  {
    "symbol": "AAPL",
    "interval": 7200,
    "candles": [
      {
        "time": "1765202400000",
        "open": 278.11,
        "high": 279.6693,
        "low": 277.05,
        "close": 277.335,
        "volume": "9174901",
        "dateTime": "2025-12-08T09:00:00.000-05:00"
      },
      {
        "time": "1765209600000",
        "open": 277.335,
        "high": 277.88,
        "low": 276.7,
        "close": 277.33,
        "volume": "6501561",
        "dateTime": "2025-12-08T11:00:00.000-05:00"
      },
      {
        "time": "1765987200000",
        "open": 274.6,
        "high": 275.07,
        "low": 272.28,
        "close": 273.38,
        "volume": "7179965",
        "dateTime": "2025-12-17T11:00:00.000-05:00"
      },
      {
        "time": "1766073600000",
        "open": 272,
        "high": 273.164,
        "low": 269.94,
        "close": 272.4,
        "volume": "8374648",
        "dateTime": "2025-12-18T11:00:00.000-05:00"
      },
      {
        "time": "1766080800000",
        "open": 272.37,
        "high": 272.96,
        "low": 270.5,
        "close": 270.865,
        "volume": "6415588",
        "dateTime": "2025-12-18T13:00:00.000-05:00"
      },
      {
        "time": "1767636000000",
        "open": 267.57,
        "high": 267.89,
        "low": 266.14,
        "close": 266.61,
        "volume": "5846734",
        "dateTime": "2026-01-05T13:00:00.000-05:00"
      }
    ]
  }
]

レスポンス (200 OK)

[
  {
    "symbol": "AAPL",
    "interval": 7200,
    "candles": [
      {
        "time": "1765202400000",
        "open": 278.11,
        "high": 279.6693,
        "low": 277.05,
        "close": 277.335,
        "volume": "9174901",
        "dateTime": "2025-12-08T09:00:00.000-05:00"
      },
      {
        "time": "1765209600000",
        "open": 277.335,
        "high": 277.88,
        "low": 276.7,
        "close": 277.33,
        "volume": "6501561",
        "dateTime": "2025-12-08T11:00:00.000-05:00"
      },
      {
        "time": "1765987200000",
        "open": 274.6,
        "high": 275.07,
        "low": 272.28,
        "close": 273.38,
        "volume": "7179965",
        "dateTime": "2025-12-17T11:00:00.000-05:00"
      },
      {
        "time": "1766073600000",
        "open": 272,
        "high": 273.164,
        "low": 269.94,
        "close": 272.4,
        "volume": "8374648",
        "dateTime": "2025-12-18T11:00:00.000-05:00"
      },
      {
        "time": "1766080800000",
        "open": 272.37,
        "high": 272.96,
        "low": 270.5,
        "close": 270.865,
        "volume": "6415588",
        "dateTime": "2025-12-18T13:00:00.000-05:00"
      },
      {
        "time": "1767636000000",
        "open": 267.57,
        "high": 267.89,
        "low": 266.14,
        "close": 266.61,
        "volume": "5846734",
        "dateTime": "2026-01-05T13:00:00.000-05:00"
      }
    ]
  }
]

承認

token · string · query · 必須

クエリパラメータ

symbols · string · 必須

株式のtickerシンボルのカンマ区切りリスト（例: AAPL,MSFT,TSLA）。必須。

from · string · 必須

バーの開始日時。形式: YYYY-MM-DD、YYYY-MM-DDTHH:MM:SS、YTD（年初来）、または 1MONTH/1m/1M、1WEEK/1w/1W、1DAY/1d/1D などの相対指定。必須。

to · string

バーの終了日時。形式：YYYY-MM-DD または YYYY-MM-DDTHH:MM:SS。未指定の場合は、現在の日時がデフォルトになります。

interval · string

価格バーを集計する際の時間バケット間隔。サポートされる値: 1m（1分）、5m（5分）、15m（15分）、30m（30分）、1h（1時間）、1d（1日）、1w（1週間）、1M（1か月）。デフォルト値: 1d

session · string

取引セッションのフィルター。指定可能な値: ANY（すべてのセッション）、PRE_MARKET（プレマーケット取引）、REGULAR（通常の取引時間）、AFTER_MARKET（アフターマーケット取引）。既定値: ANY

レスポンス

200

application/json

各シンボルごとのOHLCVバーを含むチャートデータ配列

candles · object[]

表示 子属性

interval · integer

symbol · string