KIS Developers menu

API 문서 HOME API 문서 [해외주식] 실시간시세

[해외주식] 실시간시세

해외주식 실시간지연체결가[실시간-007]

WEBSOCKET

해외주식 실시간지연체결가[실시간-007]

기본정보

  • Method
    POST
  • 실전 Domain
    ws://ops.koreainvestment.com:21000
  • 모의 Domain
    제공 안함
  • URL
    /tryitout/HDFSCNT0
  • Format
     
  • Content-Type
     

개요

해외주식 실시간지연체결가의 경우 무료시세(지연체결가)만이 제공되며, API로는 유료시세(실시간체결가)를 받아보실 수 없습니다.

※ 지연시세 지연시간 : 미국 - 실시간무료(0분지연) / 홍콩, 베트남, 중국 - 15분지연 / 일본 - 20분지연
미국의 경우 0분지연시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.

※ 추후 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시 실시간 시세 수신할 수 있도록 변경 예정

해당 API로 미국주간거래(10:00~16:00) 시세 조회도 가능합니다.
※ 미국주간거래 실시간 조회 시, 맨 앞자리(R), tr_key 중 시장구분 값을 다음과 같이 입력 → 나스닥: BAQ, 뉴욕: BAY, 아멕스: BAA

[참고자료]

실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py

실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)

종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
approval_key 웹소켓 접속키 String Y 286 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키
tr_type 등록/해제 String Y 1 1: 등록, 2:해제
custtype 고객 타입 String Y 1 B : 법인 / P : 개인
content-type 컨텐츠타입 String Y 20 utf-8

Body

Element 한글명 Type Required Length Description
tr_id 거래ID String Y 7 HDFSCNT0
tr_key D거래소명종목코드 String Y 6 <미국 야간거래/아시아 주간거래>
D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이

<미국 주간거래>
R+시장구분(3자리)+종목코드
예) RBAQAAPL : R+BAQ(나스닥)+AAPL(애플)
[시장구분]
BAY : 뉴욕(주간), BAQ : 나스닥(주간). BAA : 아멕스(주간)

Response

Body

Element 한글명 Type Required Length Description
RSYM 실시간종목코드 String Y 16 '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨'
SYMB 종목코드 String Y 16
ZDIV 수수점자리수 String Y 1
TYMD 현지영업일자 String Y 8
XYMD 현지일자 String Y 6
XHMS 현지시간 String Y 6
KYMD 한국일자 String Y 6
KHMS 한국시간 String Y 6
OPEN 시가 String Y 6
HIGH 고가 String Y 6
LOW 저가 String Y 6
LAST 현재가 String Y 6
SIGN 대비구분 String Y 6
DIFF 전일대비 String Y 8
RATE 등락율 String Y 6
PBID 매수호가 String Y 10
PASK 매도호가 String Y 10
VBID 매수잔량 String Y 10
VASK 매도잔량 String Y 10
EVOL 체결량 String Y 12
TVOL 거래량 String Y 12
TAMT 거래대금 String Y 10
BIVL 매도체결량 String Y 10 매수호가가 매도주문 수량을 따라가서 체결된것을 표현하여 BIVL 이라는 표현을 사용
ASVL 매수체결량 String Y 10 매도호가가 매수주문 수량을 따라가서 체결된것을 표현하여 ASVL 이라는 표현을 사용
STRN 체결강도 String Y 10
MTYP 시장구분 1:장중,2:장전,3:장후 String Y 10

해외주식 실시간지연호가(아시아)[실시간-008]

WEBSOCKET

해외주식 실시간지연호가(아시아)[실시간-008]

기본정보

  • Method
    POST
  • 실전 Domain
    ws://ops.koreainvestment.com:21000
  • 모의 Domain
    제공 안함
  • URL
    /tryitout/HDFSASP1
  • Format
     
  • Content-Type
     

개요

해외주식 실시간지연체결가(아시아)의 경우 무료시세(지연호가)만이 제공되며, API로는 유료시세(실시간호가)를 받아보실 수 없습니다.

※ 지연시세 지연시간 : 홍콩, 베트남, 중국 - 15분지연 / 일본 - 20분지연

※ 현재로서는 해외주식(아시아)의 경우 지연시세만 수신되며, 1호가까지만 수신됨 (무료)
추후 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시 10호가까지 수신할 수 있도록 변경 예정


[참고자료]

실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py

실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
approval_key 웹소켓 접속키 String Y 286 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키
custtype 고객 타입 String Y 1 B : 법인 / P : 개인
tr_type 등록/해제 String Y 1 "1: 등록, 2:해제"
content-type 컨텐츠타입 String Y 20 utf-8

Body

Element 한글명 Type Required Length Description
tr_id 거래ID String Y 7 HDFSASP1
tr_key D거래소명종목코드 String Y 6 D+시장구분(3자리)+종목코드
예) DHKS00003 : D+HKS(홍콩)+00003(홍콩중화가스)
[시장구분]
TSE : 도쿄, HKS : 홍콩,
SHS : 상해, SZS : 심천
HSX : 호치민, HNX : 하노이

Response

Body

Element 한글명 Type Required Length Description
RSYM 실시간종목코드 String Y 16 '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨'
SYMB 종목코드 String Y 16
ZDIV 소수점자리수 String Y 1
XYMD 현지일자 String Y 8
XHMS 현지시간 String Y 6
KYMD 한국일자 String Y 8
KHMS 한국시간 String Y 6
BVOL 매수총잔량 String Y 10
AVOL 매도총잔량 String Y 10
BDVL 매수총잔량대비 String Y 10
ADVL 매도총잔량대비 String Y 10
PBID1 매수호가1 String Y 12
PASK1 매도호가1 String Y 12
VBID1 매수잔량1 String Y 10
VASK1 매도잔량1 String Y 10
DBID1 매수잔량대비1 String Y 10
DASK1 매도잔량대비1 String Y 10

해외주식 실시간체결통보[실시간-009]

WEBSOCKET

해외주식 실시간체결통보[실시간-009]

기본정보

  • Method
    POST
  • 실전 Domain
    ws://ops.koreainvestment.com:21000
  • 모의 Domain
    모의투자 미지원
  • URL
    /tryitout/H0GSCNI0
  • Format
     
  • Content-Type
     

개요

[참고자료]

실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py

실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
approval_key 웹소켓 접속키 String Y 286 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키
tr_type 등록/해제 String Y 1 1: 등록, 2:해제
custtype 고객 타입 String Y 1 B : 법인 / P : 개인
content-type 컨텐츠타입 String Y 20 utf-8

Body

Element 한글명 Type Required Length Description
tr_id 거래ID String Y 7 H0GSCNI0
tr_key HTSID String Y 8 HTSID

Response

Body

Element 한글명 Type Required Length Description
CUST_ID 고객 ID String Y 8 '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨'
ACNT_NO 계좌번호 String Y 10
ODER_NO 주문번호 String Y 10
OODER_NO 원주문번호 String Y 10
SELN_BYOV_CLS 매도매수구분 String Y 2
RCTF_CLS 정정구분 String Y 1
ODER_KIND2 주문종류2 String Y 1
STCK_SHRN_ISCD 주식 단축 종목코드 String Y 9
CNTG_QTY 체결 수량 String Y 10
CNTG_UNPR 체결단가 String Y 9 ※ 체결단가의 경우, 국가에 따라 소수점 생략 위치가 상이합니다.
미국 4 일본 1 중국 3 홍콩 3 베트남 0
EX) 미국 AAPL(현재가 : 148.0100)의 경우 001480100으로 체결단가가 오는데,
4번째 자리에 소수점을 찍어 148.01로 해석하시면 됩니다.
STCK_CNTG_HOUR 주식 체결 시간 String Y 6 특정 거래소의 체결시간 데이터는 수신되지 않습니다.
체결시간 데이터가 필요할 경우, 체결통보 데이터 수신 시 타임스탬프를 찍는 것으로 대체하시길 바랍니다.
RFUS_YN 거부여부 String Y 1
CNTG_YN 체결여부 String Y 1
ACPT_YN 접수여부 String Y 1
BRNC_NO 지점번호 String Y 5
ODER_QTY 주문수량 String Y 9
ACNT_NAME 계좌명 String Y 12
CNTG_ISNM 체결종목명 String Y 14
ODER_COND 해외종목구분 String Y 1
DEBT_GB 담보유형코드 String Y 2
DEBT_DATE 담보대출일자 String Y 8

해외주식 실시간호가(미국)[실시간-021]

WEBSOCKET

해외주식 실시간호가(미국)[실시간-021]

기본정보

  • Method
    POST
  • 실전 Domain
    ws://ops.koreainvestment.com:21000
  • 모의 Domain
    모의투자 미지원
  • URL
    /tryitout/HDFSASP0
  • Format
     
  • Content-Type
     

개요

해외주식 실시간호가(미국)의 경우 지연 없이 실시간호가 1호가까지 무료로 제공되며, API로는 유료시세(10호가)를 받아보실 수 없습니다.

※ 무료 1호가 시세제공 : 미국 - 실시간무료(0분지연)
※ 현재로서는 1호가까지만 수신됨 (무료)
추후 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 시 10호가까지 수신할 수 있도록 변경 예정

해당 API로 미국주간거래(10:00~16:00) 시세 조회도 가능합니다.
※ 미국주간거래 실시간 조회 시, 맨 앞자리(R), tr_key 중 시장구분 값을 다음과 같이 입력 → 나스닥: BAQ, 뉴욕: BAY, 아멕스: BAA

[참고자료]

실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py

실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
approval_key 웹소켓 접속키 String Y 286 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키
custtype 고객 타입 String Y 1 B : 법인 / P : 개인
tr_type 등록/해제 String Y 1 "1: 등록, 2:해제"
content-type 컨텐츠타입 String Y 20 utf-8

Body

Element 한글명 Type Required Length Description
tr_id 거래ID String Y 7 HDFSASP0
tr_key R거래소명종목코드 String Y 6 <미국 야간거래>
D+시장구분(3자리)+종목코드
예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)
[시장구분]
NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스

<미국 주간거래>
R+시장구분(3자리)+종목코드
예) RBAQAAPL : R+BAQ(나스닥)+AAPL(애플)
[시장구분]
BAY : 뉴욕(주간), BAQ : 나스닥(주간). BAA : 아멕스(주간)

Response

Body

Element 한글명 Type Required Length Description
rsym 실시간종목코드 Object Y 16 '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨'
-symb 종목코드 String Y 16
-zdiv 소숫점자리수 String Y 1
-xymd 현지일자 String Y 8
-xhms 현지시간 String Y 6
-kymd 한국일자 String Y 8
-khms 한국시간 String Y 6
-bvol 매수총잔량 String Y 10
-avol 매도총잔량 String Y 10
-bdvl 매수총잔량대비 String Y 10
-advl 매도총잔량대비 String Y 10
-pbid1 매수호가1 String Y 12
-pask1 매도호가1 String Y 12
-vbid1 매수잔량1 String Y 10
-vask1 매도잔량1 String Y 10
-dbid1 매수잔량대비1 String Y 10
-dask1 매도잔량대비1 String Y 10
-pbid2 매수호가2 String Y 12
-pask2 매도호가2 String Y 12
-vbid2 매수잔량2 String Y 10
-vask2 매도잔량2 String Y 10
-dbid2 매수잔량대비2 String Y 10
-dask2 매도잔량대비2 String Y 10
-pbid3 매수호가3 String Y 12
-pask3 매도호가3 String Y 12
-vbid3 매수잔량3 String Y 10
-vask3 매도잔량3 String Y 10
-dbid3 매수잔량대비3 String Y 10
-dask3 매도잔량대비3 String Y 10
-pbid4 매수호가4 String Y 12
-pask4 매도호가4 String Y 12
-vbid4 매수잔량4 String Y 10
-vask4 매도잔량4 String Y 10
-dbid4 매수잔량대비4 String Y 10
-dask4 매도잔량대비4 String Y 10
-pbid5 매수호가5 String Y 12
-pask5 매도호가5 String Y 12
-vbid5 매수잔량5 String Y 10
-vask5 매도잔량5 String Y 10
-dbid5 매수잔량대비5 String Y 10
-dask5 매도잔량대비5 String Y 10
-pbid6 매수호가6 String Y 12
-pask6 매도호가6 String Y 12
-vbid6 매수잔량6 String Y 10
-vask6 매도잔량6 String Y 10
-dbid6 매수잔량대비6 String Y 10
-dask6 매도잔량대비6 String Y 10
-pbid7 매수호가7 String Y 12
-pask7 매도호가7 String Y 12
-vbid7 매수잔량7 String Y 10
-vask7 매도잔량7 String Y 10
-dbid7 매수잔량대비7 String Y 10
-dask7 매도잔량대비7 String Y 10
-pbid8 매수호가8 String Y 12
-pask8 매도호가8 String Y 12
-vbid8 매수잔량8 String Y 10
-vask8 매도잔량8 String Y 10
-dbid8 매수잔량대비8 String Y 10
-dask8 매도잔량대비8 String Y 10
-pbid9 매수호가9 String Y 12
-pask9 매도호가9 String Y 12
-vbid9 매수잔량9 String Y 10
-vask9 매도잔량9 String Y 10
-dbid9 매수잔량대비9 String Y 10
-dask9 매도잔량대비9 String Y 10
-pbid10 매수호가10 String Y 12
-pask10 매도호가10 String Y 12
-vbid10 매수잔량10 String Y 10
-vask10 매도잔량10 String Y 10
-dbid10 매수잔량대비10 String Y 10
-dask10 매도잔량대비10 String Y 10

CONFIRM

x

CONFIRM

x

CONFIRM

x

시크릿조회

x

시크릿조회

x

제목

KIS Developers 이용약관

x
잠시만 기다려 주세요

마지막 로그인

x

로그인 날짜

2021-12-29 11:22:33

로그인 IP

0.0.0.0