API 문서 HOME API 문서 [장내채권] 실시간시세
[장내채권] 실시간시세
일반채권 실시간체결가 [실시간-052]
WEBSOCKET
일반채권 실시간체결가 [실시간-052]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain미지원
- URL/tryitout/H0BJCNT0
- Format
- Content-Type
개요
일반채권 실시간체결가 API입니다.
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
LAYOUT
Request
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
tr_id | 거래ID | String | Y | 13 | HH0BJCNT0 |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
STND_ISCD | 표준 종목코드 | String | Y | 12 |
Response
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
rt_cd | 성공 실패 여부 | String | Y | 1 | |
msg_cd | 응답코드 | String | Y | 8 | |
output1 | 응답상세 | Object | Y | ||
msg1 | 응답메세지 | String | Y | 80 | |
-stnd_iscd | 표준종목코드 | String | Y | 12 | |
-bond_isnm | 채권종목명 | String | Y | 80 | |
-stck_cntg_hour | 주식체결시간 | String | Y | 6 | |
-prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
-prdy_vrss | 전일대비 | String | Y | 8 | |
-prdy_ctrt | 전일대비율 | String | Y | 8 | |
-stck_prpr | 현재가 | String | Y | 8 | |
-cntg_vol | 체결거래량 | String | Y | 8 | |
-stck_oprc | 시가 | String | Y | 8 | |
-stck_hgpr | 고가 | String | Y | 8 | |
-stck_lwpr | 저가 | String | Y | 8 | |
-stck_prdy_clpr | 전일종가 | String | Y | 8 | |
-bond_cntg_ert | 현재수익률 | String | Y | 10 | |
-oprc_ert | 시가수익률 | String | Y | 10 | |
-hgpr_ert | 고가수익률 | String | Y | 10 | |
-lwpr_ert | 저가수익률 | String | Y | 10 | |
-acml_vol | 누적거래량 | String | Y | 8 | |
-prdy_vol | 전일거래량 | String | Y | 8 | |
-cntg_type_cls_code | 체결유형코드 | String | Y | 1 |
Example
Request
{
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BJCNT0",
"tr_key":"KR103502GD31"
}
}
}
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BJCNT0",
"tr_key":"KR103502GD31"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0BJCNT0",
"tr_key": "KR103502GD31",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BJCNT0|001|KR103502GD31^국고03250-5303(23-2)^131743^2^5.00^0.05^10575.00^1^10525.00^10578.00^10525.00^0.00^3.012^3.037^3.010^3.037^659
4124^9874082^2
# output - 정제 후
#### 장내채권 체결 ####
============================================
### [1 / 1]
표준종목코드 [KR103502GD31]
채권종목명 [국고03250-5303(23-2)]
주식체결시간 [131743]
전일대비부호 [2]
전일대비 [5.00]
전일대비율 [0.05]
현재가 [10575.00]
체결거래량 [1]
시가 [10525.00]
고가 [10578.00]
저가 [10525.00]
전일종가 [0.00]
현재수익률 [3.012]
시가수익률 [3.037]
고가수익률 [3.010]
저가수익률 [3.037]
누적거래량 [6594124]
전일거래량 [9874082]
체결유형코드 [2]
{
"header": {
"tr_id": "H0BJCNT0",
"tr_key": "KR103502GD31",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BJCNT0|001|KR103502GD31^국고03250-5303(23-2)^131743^2^5.00^0.05^10575.00^1^10525.00^10578.00^10525.00^0.00^3.012^3.037^3.010^3.037^659
4124^9874082^2
# output - 정제 후
#### 장내채권 체결 ####
============================================
### [1 / 1]
표준종목코드 [KR103502GD31]
채권종목명 [국고03250-5303(23-2)]
주식체결시간 [131743]
전일대비부호 [2]
전일대비 [5.00]
전일대비율 [0.05]
현재가 [10575.00]
체결거래량 [1]
시가 [10525.00]
고가 [10578.00]
저가 [10525.00]
전일종가 [0.00]
현재수익률 [3.012]
시가수익률 [3.037]
고가수익률 [3.010]
저가수익률 [3.037]
누적거래량 [6594124]
전일거래량 [9874082]
체결유형코드 [2]
일반채권 실시간호가 [실시간-053]
WEBSOCKET
일반채권 실시간호가 [실시간-053]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain미지원
- URL/tryitout/H0BJASP0
- Format
- Content-Type
개요
일반채권 실시간호가 API입니다.
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
LAYOUT
Request
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
tr_id | 거래ID | String | Y | 13 | HH0BJCNT0 |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
STND_ISCD | 표준 종목코드 | String | Y | 12 |
Response
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
rt_cd | 성공 실패 여부 | String | Y | 1 | |
msg_cd | 응답코드 | String | Y | 8 | |
output1 | 응답상세 | Object | Y | ||
msg1 | 응답메세지 | String | Y | 80 | |
-stnd_iscd | 표준종목코드 | String | Y | 12 | |
-stck_cntg_hour | 주식체결시간 | String | Y | 6 | |
-askp_ert1 | 매도호가수익률 | String | Y | 10 | |
-bidp_ert1 | 매수호가수익률1 | String | Y | 10 | |
-askp1 | 매도호가1 | String | Y | 8 | |
-bidp1 | 매수호가1 | String | Y | 8 | |
-askp_rsqn1 | 매도호가잔량1 | String | Y | 8 | |
-bidp_rsqn1 | 매수호가잔량1 | String | Y | 8 | |
-askp_ert2 | 매도호가수익률2 | String | Y | 10 | |
-bidp_ert2 | 매수호가수익률2 | String | Y | 10 | |
-askp2 | 매도호가2 | String | Y | 8 | |
-bidp2 | 매수호가2 | String | Y | 8 | |
-askp_rsqn2 | 매도호가잔량2 | String | Y | 8 | |
-bidp_rsqn2 | 매수호가잔량2 | String | Y | 8 | |
-askp_ert3 | 매도호가수익률3 | String | Y | 10 | |
-bidp_ert3 | 매수호가수익률3 | String | Y | 10 | |
-askp3 | 매도호가3 | String | Y | 8 | |
-bidp3 | 매수호가3 | String | Y | 8 | |
-askp_rsqn3 | 매도호가잔량3 | String | Y | 8 | |
-bidp_rsqn3 | 매수호가잔량3 | String | Y | 8 | |
-askp_ert4 | 매도호가수익률4 | String | Y | 10 | |
-bidp_ert4 | 매수호가수익률4 | String | Y | 10 | |
-askp4 | 매도호가4 | String | Y | 8 | |
-bidp4 | 매수호가4 | String | Y | 8 | |
-askp_rsqn4 | 매도호가잔량4 | String | Y | 8 | |
-bidp_rsqn4 | 매수호가잔량4 | String | Y | 8 | |
-askp_ert5 | 매도호가수익률5 | String | Y | 10 | |
-bidp_ert5 | 매수호가수익률5 | String | Y | 10 | |
-askp5 | 매도호가5 | String | Y | 8 | |
-bidp5 | 매수호가5 | String | Y | 8 | |
-askp_rsqn52 | 매도호가잔량5 | String | Y | 8 | |
-bidp_rsqn53 | 매수호가잔량5 | String | Y | 8 | |
-total_askp_rsqn | 총매도호가잔량 | String | Y | 8 | |
-total_bidp_rsqn | 총매수호가잔량 | String | Y | 8 |
Example
Request
{
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BJASP0",
"tr_key":"KR103502GD31"
}
}
}
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BJASP0",
"tr_key":"KR103502GD31"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0BJASP0",
"tr_key": "KR103502GD31",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BJASP0|001|KR103502GD31^131743^3.012^3.020^10575.00^10560.00^416090^323813^3.011^3.022^10576.00^10556.00^405284^57^3.010^3.022^10578.0
0^10555.00^177098^500000^3.009^3.024^10580.00^10551.00^97637^363079^3.001^3.025^10597.00^10550.00^80000^379920^1698609^4112382
# output - 정제 후
#### 장내채권 호가 ####
채권종목코드 [KR103502GD31]
영업시간 [131743]
====================================
채권매도호가1 [10575.00], 매도호가수익률1 [3.012], 매도호가잔량1 [416090]
채권매도호가2 [10576.00], 매도호가수익률2 [3.011], 매도호가잔량2 [405284]
채권매도호가3 [10578.00], 매도호가수익률3 [3.010], 매도호가잔량3 [177098]
채권매도호가4 [10580.00], 매도호가수익률4 [3.009], 매도호가잔량4 [97637]
채권매도호가5 [10597.00], 매도호가수익률5 [3.001], 매도호가잔량5 [80000]
채권매수호가1 [10560.00], 매수호가수익률1 [3.020], 매수호가잔량1 [323813]
채권매수호가2 [10556.00], 매수호가수익률2 [3.022], 매수호가잔량2 [57]
채권매수호가3 [10555.00], 매수호가수익률3 [3.022], 매수호가잔량3 [500000]
채권매수호가4 [10551.00], 매수호가수익률4 [3.024], 매수호가잔량4 [363079]
채권매수호가5 [10550.00], 매수호가수익률5 [3.025], 매수호가잔량5 [379920]
====================================
총매도호가잔량 [1698609]
총매수호가잔량 [4112382]
{
"header": {
"tr_id": "H0BJASP0",
"tr_key": "KR103502GD31",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BJASP0|001|KR103502GD31^131743^3.012^3.020^10575.00^10560.00^416090^323813^3.011^3.022^10576.00^10556.00^405284^57^3.010^3.022^10578.0
0^10555.00^177098^500000^3.009^3.024^10580.00^10551.00^97637^363079^3.001^3.025^10597.00^10550.00^80000^379920^1698609^4112382
# output - 정제 후
#### 장내채권 호가 ####
채권종목코드 [KR103502GD31]
영업시간 [131743]
====================================
채권매도호가1 [10575.00], 매도호가수익률1 [3.012], 매도호가잔량1 [416090]
채권매도호가2 [10576.00], 매도호가수익률2 [3.011], 매도호가잔량2 [405284]
채권매도호가3 [10578.00], 매도호가수익률3 [3.010], 매도호가잔량3 [177098]
채권매도호가4 [10580.00], 매도호가수익률4 [3.009], 매도호가잔량4 [97637]
채권매도호가5 [10597.00], 매도호가수익률5 [3.001], 매도호가잔량5 [80000]
채권매수호가1 [10560.00], 매수호가수익률1 [3.020], 매수호가잔량1 [323813]
채권매수호가2 [10556.00], 매수호가수익률2 [3.022], 매수호가잔량2 [57]
채권매수호가3 [10555.00], 매수호가수익률3 [3.022], 매수호가잔량3 [500000]
채권매수호가4 [10551.00], 매수호가수익률4 [3.024], 매수호가잔량4 [363079]
채권매수호가5 [10550.00], 매수호가수익률5 [3.025], 매수호가잔량5 [379920]
====================================
총매도호가잔량 [1698609]
총매수호가잔량 [4112382]
채권지수 실시간체결가 [실시간-060]
WEBSOCKET
채권지수 실시간체결가 [실시간-060]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain미지원
- URL/tryitout/H0BICNT0
- Format
- Content-Type
개요
채권지수 실시간체결가 API입니다.
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
채권 종목코드 마스터파일은 "포럼 > FAQ > 종목정보 다운로드(국내) > 장내채권 - 채권코드" 참고 부탁드립니다.
[호출 데이터]
헤더와 바디 값을 합쳐 JSON 형태로 전송합니다.
[응답 데이터]
1. 정상 등록 여부 (JSON)
- JSON["body"]["msg1"] - 정상 응답 시, SUBSCRIBE SUCCESS
- JSON["body"]["output"]["iv"] - 실시간 결과 복호화에 필요한 AES256 IV (Initialize Vector)
- JSON["body"]["output"]["key"] - 실시간 결과 복호화에 필요한 AES256 Key
2. 실시간 결과 응답 ( | 로 구분되는 값)
ex) 0|H0STCNT0|004|005930^123929^73100^5^...
- 암호화 유무 : 0 암호화 되지 않은 데이터 / 1 암호화된 데이터
- TR_ID : 등록한 tr_id (ex. H0STCNT0)
- 데이터 건수 : (ex. 001 인 경우 데이터 건수 1건, 004인 경우 데이터 건수 4건)
- 응답 데이터 : 아래 response 데이터 참조 ( ^로 구분됨)
LAYOUT
Request
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
tr_id | 거래ID | String | Y | 13 | HH0BICNT0 |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
NMIX_ID | 지수ID | String | Y | 6 | 한경채권지수:
KBPR01 (국고채 종합), KBPR02 (국고채 2~3년), KBPR03 (국고채 3~5년), KBPR04 (F3지수) KIS채권지수: KISR01(KTB지수), MSBI07(MSB 3M 지수), KTBL10(10Y KTB Leverage), , MSBI09(MSB 5M 지수), MSBI10(KSB 단기지수), CDIX01(KIS CD INDEX 지수) 매경채권지수: MKFR01(TB지수), MSBI01(MSB지수), MSBI03(MMK지수), MSBI10(KTB 10Y 지수), CORP01(KOBI CREDIT), |
Response
Header
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
Element | 한글명 | Type | Required | Length | Description |
---|---|---|---|---|---|
rt_cd | 성공 실패 여부 | String | Y | 1 | |
msg_cd | 응답코드 | String | Y | 8 | |
output1 | 응답상세 | Object | Y | ||
msg1 | 응답메세지 | String | Y | 80 | |
-nmix_id | 지수ID | String | Y | 6 | |
-stnd_date1 | 기준일자1 | String | Y | 8 | |
-trnm_hour | 전송시간 | String | Y | 6 | |
-totl_ernn_nmix_oprc | 총수익지수시가지수 | String | Y | 1 | |
-totl_ernn_nmix_hgpr | 총수익지수최고가 | String | Y | 1 | |
-totl_ernn_nmix_lwpr | 총수익지수최저가 | String | Y | 1 | |
-totl_ernn_nmix | 총수익지수 | String | Y | 1 | |
-prdy_totl_ernn_nmix | 전일총수익지수 | String | Y | 1 | |
-totl_ernn_nmix_prdy_vrss | 총수익지수전일대비 | String | Y | 1 | |
-totl_ernn_nmix_prdy_vrss_sign | 총수익지수전일대비부호 | String | Y | 1 | |
-totl_ernn_nmix_prdy_ctrt | 총수익지수전일대비율 | String | Y | 1 | |
-clen_prc_nmix | 순가격지수 | String | Y | 1 | |
-mrkt_prc_nmix | 시장가격지수 | String | Y | 1 | |
-bond_call_rnvs_nmix | Call재투자지수 | String | Y | 1 | |
-bond_zero_rnvs_nmix | Zero재투자지수 | String | Y | 1 | |
-bond_futs_thpr | 선물이론가격 | String | Y | 1 | |
-bond_avrg_drtn_val | 평균듀레이션 | String | Y | 1 | |
-bond_avrg_cnvx_val | 평균컨벡서티 | String | Y | 1 | |
-bond_avrg_ytm_val | 평균YTM | String | Y | 1 | |
-bond_avrg_frdl_ytm_val | 평균선도YTM | String | Y | 1 |
Example
Request
{
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BICNT0",
"tr_key":"KBPR01"
}
}
}
"header":
{
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype":"P",
"tr_type":"1",
"content-type":"utf-8"
},
"body":
{
"input":
{
"tr_id":"H0BICNT0",
"tr_key":"KBPR01"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0BICNT0",
"tr_key": "KBPR01",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BICNT0|001|KBPR01^20240726^131500^163.55^163.56^163.52^163.54^163.53^0.00^2^0.00^98.92^99.50^163.54^161.83^0.00^9.45^181.22^3.07^0.00
# output - 정제 후
#### 채권지수 체결 ####
============================================
### [1 / 1]
지수ID [KBPR01]
기준일자1 [20240726]
전송시간 [131500]
총수익지수시가지수 [163.55]
총수익지수최고가 [163.56]
총수익지수최저가 [163.52]
총수익지수 [163.54]
전일총수익지수 [163.53]
총수익지수전일대비 [0.00]
총수익지수전일대비부호 [2]
총수익지수전일대비율 [0.00]
순가격지수 [98.92]
시장가격지수 [99.50]
Call재투자지수 [163.54]
Zero재투자지수 [161.83]
선물이론가격 [0.00]
평균듀레이션 [9.45]
평균컨벡서티 [181.22]
평균YTM [3.07]
평균선도YTM [0.00]
{
"header": {
"tr_id": "H0BICNT0",
"tr_key": "KBPR01",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output - 정제 전
0|H0BICNT0|001|KBPR01^20240726^131500^163.55^163.56^163.52^163.54^163.53^0.00^2^0.00^98.92^99.50^163.54^161.83^0.00^9.45^181.22^3.07^0.00
# output - 정제 후
#### 채권지수 체결 ####
============================================
### [1 / 1]
지수ID [KBPR01]
기준일자1 [20240726]
전송시간 [131500]
총수익지수시가지수 [163.55]
총수익지수최고가 [163.56]
총수익지수최저가 [163.52]
총수익지수 [163.54]
전일총수익지수 [163.53]
총수익지수전일대비 [0.00]
총수익지수전일대비부호 [2]
총수익지수전일대비율 [0.00]
순가격지수 [98.92]
시장가격지수 [99.50]
Call재투자지수 [163.54]
Zero재투자지수 [161.83]
선물이론가격 [0.00]
평균듀레이션 [9.45]
평균컨벡서티 [181.22]
평균YTM [3.07]
평균선도YTM [0.00]