kquant API document (0.3.6)

trade_stock

예상 체결가를 포함한 주식 종목의 체결 틱데이터 정보를 반환하는 함수

• API URL
  • /stock/m001/tick_info
  • /stock/m003/tick_info

trade_stock(
    symbol: 'str',
    count: 'int',
    loc: 'str'='last',
) -> pd.DataFrame

• symbol (str): 주식 종목의 단축 종목코드

• count (int): 체결 데이터 개수

• loc (str): 데이터 위치를 나타내는 문자열. loc=“open”면 장시작부터 count 개수만큼 loc=“last”면 현재시점부터 과거로 count 개수만큼

• 반환값 (pd.Series): 주식 종목의 체결 틱데이터 정보 컬럼은 아래의 표 참조

  필드명	의미	타입
  SYMBOL	종목 단축코드	string
  SERIAL	종목별 저장 일련번호	np.int64
  SESSION	장구분	np.int64
  TIME	체결시간	np.int64
  PRICE	체결가	np.int64
  CHG	등락	np.int64
  CHG_PCT	등락율	np.float64
  CHG_TYPE	등락구분	np.int64
  VOLUME	거래량 (동시호가시에는 예상)	np.int64
  VOLUME_ACC	누적거래량 (동시호가시에는 예상)	np.int64
  AMOUNT_ACC	누적거래대금 (정규장만)	np.int64
  TRADE_TYPE	체결성향	np.int64
  ASK	최우선매도호가	np.int64
  BID	최우선매수호가	np.int64
  ASKQTY	최우선매도호가잔량	np.int64
  BIDQTY	최우선매수호가잔량	np.int64
  MARKETCAP	시가총액	np.int64

  • SESSION 장구분 값의 의미

    값	의미
    0	장전
    1	동시호가(예상체결가)
    2	접속
    3	시간외단일가 동시
    4	시간외단일 접속
    5	BuyIn동시
    6	BuyIn접속

  • TIME 체결시간 값의 의미

    값	의미
    8300000 ~	장중
    ~ 17000000	장중
    31000000	장마감
    41000000	시간외마감

  • TRADE_TYPE 체결성향 값의 의미

    값	의미
    1	B
    2	BB
    3	동시
    4	S
    5	SS
    9	대량
    10	바스켓
    11	신고대량
    27	경매매

  • CHG_TYPE 등락구분 값의 의미

    값	의미
    1	상한
    2	상승
    3	보합
    4	하한
    5	하락
    6	기세상한
    7	기세상승
    8	기세하한
    9	기세하락

예제 코드

import kquant as kq

kq.trade_stock("005930", 10)

	SYMBOL	SERIAL	SESSION	TIME	PRICE	CHG	CHG_PCT	CHG_TYPE	VOLUME	VOLUME_ACC	AMOUNT_ACC	TRADE_TYPE	ASK	BID	ASKQTY	BIDQTY	MARKETCAP
0	005930	8,101,900	3	16,582,400	73,100	-200	-0.2700	70	-90	1,028	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
1	005930	8,102,000	3	16,584,900	73,100	-200	-0.2700	70	2	1,030	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
2	005930	8,102,100	3	16,585,500	73,000	-300	-0.4100	70	88	1,118	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
3	005930	8,102,200	3	16,585,600	73,000	-300	-0.4100	70	150	1,268	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
4	005930	8,102,300	3	16,590,300	73,000	-300	-0.4100	70	-100	1,168	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
5	005930	8,102,400	3	16,590,400	73,000	-300	-0.4100	70	-1	1,167	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
6	005930	8,102,500	3	16,591,000	73,000	-300	-0.4100	70	-100	1,067	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
7	005930	8,102,600	3	16,591,200	73,100	-200	-0.2700	70	-19	1,048	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
8	005930	8,102,700	3	16,591,300	73,100	-200	-0.2700	70	20	1,068	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000
9	005930	8,102,800	3	16,595,700	73,100	-200	-0.2700	70	-17	1,051	828,140,132,100	3	73,000	72,900	3,081	163,191	435,794,126,150,000

kq.trade_stock("005930", 10, "open")

	SYMBOL	SERIAL	SESSION	TIME	PRICE	CHG	CHG_PCT	CHG_TYPE	VOLUME	VOLUME_ACC	AMOUNT_ACC	TRADE_TYPE	ASK	BID	ASKQTY	BIDQTY	MARKETCAP
0	005930	100	0	8,300,000	73,300	0	0.0000	3	1	1	0	3	0	0	0	0	437,585,060,915,000
1	005930	200	0	8,300,000	73,300	0	0.0000	3	2	3	0	3	0	0	0	0	437,585,060,915,000
2	005930	300	0	8,300,000	73,300	0	0.0000	3	5	8	0	3	0	0	0	0	437,585,060,915,000
3	005930	400	0	8,300,000	73,300	0	0.0000	3	100	108	0	3	0	0	0	0	437,585,060,915,000
4	005930	500	0	8,300,100	73,300	0	0.0000	3	100	208	0	3	0	0	0	0	437,585,060,915,000
5	005930	600	0	8,300,100	73,300	0	0.0000	3	10	218	0	3	0	0	0	0	437,585,060,915,000
6	005930	700	0	8,300,100	73,300	0	0.0000	3	7	225	0	3	0	0	0	0	437,585,060,915,000
7	005930	800	0	8,300,200	73,300	0	0.0000	3	1	226	0	3	0	0	0	0	437,585,060,915,000
8	005930	900	0	8,300,400	73,300	0	0.0000	3	50	276	0	3	0	0	0	0	437,585,060,915,000
9	005930	1,000	0	8,300,400	73,300	0	0.0000	3	140	416	0	3	0	0	0	0	437,585,060,915,000