과거 바 데이터

지정한 종목에 대한 과거 OHLCV (시가, 고가, 저가, 종가, 거래량) 가격 바 데이터를 조회합니다. 지정한 간격에 따라 집계된 가격 데이터를 반환합니다. 여러 티커와 상대 날짜를 포함한 다양한 기간 지정 방식을 지원합니다.

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 · 필수

쉼표로 구분된 주식 티커 심볼 목록입니다(예: 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[]

Show child attributes

interval · integer

symbol · string