trex/trex-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add messaging transport rollout

Browse Source
This commit is contained in:
genichin
2026-06-06 00:02:52 +09:00
parent 4b91343ee8
commit 6c7a1cf6f6
383 changed files with 99045 additions and 487 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/broker/kis/websocket/장내채권/실시간시세/335_실시간-052_일반채권-실시간체결가.md
+162
View File
@@ -0,0 +1,162 @@
# 일반채권 실시간체결가
- 원본 시트명: 일반채권 실시간체결가
- API 통신방식: WEBSOCKET
- 메뉴 위치: [장내채권] 실시간시세
- API ID: 실시간-052
- HTTP Method: POST
- 실전 TR_ID: H0BJCNT0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: ws://ops.koreainvestment.com:21000
- 모의 Domain: 모의투자 미지원
- URL 명: /tryitout/H0BJCNT0
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
일반채권 실시간체결가 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 데이터 참조 ( ^로 구분됨)
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
### Request Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| tr_id | 거래ID | string | Y | 2 | H0BJCNT0 |
| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
### Response Header
없음
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| 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 | |
## 예제
### Request Example (Python)
```text
{
"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 Example
```text
# 연결 확인
{
"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]
```
docs/broker/kis/websocket/장내채권/실시간시세/336_실시간-053_일반채권-실시간호가.md
+172
View File
@@ -0,0 +1,172 @@
# 일반채권 실시간호가
- 원본 시트명: 일반채권 실시간호가
- API 통신방식: WEBSOCKET
- 메뉴 위치: [장내채권] 실시간시세
- API ID: 실시간-053
- HTTP Method: POST
- 실전 TR_ID: H0BJCNT0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: ws://ops.koreainvestment.com:21000
- 모의 Domain: 모의투자 미지원
- URL 명: /tryitout/H0BJASP0
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
일반채권 실시간호가 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 데이터 참조 ( ^로 구분됨)
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
| custtype | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
### Request Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| tr_id | 거래ID | string | Y | 2 | H0BJCNT0 |
| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
### Response Header
없음
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| 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 | |
## 예제
### Request Example (Python)
```text
{
"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 Example
```text
# 연결 확인
{
"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]
```
docs/broker/kis/websocket/장내채권/실시간시세/337_실시간-060_채권지수-실시간체결가.md
+163
View File
@@ -0,0 +1,163 @@
# 채권지수 실시간체결가
- 원본 시트명: 채권지수 실시간체결가
- API 통신방식: WEBSOCKET
- 메뉴 위치: [장내채권] 실시간시세
- API ID: 실시간-060
- HTTP Method: POST
- 실전 TR_ID: H0BICNT0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: ws://ops.koreainvestment.com:21000
- 모의 Domain: 모의투자 미지원
- URL 명: /tryitout/H0BICNT0
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
채권지수 실시간체결가 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 데이터 참조 ( ^로 구분됨)
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| approval_key | 웹소켓 접속키 | string | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | string | Y | 1 | 1: 등록, 2:해제 |
| content-type | 컨텐츠타입 | string | Y | 20 | utf-8 |
### Request Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| tr_id | 거래ID | string | Y | 2 | H0BICNT0 |
| tr_key | 구분값 | string | Y | 12 | 채권 종목코드 (ex. KR103502GA34) |
### Response Header
없음
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| 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 | |
## 예제
### Request Example (Python)
```text
{
"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 Example
```text
# 연결 확인
{
"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]
```