메인 콘텐츠로 건너뛰기
GET
/
api
/
v2
/
bars
과거 가격 바
curl --request GET \
  --url 'https://api.example.com/api/v2/bars?token='
[
  {
    "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"
      }
    ]
  }
]

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

응답

각 심볼별 OHLCV 바 차트 데이터 배열

​
candles
object[]
​
interval
integer
​
symbol
string