kquant API document (0.3.6)

chart_candle

일간 캔들챠트를 출력하는 함수

chart_candle(
    df: 'pd.DataFrame',
    overlay: 'Optional[dict[Union[str, pd.Series], Any]]'=None,
    date: 'Optional[Union[str, pd.Series]]'=None,
    open: 'Optional[Union[str, pd.Series]]'=None,
    high: 'Optional[Union[str, pd.Series]]'=None,
    low: 'Optional[Union[str, pd.Series]]'=None,
    close: 'Optional[Union[str, pd.Series]]'=None,
    volume: 'Optional[Union[str, pd.Series]]'=None,
    start_date: 'DATE_IN'=None,
    end_date: 'DATE_IN'=None,
    title: 'Optional[str]'=None,
    height: 'Optional[int]'=None,
    width: 'Optional[int]'=None,
    **candle_opt,
) -> go.Figure

• df (pd.DataFrame): 주가 정보 데이터프레임

• overlay (Optional[dict[Union[str, pd.Series], dict[str, Any]]]): 오버레이 정보 딕셔너리. 오버레이는 기본 차트 위에 사용자가 덧그릴 수 있는 그림.

  키로 오버레이 정보가 되는 데이터프레임 열 이름 문자열을 넣고 값으로 해당 오버레이 그림 속성을 딕셔너리 형태로 입력. 만약 모든 값을 디폴트로 자동생성하려면 빈 딕셔너리 또는 None을 값으로 입력.

  처리 가능한 오버레이의 속성은 다음과 같음

  • row: 오버레이를 그릴 행 번호 정수. 생략하면 1. 최대 행은 4
  • mode: 오버레이를 그리는 방식 문자열. 다음 문자열 사용. 생략하면 “lines”
    • “lines”: 선
    • “markers”: 마커
    • “lines+markers”: 선 + 마커
  • line_color: 선 색상 문자열. css 색상 문자열. 생략하면 자동
  • line_width: 선 굵기 정수. 생략하면 1
  • line_dash: 선 스타일 문자열. 생략하면 “solid”
    • “solid”
    • “dash”
    • “longdash”
    • “dot”
    • “dashdot”
  • marker_color: 마커 색상 문자열. css 색상 문자열. 생략하면 자동
  • marker_size: 마커 크기 정수. 생략하면 1
  • marker_symbol: 마커 기호 문자열. 생략하면 자동
    • “circle”
    • “square”
    • “diamond”
    • “cross”
    • “x”
    • “triangle-up”
    • “triangle-down”
    • “triangle-left”
    • “triangle-right”
    • “triangle-ne”
    • “triangle-se”
    • “triangle-nw”
    • “triangle-sw”
    • “pentagon”
    • “hexagon”
    • “hexagon2”
    • “octagon”
    • “star”

• date (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 날짜 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “DATE”

• close (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 시가 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “OPEN”

• close (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 고가 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “HIGH”

• close (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 저가 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “LOW”

• close (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 종가 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “CLOSE”

• volume (Optional[Union[str, pd.Series]]): 입력 데이터프레임에서 거래량 열의 문자열 혹은 날짜 열 Series 객체. 생략하면 “VOLUME”

• start_date (DATE_IN): 시작일 정보. 생략하면 데이터프레임의 첫 날짜

• end_date (DATE_IN): 종료일 정보. 생략하면 데이터프레임의 마지막 날짜

• title (Optional[str]): 제목 문자열. 생략하면 자동 생성

• height (Optional[int]): 높이 정수. 생략하면 자동

• width (Optional[int]): 폭 정수. 생략하면 자동

• None (Optional[list[float]]): 챠트 행 높이 비율을 나타내는 부동소수점 리스트. 생략하면 자동

• 반환값 (go.Figure): 챠트 객체

위 인수 이외에 추가적으로 오버레이 속성과 같은 차트 속성을 이름있는 인수로 넣을 수 있습니다.