KIS Developers menu

API 문서 HOME API 문서 [국내주식] 주문/계좌


[국내주식] 주문/계좌

주식주문(현금)[v1_국내주식-001]

REST

주식주문(현금)[v1_국내주식-001]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-stock/v1/trading/order-cash
  • Format
    JSON
  • Content-Type
    application/json; charset=UTF-8

개요

국내주식주문(현금) API 입니다.

※ TTC0802U(현금매수) 사용하셔서 미수매수 가능합니다. 단, 거래하시는 계좌가 증거금40%계좌로 신청이 되어있어야 가능합니다.
※ 신용매수는 별도의 API가 준비되어 있습니다.

※ ORD_QTY(주문수량), ORD_UNPR(주문단가) 등을 String으로 전달해야 함에 유의 부탁드립니다.

※ ORD_UNPR(주문단가)가 없는 주문은 상한가로 주문금액을 선정하고 이후 체결이되면 체결금액로 정산됩니다.

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

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

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 '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
국내주식주문 매도 : (구)TTTC0801U → (신)TTTC0011U
국내주식주문 매도(모의투자) : (구)VTTC0801U → (신)VTTC0011U
국내주식주문 매수 : (구)TTTC0802U → (신)TTTC0012U
국내주식주문 매수(모의투자) : (구)VTTC0802U → (신)VTTC0012U'
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
CANO 종합계좌번호 String Y 8 종합계좌번호
ACNT_PRDT_CD 계좌상품코드 String Y 2 상품유형코드
PDNO 상품번호 String Y 12 종목코드(6자리)
SLL_TYPE 매도유형 (매도주문 시) String N 2 01@일반매도
02@임의매매
05@대차매도
→ 미입력시 01 일반매도로 진행
ORD_DVSN 주문구분 String Y 2 00@지정가
01@시장가
02@조건부지정가
03@최유리지정가
04@최우선지정가
05@장전 시간외
06@장후 시간외
07@시간외 단일가
65@경매매
08@자기주식
09@자기주식S-Option
10@자기주식금전신탁
11@IOC지정가 (즉시체결,잔량취소)
12@FOK지정가 (즉시체결,전량취소)
13@IOC시장가 (즉시체결,잔량취소)
14@FOK시장가 (즉시체결,전량취소)
15@IOC최유리 (즉시체결,잔량취소)
16@FOK최유리 (즉시체결,전량취소)
51@장중대량
52@장중바스켓
62@장개시전 시간외대량
63@장개시전 시간외바스켓
67@장개시전 금전신탁자사주
69@장개시전 자기주식
72@시간외대량
77@시간외자사주신탁
79@시간외대량자기주식
80@바스켓
21@중간가
22@스톱지정가
23@중간가IOC
24@중간가FOK
ORD_QTY 주문수량 String Y 10 주문수량
ORD_UNPR 주문단가 String Y 19 주문단가
CNDT_PRIC 조건가격 String N 19 스탑지정가호가 주문 (ORD_DVSN이 22) 사용 시에만 필수
EXCG_ID_DVSN_CD 거래소ID구분코드 String N 3 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT
→ 미입력시 KRX로 진행

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
msg1 응답메세지 String Y 80
output 응답상세 Object Array Y single
-krx_fwdg_ord_orgno 거래소코드 String Y 5
-odno 주문번호 String Y 10
-ord_tmd 주문시간 String Y 6

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"PDNO": "009150",
"ORD_DVSN": "00",
"ORD_QTY": "3",
"ORD_UNPR": "150000"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "KRX_FWDG_ORD_ORGNO": "06010",
    "ODNO": "0001569157",
    "ORD_TMD": "155211"
  }
}

주식주문(신용)[v1_국내주식-002]

REST

주식주문(신용)[v1_국내주식-002]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/order-credit
  • Format
    JSON
  • Content-Type
    application/json; charset=UTF-8

개요

국내주식주문(신용) API입니다.
※ 모의투자는 사용 불가합니다.

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

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 '※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
매도 : (구)TTTC0851U → (신)TTTC0051U
매수 : (구)TTTC0852U → (신)TTTC0052U
'
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
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PDNO 상품번호 String Y 5 종목코드(6자리)
SLL_TYPE 매도유형 String N 10 공란 입력
CRDT_TYPE 신용유형 String Y 2 [매도] 22 : 유통대주신규, 24 : 자기대주신규, 25 : 자기융자상환, 27 : 유통융자상환
[매수] 21 : 자기융자신규, 23 : 유통융자신규 , 26 : 유통대주상환, 28 : 자기대주상환
LOAN_DT 대출일자 String Y 2 [신용매수]
신규 대출로, 오늘날짜(yyyyMMdd)) 입력

[신용매도]
매도할 종목의 대출일자(yyyyMMdd)) 입력
ORD_DVSN 주문구분 String Y 8 00@지정가
01@시장가
02@조건부지정가
03@최유리지정가
04@최우선지정가
05@장전 시간외
06@장후 시간외
07@시간외 단일가
65@경매매
08@자기주식
09@자기주식S-Option
10@자기주식금전신탁
11@IOC지정가 (즉시체결,잔량취소)
12@FOK지정가 (즉시체결,전량취소)
13@IOC시장가 (즉시체결,잔량취소)
14@FOK시장가 (즉시체결,전량취소)
15@IOC최유리 (즉시체결,잔량취소)
16@FOK최유리 (즉시체결,전량취소)
51@장중대량
52@장중바스켓
62@장개시전 시간외대량
63@장개시전 시간외바스켓
67@장개시전 금전신탁자사주
69@장개시전 자기주식
72@시간외대량
77@시간외자사주신탁
79@시간외대량자기주식
80@바스켓
21@중간가
22@스톱지정가
23@중간가IOC
24@중간가FOK
ORD_QTY 주문수량 String Y 2
ORD_UNPR 주문단가 String Y 5 1주당 가격
* 장전 시간외, 장후 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고
RSVN_ORD_YN 예약주문여부 String Y 2 정규 증권시장이 열리지 않는 시간 (15:10분 ~ 익일 7:30분) 에 주문을 미리 설정 하여 다음 영업일 또는 설정한 기간 동안 아침 동시 호가에 주문하는 것
Y : 예약주문
N : 신용주문
EMGC_ORD_YN 비상주문여부 String Y 2
PGTR_DVSN 프로그램매매구분 String Y 10
MGCO_APTM_ODNO 운용사지정주문번호 String Y 19
LQTY_TR_NGTN_DTL_NO 대량거래협상상세번호 String Y 1
LQTY_TR_AGMT_NO 대량거래협정번호 String Y 20
LQTY_TR_NGTN_ID 대량거래협상자Id String Y 19
LP_ORD_YN LP주문여부 String Y 3
MDIA_ODNO 매체주문번호 String Y 10
ORD_SVR_DVSN_CD 주문서버구분코드 String Y 19
PGM_NMPR_STMT_DVSN_CD 프로그램호가신고구분코드 String Y 1
CVRG_SLCT_RSON_CD 반대매매선정사유코드 String Y 20
CVRG_SEQ 반대매매순번 String Y 19
EXCG_ID_DVSN_CD 거래소ID구분코드 String Y 3 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT
CNDT_PRIC 조건가격 String Y 19 스탑지정가호가에서 사용

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
msg1 응답메세지 String Y 80
output 응답상세 Object Array Y single
-krx_fwdg_ord_orgno 한국거래소전송주문조직번호 String Y 5
-odno 주문번호 String Y 10
-ord_tmd 주문시간 String Y 6

Example

Request

{
    "CANO": "810XXXXX",
    "ACNT_PRDT_CD": "01",
    "PDNO": "009150",
    "CRDT_TYPE": "21",
    "LOAN_DT": "20211103",
    "ORD_DVSN": "00",
    "ORD_QTY": "1",
    "ORD_UNPR": "130000",
    "RSVN_ORD_YN": "N"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "KRX_FWDG_ORD_ORGNO": "06010",
    "ODNO": "0001569138",
    "ORD_TMD": "131421"
  }
}

주식주문(정정취소)[v1_국내주식-003]

REST

주식주문(정정취소)[v1_국내주식-003]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-stock/v1/trading/order-rvsecncl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

주문 건에 대하여 정정 및 취소하는 API입니다. 단, 이미 체결된 건은 정정 및 취소가 불가합니다.

※ 정정은 원주문에 대한 주문단가 혹은 주문구분을 변경하는 사항으로, 정정이 가능한 수량은 원주문수량을 초과 할 수 없습니다.

※ 주식주문(정정취소) 호출 전에 반드시 주식정정취소가능주문조회 호출을 통해 정정취소가능수량(output > psbl_qty)을 확인하신 후 정정취소주문 내시기 바랍니다.

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

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 ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
정정/취소 (구)TTTC0803U → (신)TTTC0013U
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
CANO 종합계좌번호 String Y 8 종합계좌번호
ACNT_PRDT_CD 계좌상품코드 String Y 2 상품유형코드
KRX_FWDG_ORD_ORGNO 한국거래소전송주문조직번호 String Y 5
ORGN_ODNO 원주문번호 String Y 10 원주문번호
ORD_DVSN 주문구분 String Y 2 00@지정가
01@시장가
02@조건부지정가
03@최유리지정가
04@최우선지정가
05@장전 시간외
06@장후 시간외
07@시간외 단일가
65@경매매
08@자기주식
09@자기주식S-Option
10@자기주식금전신탁
11@IOC지정가 (즉시체결,잔량취소)
12@FOK지정가 (즉시체결,전량취소)
13@IOC시장가 (즉시체결,잔량취소)
14@FOK시장가 (즉시체결,전량취소)
15@IOC최유리 (즉시체결,잔량취소)
16@FOK최유리 (즉시체결,전량취소)
51@장중대량
52@장중바스켓
62@장개시전 시간외대량
63@장개시전 시간외바스켓
67@장개시전 금전신탁자사주
69@장개시전 자기주식
72@시간외대량
77@시간외자사주신탁
79@시간외대량자기주식
80@바스켓
21@중간가
22@스톱지정가
23@중간가IOC
24@중간가FOK
RVSE_CNCL_DVSN_CD 정정취소구분코드 String Y 2 01@정정
02@취소
ORD_QTY 주문수량 String Y 10 주문수량
ORD_UNPR 주문단가 String Y 19 주문단가
QTY_ALL_ORD_YN 잔량전부주문여부 String Y 1 'Y@전량
N@일부'
CNDT_PRIC 조건가격 String Y 19 스탑지정가호가에서 사용
EXCG_ID_DVSN_CD 거래소ID구분코드 String Y 3 한국거래소 : KRX
대체거래소 (넥스트레이드) : NXT

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
msg1 응답메세지 String Y 80
output 응답상세 Object Array Y single
-krx_fwdg_ord_orgno 한국거래소전송주문조직번호 String Y 5
-odno 주문번호 String Y 10
-ord_tmd 주문시각 String Y 6

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"KRX_FWDG_ORD_ORGNO": "",
"ORGN_ODNO": "0001566017",
"ORD_DVSN": "00",
"RVSE_CNCL_DVSN_CD": "01",
"ORD_QTY": "1",
"ORD_UNPR": "180000",
"QTY_ALL_ORD_YN": "N"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "KRX_FWDG_ORD_ORGNO": "06010",
    "ODNO": "0001569139",
    "ORD_TMD": "131438"
  }
}

주식정정취소가능주문조회[v1_국내주식-004]

REST

주식정정취소가능주문조회[v1_국내주식-004]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/inquire-psbl-rvsecncl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

주식정정취소가능주문조회 API입니다. 한 번의 호출에 최대 50건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

※ 주식주문(정정취소) 호출 전에 반드시 주식정정취소가능주문조회 호출을 통해 정정취소가능수량(output > psbl_qty)을 확인하신 후 정정취소주문 내시기 바랍니다.

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 ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
(구)TTTC8036R → (신)TTTC0084R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
CTX_AREA_FK100 연속조회검색조건100 String Y 100 '공란 : 최초 조회시는
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)'
CTX_AREA_NK100 연속조회키100 String Y 100 '공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)'
INQR_DVSN_1 조회구분1 String Y 1 '0 주문
1 종목'
INQR_DVSN_2 조회구분2 String Y 1 '0 전체
1 매도
2 매수'

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
msg1 응답메세지 String Y 80
output 응답상세 Object Array Y array
-ord_gno_brno 주문채번지점번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
-odno 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
-orgn_odno 원주문번호 String Y 6 정정/취소주문 인경우 원주문번호
-ord_dvsn_name 주문구분명 String Y 5
-pdno 상품번호 String Y 10 종목번호(뒤 6자리만 해당)
-prdt_name 상품명 String Y 6 종목명
-rvse_cncl_dvsn_name 정정취소구분명 String Y 5 정정 또는 취소 여부 표시
-ord_qty 주문수량 String Y 10
-ord_unpr 주문단가 String Y 6 1주당 주문가격
-ord_tmd 주문시각 String Y 5 주문시각(시분초HHMMSS)
-tot_ccld_qty 총체결수량 String Y 10 주문 수량 중 체결된 수량
-tot_ccld_amt 총체결금액 String Y 6 주문금액 중 체결금액
-psbl_qty 가능수량 String Y 5 정정/취소 주문 가능 수량
-sll_buy_dvsn_cd 매도매수구분코드 String Y 10 01 : 매도 / 02 : 매수
-ord_dvsn_cd 주문구분코드 String Y 6 00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
08 : 자기주식
09 : 자기주식S-Option
10 : 자기주식금전신탁
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
51 : 장중대량
-mgco_aptm_odno 운용사지정주문번호 String Y 5
-excg_dvsn_cd 거래소구분코드 String Y 2
-excg_id_dvsn_cd 거래소ID구분코드 String Y 3
-excg_id_dvsn_name 거래소ID구분명 String Y 100
-stpm_cndt_pric 스톱지정가조건가격 String Y 9
-stpm_efct_occr_yn 스톱지정가효력발생여부 String Y 1

Example

Request

{
"ACNT_PRDT_CD": "01",
"CANO": "810XXXXX",
"CTX_AREA_FK100": "",
"CTX_AREA_NK100": "",
"INQR_DVSN_1": "0",
"INQR_DVSN_2": "0"
}

Response

{
  "ctx_area_fk100": "81055689^01^                                                                                        ",
  "ctx_area_nk100": "                                                                                                    ",
  "output": [
    {
      "ord_gno_brno": "06010",
      "odno": "0001569139",
      "orgn_odno": "0001569136",
      "ord_dvsn_name": "지정가",
      "pdno": "009150",
      "prdt_name": "SamsungElecMech",
      "rvse_cncl_dvsn_name": "BUY AMEND*",
      "ord_qty": "1",
      "ord_unpr": "140000",
      "ord_tmd": "131438",
      "tot_ccld_qty": "0",
      "tot_ccld_amt": "0",
      "psbl_qty": "1",
      "sll_buy_dvsn_cd": "02",
      "ord_dvsn_cd": "00",
      "mgco_aptm_odno": ""
    },
    {
      "ord_gno_brno": "06010",
      "odno": "0001569138",
      "orgn_odno": "",
      "ord_dvsn_name": "지정가",
      "pdno": "009150",
      "prdt_name": "SamsungElecMech",
      "rvse_cncl_dvsn_name": "",
      "ord_qty": "1",
      "ord_unpr": "200000",
      "ord_tmd": "131421",
      "tot_ccld_qty": "0",
      "tot_ccld_amt": "0",
      "psbl_qty": "1",
      "sll_buy_dvsn_cd": "02",
      "ord_dvsn_cd": "00",
      "mgco_aptm_odno": ""
    }
],
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

주식일별주문체결조회[v1_국내주식-005]

REST

주식일별주문체결조회[v1_국내주식-005]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-stock/v1/trading/inquire-daily-ccld
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

주식일별주문체결조회 API입니다.
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 15건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

* 다만, 3개월 이전 체결내역 조회(CTSC9115R) 의 경우,
장중에는 많은 거래량으로 인해 순간적으로 DB가 밀렸거나 응답을 늦게 받거나 하는 등의 이슈가 있을 수 있어
① 가급적 장 종료 이후(15:30 이후) 조회하시고
② 조회기간(INQR_STRT_DT와 INQR_END_DT 사이의 간격)을 보다 짧게 해서 조회하는 것을
권유드립니다.

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 ※ 구TR은 사전고지 없이 막힐 수 있으므로 반드시 신TR로 변경이용 부탁드립니다.
[실전투자]
3개월이내 (구)TTTC8001R → (신)TTTC0081R
3개월이전 (구)CTSC9115R → (신)CTSC9215R'
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
INQR_STRT_DT 조회시작일자 String Y 8 YYYYMMDD
INQR_END_DT 조회종료일자 String Y 8 YYYYMMDD
SLL_BUY_DVSN_CD 매도매수구분코드 String Y 2 00 : 전체 / 01 : 매도 / 02 : 매수
PDNO 상품번호 String Y 12 종목번호(6자리)
ORD_GNO_BRNO 주문채번지점번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
ODNO 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
CCLD_DVSN 체결구분 String Y 2 '00 전체
01 체결
02 미체결'
INQR_DVSN 조회구분 String Y 2 '00 역순
01 정순'
INQR_DVSN_1 조회구분1 String Y 1 '없음: 전체
1: ELW
2: 프리보드'
INQR_DVSN_3 조회구분3 String Y 2 '00 전체
01 현금
02 신용
03 담보
04 대주
05 대여
06 자기융자신규/상환
07 유통융자신규/상환'
EXCG_ID_DVSN_CD 거래소ID구분코드 String Y 3 KRX : KRX NXT : NXT
CTX_AREA_FK100 연속조회검색조건100 String Y 100 '공란 : 최초 조회시는
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)'
CTX_AREA_NK100 연속조회키100 String Y 100 '공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)'

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Array Y array
-ord_dt 주문일자 String Y 8
-ord_gno_brno 주문채번지점번호 String Y 5
-odno 주문번호 String Y 10
-orgn_odno 원주문번호 String Y 10
-ord_dvsn_name 주문구분명 String Y 60
-sll_buy_dvsn_cd 매도매수구분코드 String Y 2
-sll_buy_dvsn_cd_name 매도매수구분코드명 String Y 60
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-ord_qty 주문수량 String Y 10
-ord_unpr 주문단가 String Y 19
-ord_tmd 주문시각 String Y 6
-tot_ccld_qty 총체결수량 String Y 10
-avg_prvs 평균가 String Y 19
-cncl_yn 취소여부 String Y 1
-tot_ccld_amt 총체결금액 String Y 19
-loan_dt 대출일자 String Y 8
-ordr_empno 주문자사번 String Y 60
-ord_dvsn_cd 주문구분코드 String Y 2
-cnc_cfrm_qty 취소확인수량 String Y 10
-rmn_qty 잔여수량 String Y 10
-rjct_qty 거부수량 String Y 10
-ccld_cndt_name 체결조건명 String Y 10
-inqr_ip_addr 조회IP주소 String Y 15
-cpbc_ordp_ord_rcit_dvsn_cd 전산주문표주문접수구분코드 String Y 2
-cpbc_ordp_infm_mthd_dvsn_cd 전산주문표통보방법구분코드 String Y 2
-infm_tmd 통보시각 String Y 6
-ctac_tlno 연락전화번호 String Y 20
-prdt_type_cd 상품유형코드 String Y 3
-excg_dvsn_cd 거래소구분코드 String Y 2
-cpbc_ordp_mtrl_dvsn_cd 전산주문표자료구분코드 String Y 2
-ord_orgno 주문조직번호 String Y 5
-rsvn_ord_end_dt 예약주문종료일자 String Y 8
-excg_id_dvsn_Cd 거래소ID구분코드 String Y 3
-stpm_cndt_pric 스톱지정가조건가격 String Y 9
-stpm_efct_occr_dtmd 스톱지정가효력발생상세시각 String Y 9
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output2 응답상세 Object Y single
-tot_ord_qty 총주문수량 String Y 10
-tot_ccld_qty 총체결수량 String Y 10
-tot_ccld_amt 매입평균가격 String Y 19
-prsm_tlex_smtl 총체결금액 String Y 19
-pchs_avg_pric 추정제비용합계 String Y 184

Example

Request

{
"CANO": "12345678",
"ACNT_PRDT_CD": "01",
"INQR_STRT_DT": "20211101",
"INQR_END_DT": "20211101",
"SLL_BUY_DVSN_CD": "00",
"INQR_DVSN": "00",
"PDNO": "",
"CCLD_DVSN": "00",
"ORD_GNO_BRNO": "",
"ODNO": "",
"INQR_DVSN_3": "00",
"INQR_DVSN_1": "",
"CTX_AREA_FK100": "",
"CTX_AREA_NK100": ""
}

Response

{
  "ctx_area_fk100": "12345678^01^20220103^20220103^ ^00^00^                                                              ",
  "ctx_area_nk100": "                                                                                                    ",
  "output1": [
    {
      "ord_dt": "20220103",
      "ord_gno_brno": "06010",
      "odno": "0001568197",
      "orgn_odno": "",
      "ord_dvsn_name": "Limit",
      "sll_buy_dvsn_cd": "02",
      "sll_buy_dvsn_cd_name": "BUY REJECT",
      "pdno": "009150",
      "prdt_name": "삼성전기",
      "ord_qty": "10",
      "ord_unpr": "150000",
      "ord_tmd": "170100",
      "tot_ccld_qty": "0",
      "avg_prvs": "0",
      "cncl_yn": "",
      "tot_ccld_amt": "0",
      "loan_dt": "",
      "ordr_empno": "Nsmart",
      "ord_dvsn_cd": "00",
      "cncl_cfrm_qty": "0",
      "rmn_qty": "0",
      "rjct_qty": "10",
      "ccld_cndt_name": "None",
      "inqr_ip_addr": "...",
      "cpbc_ordp_ord_rcit_dvsn_cd": "",
      "cpbc_ordp_infm_mthd_dvsn_cd": "",
      "infm_tmd": "",
      "ctac_tlno": "01047859775",
      "prdt_type_cd": "300",
      "excg_dvsn_cd": "02",
      "cpbc_ordp_mtrl_dvsn_cd": "11",
      "ord_orgno": "00000",
      "rsvn_ord_end_dt": ""
    },
    {
      "ord_dt": "20220103",
      "ord_gno_brno": "06010",
      "odno": "0001568196",
      "orgn_odno": "",
      "ord_dvsn_name": "Limit",
      "sll_buy_dvsn_cd": "02",
      "sll_buy_dvsn_cd_name": "BUY REJECT",
      "pdno": "009150",
      "prdt_name": "삼성전기",
      "ord_qty": "10",
      "ord_unpr": "150000",
      "ord_tmd": "170038",
      "tot_ccld_qty": "0",
      "avg_prvs": "0",
      "cncl_yn": "",
      "tot_ccld_amt": "0",
      "loan_dt": "",
      "ordr_empno": "Nsmart",
      "ord_dvsn_cd": "00",
      "cncl_cfrm_qty": "0",
      "rmn_qty": "0",
      "rjct_qty": "10",
      "ccld_cndt_name": "None",
      "inqr_ip_addr": "P01.012.345.678",
      "cpbc_ordp_ord_rcit_dvsn_cd": "",
      "cpbc_ordp_infm_mthd_dvsn_cd": "",
      "infm_tmd": "",
      "ctac_tlno": "01047859775",
      "prdt_type_cd": "300",
      "excg_dvsn_cd": "02",
      "cpbc_ordp_mtrl_dvsn_cd": "11",
      "ord_orgno": "00000",
      "rsvn_ord_end_dt": ""
}
],
  "output2": {
    "tot_ord_qty": "281",
    "tot_ccld_qty": "0",
    "tot_ccld_amt": "0",
    "prsm_tlex_smtl": "0",
    "pchs_avg_pric": "0.0000"
  },
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

주식잔고조회[v1_국내주식-006]

REST

주식잔고조회[v1_국내주식-006]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-stock/v1/trading/inquire-balance
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

주식 잔고조회 API입니다.
실전계좌의 경우, 한 번의 호출에 최대 50건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

* 당일 전량매도한 잔고도 보유수량 0으로 보여질 수 있으나, 해당 보유수량 0인 잔고는 최종 D-2일 이후에는 잔고에서 사라집니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 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 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTC8434R : 주식 잔고 조회

[모의투자]
VTTC8434R : 주식 잔고 조회
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
AFHR_FLPR_YN 시간외단일가, 거래소여부 String Y 1 N : 기본값,
Y : 시간외단일가,
X : NXT 정규장 (프리마켓, 메인, 애프터마켓)
※ NXT 선택 시 : NXT 거래종목만 시세 등 정보가 NXT 기준으로 변동됩니다. KRX 종목들은 그대로 유지
OFL_YN 오프라인여부 String Y 1 공란(Default)
INQR_DVSN 조회구분 String Y 2 01 : 대출일별
02 : 종목별
UNPR_DVSN 단가구분 String Y 2 01 : 기본값
FUND_STTL_ICLD_YN 펀드결제분포함여부 String Y 1 N : 포함하지 않음
Y : 포함
FNCG_AMT_AUTO_RDPT_YN 융자금액자동상환여부 String Y 1 N : 기본값
PRCS_DVSN 처리구분 String Y 2 00 : 전일매매포함
01 : 전일매매미포함
CTX_AREA_FK100 연속조회검색조건100 String Y 100 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)
CTX_AREA_NK100 연속조회키100 String Y 100 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)

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 Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
ctx_area_fk100 연속조회검색조건100 String Y 100
ctx_area_nk100 연속조회키100 String Y 100
output1 응답상세1 Object Array Y Array
-pdno 상품번호 String Y 12 종목번호(뒷 6자리)
-prdt_name 상품명 String Y 60 종목명
-trad_dvsn_name 매매구분명 String Y 60 매수매도구분
-bfdy_buy_qty 전일매수수량 String Y 10
-bfdy_sll_qty 전일매도수량 String Y 10
-thdt_buyqty 금일매수수량 String Y 10
-thdt_sll_qty 금일매도수량 String Y 10
-hldg_qty 보유수량 String Y 19
-ord_psbl_qty 주문가능수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 22 매입금액 / 보유수량
-pchs_amt 매입금액 String Y 19
-prpr 현재가 String Y 19
-evlu_amt 평가금액 String Y 19
-evlu_pfls_amt 평가손익금액 String Y 19 평가금액 - 매입금액
-evlu_pfls_rt 평가손익율 String Y 9
-evlu_erng_rt 평가수익율 String Y 31 미사용항목(0으로 출력)
-loan_dt 대출일자 String Y 8 INQR_DVSN(조회구분)을 01(대출일별)로 설정해야 값이 나옴
-loan_amt 대출금액 String Y 19
-stln_slng_chgs 대주매각대금 String Y 19
-expd_dt 만기일자 String Y 8
-fltt_rt 등락율 String Y 31
-bfdy_cprs_icdc 전일대비증감 String Y 19
-item_mgna_rt_name 종목증거금율명 String Y 20
-grta_rt_name 보증금율명 String Y 20
-sbst_pric 대용가격 String Y 19 증권매매의 위탁보증금으로서 현금 대신에 사용되는 유가증권 가격
-stck_loan_unpr 주식대출단가 String Y 22
output2 응답상세2 Object Array Y Array
-dnca_tot_amt 예수금총금액 String Y 19 예수금
-nxdy_excc_amt 익일정산금액 String Y 19 D+1 예수금
-prvs_rcdl_excc_amt 가수도정산금액 String Y 19 D+2 예수금
-cma_evlu_amt CMA평가금액 String Y 19
-bfdy_buy_amt 전일매수금액 String Y 19
-thdt_buy_amt 금일매수금액 String Y 19
-nxdy_auto_rdpt_amt 익일자동상환금액 String Y 19
-bfdy_sll_amt 전일매도금액 String Y 19
-thdt_sll_amt 금일매도금액 String Y 19
-d2_auto_rdpt_amt D+2자동상환금액 String Y 19
-bfdy_tlex_amt 전일제비용금액 String Y 19
-thdt_tlex_amt 금일제비용금액 String Y 19
-tot_loan_amt 총대출금액 String Y 19
-scts_evlu_amt 유가평가금액 String Y 19
-tot_evlu_amt 총평가금액 String Y 19 유가증권 평가금액 합계금액 + D+2 예수금
-nass_amt 순자산금액 String Y 19
-fncg_gld_auto_rdpt_yn 융자금자동상환여부 String Y 1 보유현금에 대한 융자금만 차감여부
신용융자 매수체결 시점에서는 융자비율을 매매대금 100%로 계산 하였다가 수도결제일에 보증금에 해당하는 금액을 고객의 현금으로 충당하여 융자금을 감소시키는 업무
-pchs_amt_smtl_amt 매입금액합계금액 String Y 19
-evlu_amt_smtl_amt 평가금액합계금액 String Y 19 유가증권 평가금액 합계금액
-evlu_pfls_smtl_amt 평가손익합계금액 String Y 19
-tot_stln_slng_chgs 총대주매각대금 String Y 19
-bfdy_tot_asst_evlu_amt 전일총자산평가금액 String Y 19
-asst_icdc_amt 자산증감액 String Y 19
-asst_icdc_erng_rt 자산증감수익율 String Y 31 데이터 미제공

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"AFHR_FLPR_YN": "N",
"OFL_YN": "",
"INQR_DVSN": "01",
"UNPR_DVSN": "01",
"FUND_STTL_ICLD_YN": "N",
"FNCG_AMT_AUTO_RDPT_YN": "N",
"PRCS_DVSN": "01",
"CTX_AREA_FK100": "",
"CTX_AREA_NK100": ""
}

Response

{
  "ctx_area_fk100": "81055689^01^N^N^01^01^N^                                                                            ",
  "ctx_area_nk100": "                                                                                                    ",
  "output1": [
    {
      "pdno": "009150",
      "prdt_name": "삼성전기",
      "trad_dvsn_name": "현금",
      "bfdy_buy_qty": "12",
      "bfdy_sll_qty": "0",
      "thdt_buyqty": "1686",
      "thdt_sll_qty": "41",
      "hldg_qty": "1657",
      "ord_psbl_qty": "1611",
      "pchs_avg_pric": "135440.2517",
      "pchs_amt": "224424497",
      "prpr": "0",
      "evlu_amt": "0",
      "evlu_pfls_amt": "0",
      "evlu_pfls_rt": "0.00",
      "evlu_erng_rt": "0.00000000",
      "loan_dt": "",
      "loan_amt": "0",
      "stln_slng_chgs": "0",
      "expd_dt": "",
      "fltt_rt": "-100.00000000",
      "bfdy_cprs_icdc": "-184500",
      "item_mgna_rt_name": "",
      "grta_rt_name": "",
      "sbst_pric": "140220",
      "stck_loan_unpr": "0.0000"
    },
    {
      "pdno": "009150",
      "prdt_name": "삼성전기",
      "trad_dvsn_name": "자기융자",
      "bfdy_buy_qty": "3",
      "bfdy_sll_qty": "0",
      "thdt_buyqty": "0",
      "thdt_sll_qty": "0",
      "hldg_qty": "3",
      "ord_psbl_qty": "3",
      "pchs_avg_pric": "123000.0000",
      "pchs_amt": "369000",
      "prpr": "0",
      "evlu_amt": "0",
      "evlu_pfls_amt": "0",
      "evlu_pfls_rt": "0.00",
      "evlu_erng_rt": "0.00000000",
      "loan_dt": "20211223",
      "loan_amt": "369000",
      "stln_slng_chgs": "0",
      "expd_dt": "",
      "fltt_rt": "-100.00000000",
      "bfdy_cprs_icdc": "-184500",
      "item_mgna_rt_name": "",
      "grta_rt_name": "",
      "sbst_pric": "140220",
      "stck_loan_unpr": "123000.0000"
    }
  ],
  "output2": [
        {
            "dnca_tot_amt": "346455",
            "nxdy_excc_amt": "346455",
            "prvs_rcdl_excc_amt": "346455",
            "cma_evlu_amt": "0",
            "bfdy_buy_amt": "0",
            "thdt_buy_amt": "0",
            "nxdy_auto_rdpt_amt": "0",
            "bfdy_sll_amt": "0",
            "thdt_sll_amt": "0",
            "d2_auto_rdpt_amt": "0",
            "bfdy_tlex_amt": "0",
            "thdt_tlex_amt": "0",
            "tot_loan_amt": "0",
            "scts_evlu_amt": "1759600",
            "tot_evlu_amt": "2106055",
            "nass_amt": "2106055",
            "fncg_gld_auto_rdpt_yn": "",
            "pchs_amt_smtl_amt": "2516522",
            "evlu_amt_smtl_amt": "1759600",
            "evlu_pfls_smtl_amt": "-756922",
            "tot_stln_slng_chgs": "0",
            "bfdy_tot_asst_evlu_amt": "2142945",
            "asst_icdc_amt": "-36890",
            "asst_icdc_erng_rt": "0.00000000"
        }
    ],
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

매수가능조회[v1_국내주식-007]

REST

매수가능조회[v1_국내주식-007]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/domestic-stock/v1/trading/inquire-psbl-order
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

매수가능 조회 API입니다.
실전계좌/모의계좌의 경우, 한 번의 호출에 최대 1건까지 확인 가능합니다.


1) 매수가능금액 확인
. 미수 사용 X: nrcvb_buy_amt(미수없는매수금액) 확인
. 미수 사용 O: max_buy_amt(최대매수금액) 확인


2) 매수가능수량 확인
. 특정 종목 전량매수 시 가능수량을 확인하실 경우 ORD_DVSN:00(지정가)는 종목증거금율이 반영되지 않습니다.
따라서 "반드시" ORD_DVSN:01(시장가)로 지정하여 종목증거금율이 반영된 가능수량을 확인하시기 바랍니다.

(다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력하여 가능수량 확인)

. 미수 사용 X: ORD_DVSN:01(시장가) or 특정 주문구분(ex.IOC)로 지정하여 nrcvb_buy_qty(미수없는매수수량) 확인
. 미수 사용 O: ORD_DVSN:01(시장가) or 특정 주문구분(ex.IOC)로 지정하여 max_buy_qty(최대매수수량) 확인

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 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 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTC8908R : 매수 가능 조회

[모의투자]
VTTC8908R : 매수 가능 조회
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PDNO 상품번호 String Y 12 종목번호(6자리)
* PDNO, ORD_UNPR 공란 입력 시, 매수수량 없이 매수금액만 조회됨
ORD_UNPR 주문단가 String Y 19 1주당 가격
* 시장가(ORD_DVSN:01)로 조회 시, 공란으로 입력
* PDNO, ORD_UNPR 공란 입력 시, 매수수량 없이 매수금액만 조회됨
ORD_DVSN 주문구분 String Y 2 * 특정 종목 전량매수 시 가능수량을 확인할 경우
00:지정가는 증거금율이 반영되지 않으므로
증거금율이 반영되는 01: 시장가로 조회
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력하여 가능수량 확인
* 종목별 매수가능수량 조회 없이 매수금액만 조회하고자 할 경우 임의값(00) 입력
00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가
08 : 자기주식
09 : 자기주식S-Option
10 : 자기주식금전신탁
11 : IOC지정가 (즉시체결,잔량취소)
12 : FOK지정가 (즉시체결,전량취소)
13 : IOC시장가 (즉시체결,잔량취소)
14 : FOK시장가 (즉시체결,전량취소)
15 : IOC최유리 (즉시체결,잔량취소)
16 : FOK최유리 (즉시체결,전량취소)
51 : 장중대량
52 : 장중바스켓
62 : 장개시전 시간외대량
63 : 장개시전 시간외바스켓
67 : 장개시전 금전신탁자사주
69 : 장개시전 자기주식
72 : 시간외대량
77 : 시간외자사주신탁
79 : 시간외대량자기주식
80 : 바스켓
CMA_EVLU_AMT_ICLD_YN CMA평가금액포함여부 String Y 1 Y : 포함
N : 포함하지 않음
OVRS_ICLD_YN 해외포함여부 String Y 1 Y : 포함
N : 포함하지 않음

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 Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Object Y Single
-ord_psbl_cash 주문가능현금 String Y 19 예수금으로 계산된 주문가능금액
-ord_psbl_sbst 주문가능대용 String Y 19
-ruse_psbl_amt 재사용가능금액 String Y 19 전일/금일 매도대금으로 계산된 주문가능금액
-fund_rpch_chgs 펀드환매대금 String Y 19
-psbl_qty_calc_unpr 가능수량계산단가 String Y 19
-nrcvb_buy_amt 미수없는매수금액 String Y 19 미수를 사용하지 않으실 경우 nrcvb_buy_amt(미수없는매수금액)을 확인
-nrcvb_buy_qty 미수없는매수수량 String Y 10 미수를 사용하지 않으실 경우 nrcvb_buy_qty(미수없는매수수량)을 확인

* 특정 종목 전량매수 시 가능수량을 확인하실 경우
조회 시 ORD_DVSN:01(시장가)로 지정 필수
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력
-max_buy_amt 최대매수금액 String Y 19 미수를 사용하시는 경우 max_buy_amt(최대매수금액)를 확인
-max_buy_qty 최대매수수량 String Y 10 미수를 사용하시는 경우 max_buy_qty(최대매수수량)를 확인

* 특정 종목 전량매수 시 가능수량을 확인하실 경우
조회 시 ORD_DVSN:01(시장가)로 지정 필수
* 다만, 조건부지정가 등 특정 주문구분(ex.IOC)으로 주문 시 가능수량을 확인할 경우 주문 시와 동일한 주문구분(ex.IOC) 입력
-cma_evlu_amt CMA평가금액 String Y 19
-ovrs_re_use_amt_wcrc 해외재사용금액원화 String Y 19
-ord_psbl_frcr_amt_wcrc 주문가능외화금액원화 String Y 19

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"PDNO": "005930",
"ORD_UNPR": "0",
"ORD_DVSN": "01",
"CMA_EVLU_AMT_ICLD_YN": "N",
"OVRS_ICLD_YN": "N"
}

Response

{
  "output": {
    "ord_psbl_cash": "741191178",
    "ord_psbl_sbst": "0",
    "ruse_psbl_amt": "0",
    "fund_rpch_chgs": "0",
    "psbl_qty_calc_unpr": "70000",
    "nrcvb_buy_amt": "107177377",
    "nrcvb_buy_qty": "1531",
    "max_buy_amt": "1482382356",
    "max_buy_qty": "21176",
    "cma_evlu_amt": "0",
    "ovrs_re_use_amt_wcrc": "0",
    "ord_psbl_frcr_amt_wcrc": "1468797045293"
  },
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

주식예약주문[v1_국내주식-017]

REST

주식예약주문[v1_국내주식-017]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/order-resv
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

국내주식 예약주문 매수/매도 API 입니다.

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

※ 유의사항
1. 예약주문 가능시간 : 15시 40분 ~ 다음 영업일 7시 30분
(단, 서버 초기화 작업 시 예약주문 불가 : 23시 40분 ~ 00시 10분)
※ 예약주문 처리내역은 통보되지 않으므로 주문처리일 장 시작전에 반드시 주문처리 결과를 확인하시기 바랍니다.

2. 예약주문 안내
- 예약종료일 미입력 시 일반예약주문으로 최초 도래하는 영업일에 주문 전송됩니다.
- 예약종료일 입력 시 기간예약주문으로 최초 예약주문수량 중 미체결 된 수량에 대해 예약종료일까지 매 영업일 주문이
실행됩니다. (예약종료일은 익영업일부터 달력일 기준으로 공휴일 포함하여 최대 30일이 되는 일자까지 입력가능)
- 예약주문 접수 처리순서는 일반/기간예약주문 중 신청일자가 빠른 주문이 우선합니다.
단, 기간예약주문 자동배치시간(약 15시35분 ~ 15시55분)사이 접수되는 주문의 경우 당일에 한해 순서와 상관없이
처리될 수 있습니다.
- 기간예약주문 자동배치시간(약 15시35분 ~ 15시55분)에는 예약주문 조회가 제한 될 수 있습니다.
- 기간예약주문은 계좌 당 주문건수 최대 1,000건으로 제한됩니다.

3. 예약주문 접수내역 중 아래의 사유 등으로 인해 주문이 거부될 수 있사오니, 주문처리일 장 시작전에 반드시
주문처리 결과를 확인하시기 바랍니다.
* 주문처리일 기준 : 매수가능금액 부족, 매도가능수량 부족, 주문수량/호가단위 오류, 대주 호가제한,
신용/대주가능종목 변경, 상/하한폭 변경, 시가형성 종목(신규상장 등)의 시장가, 거래서비스 미신청 등

4. 익일 예상 상/하한가는 조회시점의 현재가로 계산되며 익일의 유/무상증자, 배당, 감자, 합병, 액면변경 등에 의해
변동될 수 있으며 이로 인해 상/하한가를 벗어나 주문이 거부되는 경우가 발생할 수 있사오니, 주문처리일 장 시작전에
반드시 주문처리결과를 확인하시기 바랍니다.

5. 정리매매종목, ELW, 신주인수권증권, 신주인수권증서 등은 가격제한폭(상/하한가) 적용 제외됩니다.

6. 영업일 장 시작 후 [기간예약주문] 내역 취소는 해당시점 이후의 예약주문이 취소되는 것으로,
일반주문으로 이미 전환된 주문에는 영향을 미치지 않습니다. 반드시 장 시작전 주문처리결과를 확인하시기 바랍니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 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 [실전투자]
CTSC0008U : 국내예약매수입력/주문예약매도입력
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 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
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PDNO 종목코드(6자리) String Y 12
ORD_QTY 주문수량 String Y 10 주문주식수
ORD_UNPR 주문단가 String Y 19 1주당 가격
* 장전 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고
SLL_BUY_DVSN_CD 매도매수구분코드 String Y 2 01 : 매도
02 : 매수
ORD_DVSN_CD 주문구분코드 String Y 2 00 : 지정가
01 : 시장가
02 : 조건부지정가
05 : 장전 시간외
ORD_OBJT_CBLC_DVSN_CD 주문대상잔고구분코드 String Y 2 [매도매수구분코드 01:매도/02:매수시 사용]
10 : 현금

[매도매수구분코드 01:매도시 사용]
12 : 주식담보대출
14 : 대여상환
21 : 자기융자신규
22 : 유통대주신규
23 : 유통융자신규
24 : 자기대주신규
25 : 자기융자상환
26 : 유통대주상환
27 : 유통융자상환
28 : 자기대주상환
LOAN_DT 대출일자 String N 8
RSVN_ORD_END_DT 예약주문종료일자 String N 8 (YYYYMMDD) 현재 일자보다 이후로 설정해야 함
* RSVN_ORD_END_DT(예약주문종료일자)를 안 넣으면 다음날 주문처리되고 예약주문은 종료됨
* RSVN_ORD_END_DT(예약주문종료일자)는 익영업일부터 달력일 기준으로 공휴일 포함하여 최대 30일이 되는 일자까지 입력 가능
LDNG_DT 대여일자 String N 8

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 Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8
msg 응답메세지 String Y 80
output 응답상세 Object Array Y Array
-rsvn_ord_seq 예약주문 순번 String N 10

Example

Request


"CANO": "810XXXXX", 
"ACNT_PRDT_CD": "01", 
"PDNO": "009150", 
"ORD_QTY": "10", 
"ORD_UNPR": "160000", 
"SLL_BUY_DVSN_CD":"02", 
"ORD_DVSN_CD":"00", 
"ORD_OBJT_CBLC_DVSN_CD":"10", 
"LOAN_DT":"", 
"RSVN_ORD_END_DT":""
}

Response


"rt_cd": "0", 
"msg_cd": "APBK2938", 
"msg1": "예약주문이 접수되었습니다.", 
"output": { 
"RSVN_ORD_SEQ": "39607" 

}

주식예약주문정정취소[v1_국내주식-018,019]

REST

주식예약주문정정취소[v1_국내주식-018,019]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/order-resv-rvsecncl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

국내주식 예약주문 정정/취소 API 입니다.
* 정정주문은 취소주문에 비해 필수 입력값이 추가 됩니다.
하단의 입력값을 참조하시기 바랍니다.

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 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 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
CTSC0009U : 국내주식예약취소주문
CTSC0013U : 국내주식예약정정주문
* 모의투자 사용 불가
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 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
CANO 종합계좌번호 String Y 8 [정정/취소] 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 [정정/취소] 계좌번호 체계(8-2)의 뒤 2자리
PDNO 종목코드(6자리) String Y 12 [정정]
ORD_QTY 주문수량 String Y 10 [정정] 주문주식수
ORD_UNPR 주문단가 String Y 19 [정정] 1주당 가격
* 장전 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고
SLL_BUY_DVSN_CD 매도매수구분코드 String Y 2 [정정]
01 : 매도
02 : 매수
ORD_DVSN_CD 주문구분코드 String Y 2 [정정]
00 : 지정가
01 : 시장가
02 : 조건부지정가
05 : 장전 시간외
ORD_OBJT_CBLC_DVSN_CD 주문대상잔고구분코드 String Y 2 [정정]
10 : 현금
12 : 주식담보대출
14 : 대여상환
21 : 자기융자신규
22 : 유통대주신규
23 : 유통융자신규
24 : 자기대주신규
25 : 자기융자상환
26 : 유통대주상환
27 : 유통융자상환
28 : 자기대주상환
LOAN_DT 대출일자 String N 8 [정정]
RSVN_ORD_END_DT 예약주문종료일자 String N 8 [정정]
CTAL_TLNO 연락전화번호 String N 20 [정정]
RSVN_ORD_SEQ 예약주문순번 String Y 10 [정정/취소]
RSVN_ORD_ORGNO 예약주문조직번호 String N 5 [정정/취소]
RSVN_ORD_ORD_DT 예약주문주문일자 String N 8 [정정/취소]

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 Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8
msg 응답메세지 String Y 80
output 응답상세 Array Y
-nrml_prcs_yn 정상처리여부 String Y 1

Example

Request


"_comment": "주식예약주문취소", 
"CANO": "810XXXXX", 
"ACNT_PRDT_CD": "01", 
"RSVN_ORD_ORD_DT": "20220427", 
"RSVN_ORD_SEQ": "39447", 
"RSVN_ORD_ORGNO": "00" 



"_comment": "주식예약주문정정", 
"CANO": "810XXXXX", 
"ACNT_PRDT_CD": "01", 
"PDNO": "009150", 
"ORD_QTY": "10", 
"ORD_UNPR": "140000", 
"SLL_BUY_DVSN_CD":"01", 
"ORD_DVSN_CD":"00", 
"ORD_OBJT_CBLC_DVSN_CD":"10", 
"LOAN_DT":"", 
"RSVN_ORD_END_DT":"", 
"CTAC_TLNO": "", 
"RSVN_ORD_SEQ":"39453", 
"RSVN_ORD_ORGNO":"", 
"RSVN_ORD_ORD_DT":"20220427" 
}

Response


"rt_cd": "0", 
"msg_cd": "KIOK0430", 
"msg1": "정상적으로 처리되었습니다", 
"output": { 
"NRML_PRCS_YN": "Y" 

}

주식예약주문조회[v1_국내주식-020]

REST

주식예약주문조회[v1_국내주식-020]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/order-resv-ccnl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

국내예약주문 처리내역 조회 API 입니다.
실전계좌/모의계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 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 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
CTSC0004R : 국내주식예약주문조회
* 모의투자 사용 불가
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 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해야 함

Query Parameter

Element 한글명 Type Required Length Description
RSVN_ORD_ORD_DT 예약주문시작일자 String Y 8
RSVN_ORD_END_DT 예약주문종료일자 String Y 8
RSVN_ORD_SEQ 예약주문순번 String Y 10
TMNL_MDIA_KIND_CD 단말매체종류코드 String Y 2 "00" 입력
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PRCS_DVSN_CD 처리구분코드 String Y 2 0: 전체
1: 처리내역
2: 미처리내역
CNCL_YN 취소여부 String Y 1 "Y" 유효한 주문만 조회
PDNO 상품번호 String Y 12 종목코드(6자리) (공백 입력 시 전체 조회)
SLL_BUY_DVSN_CD 매도매수구분코드 String Y 2
CTX_AREA_FK200 연속조회검색조건200 String Y 200 다음 페이지 조회시 사용
CTX_AREA_NK200 연속조회키200 String Y 200 다음 페이지 조회시 사용

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 Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output 응답상세 Array Y
-rsvn_ord_seq 예약주문 순번 String N 10
-rsvn_ord_ord_dt 예약주문주문일자 String N 8
-rsvn_ord_rcit_dt 예약주문접수일자 String N 8
-pdno 상품번호 String N 12
-ord_dvsn_cd 주문구분코드 String N 2
-ord_rsvn_qty 주문예약수량 String N 10
-tot_ccld_qty 총체결수량 String N 10
-cncl_ord_dt 취소주문일자 String N 8
-ord_tmd 주문시각 String N 6
-ctac_tlno 연락전화번호 String N 20
-rjct_rson2 거부사유2 String N 200
-odno 주문번호 String N 10
-rsvn_ord_rcit_tmd 예약주문접수시각 String N 6
-kor_item_shtn_name 한글종목단축명 String N 60
-sll_buy_dvsn_cd 매도매수구분코드 String N 2
-ord_rsvn_unpr 주문예약단가 String N 19
-tot_ccld_amt 총체결금액 String N 19
-loan_dt 대출일자 String N 8
-cncl_rcit_tmd 취소접수시각 String N 6
-prcs_rslt 처리결과 String N 60
-ord_dvsn_name 주문구분명 String N 60
-tmnl_mdia_kind_cd 단말매체종류코드 String N 2
-rsvn_end_dt 예약종료일자 String N 8

Example

Request

{
"RSVN_ORD_ORD_DT":"20220520",
"RSVN_ORD_END_DT":"20220523",
"RSVN_ORD_SEQ":"",
"TMNL_MDIA_KIND_CD":"00",
"CANO":"81019970",
"ACNT_PRDT_CD":"01",

"PRCS_DVSN_CD":"0",
"CNCL_YN":"Y",
"PDNO":"",
"SLL_BUY_DVSN_CD":"",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}

Response

{
    "ctx_area_fk200": "20220520!^null!^0!^Y!^!^                                                                                                                                                                                ",
    "ctx_area_nk200": " !^ !^                                                                                                                                                                                                  ",
    "output": [
        {
            "rsvn_ord_seq": "42401",
            "rsvn_ord_ord_dt": "20220523",
            "rsvn_ord_rcit_dt": "20220520",
            "pdno": "005940",
            "ord_dvsn_cd": "01",
            "ord_rsvn_qty": "1",
            "tot_ccld_qty": "0",
            "cncl_ord_dt": "",
            "ord_tmd": "",
            "ctac_tlno": "0",
            "rjct_rson2": "",
            "odno": "",
            "rsvn_ord_rcit_tmd": "165318",
            "kor_item_shtn_name": "NH투자증권",
            "sll_buy_dvsn_cd": "02",
            "ord_rsvn_unpr": "6000",
            "tot_ccld_amt": "0",
            "loan_dt": "",
            "cncl_rcit_tmd": "",
            "prcs_rslt": "미처리",
            "ord_dvsn_name": "현금매수",
            "tmnl_mdia_kind_cd": "31",
            "rsvn_end_dt": "20220523"
        },
        {
            "rsvn_ord_seq": "42405",
            "rsvn_ord_ord_dt": "20220523",
            "rsvn_ord_rcit_dt": "20220520",
            "pdno": "005940",
            "ord_dvsn_cd": "01",
            "ord_rsvn_qty": "1",
            "tot_ccld_qty": "0",
            "cncl_ord_dt": "",
            "ord_tmd": "",
            "ctac_tlno": "0",
            "rjct_rson2": "",
            "odno": "",
            "rsvn_ord_rcit_tmd": "170422",
            "kor_item_shtn_name": "NH투자증권",
            "sll_buy_dvsn_cd": "02",
            "ord_rsvn_unpr": "6000",
            "tot_ccld_amt": "0",
            "loan_dt": "",
            "cncl_rcit_tmd": "",
            "prcs_rslt": "미처리",
            "ord_dvsn_name": "현금매수",
            "tmnl_mdia_kind_cd": "31",
            "rsvn_end_dt": ""
        },
        {
            "rsvn_ord_seq": "42406",
            "rsvn_ord_ord_dt": "20220523",
            "rsvn_ord_rcit_dt": "20220520",
            "pdno": "005940",
            "ord_dvsn_cd": "01",
            "ord_rsvn_qty": "1",
            "tot_ccld_qty": "0",
            "cncl_ord_dt": "",
            "ord_tmd": "",
            "ctac_tlno": "0",
            "rjct_rson2": "",
            "odno": "",
            "rsvn_ord_rcit_tmd": "170453",
            "kor_item_shtn_name": "NH투자증권",
            "sll_buy_dvsn_cd": "02",
            "ord_rsvn_unpr": "6000",
            "tot_ccld_amt": "0",
            "loan_dt": "",
            "cncl_rcit_tmd": "",
            "prcs_rslt": "미처리",
            "ord_dvsn_name": "현금매수",
            "tmnl_mdia_kind_cd": "31",
            "rsvn_end_dt": "20220523"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "KIOK0460",
    "msg1": "조회 되었습니다. (마지막 자료)                                                  "
}

퇴직연금 체결기준잔고[v1_국내주식-032]

REST

퇴직연금 체결기준잔고[v1_국내주식-032]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/pension/inquire-present-balance
  • Format
     
  • Content-Type
     

개요

​※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.

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 TTTC2202R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
ACNT_PRDT_CD 계좌상품코드 String Y 2 29
USER_DVSN_CD 사용자구분코드 String Y 2 00
CTX_AREA_FK100 연속조회검색조건100 String Y 100
CTX_AREA_NK100 연속조회키100 String Y 100

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
msg1 응답메세지 String Y 80
output1 응답상세1 Object Array Y Array
-cblc_dvsn 잔고구분 String Y 2
-cblc_dvsn_name 잔고구분명 String Y 60
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-hldg_qty 보유수량 String Y 19
-slpsb_qty 매도가능수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 18.4
-evlu_pfls_amt 평가손익금액 String Y 19
-evlu_pfls_rt 평가손익율 String Y 7.2
-prpr 현재가 String Y 19
-evlu_amt 평가금액 String Y 19
-pchs_amt 매입금액 String Y 19
-cblc_weit 잔고비중 String Y 23.8
output2 응답상세2 Object Array Y Array
-pchs_amt_smtl_amt 매입금액합계금액 String Y 19
-evlu_amt_smtl_amt 평가금액합계금액 String Y 19
-evlu_pfls_smtl_amt 평가손익합계금액 String Y 19
-trad_pfls_smtl 매매손익합계 String Y 19
-thdt_tot_pfls_amt 당일총손익금액 String Y 19
-pftrt 수익률 String Y 23.8

Example

Request

{
"CANO":"63512345",
"ACNT_PRDT_CD":"29",
"USER_DVSN_CD":"00",
"CTX_AREA_FK100":"",
"CTX_AREA_NK100":""
}

Response

{
    "ctx_area_fk100": "63512345^29^00^                                                                                     ",
    "ctx_area_nk100": "                                                                                                    ",
    "output1": [
        {
            "cblc_dvsn": "01",
            "cblc_dvsn_name": "사용자",
            "pdno": "069500",
            "prdt_name": "KODEX 200",
            "hldg_qty": "6",
            "slpsb_qty": "6",
            "pchs_avg_pric": "35670.0000",
            "evlu_pfls_amt": "-3330",
            "evlu_pfls_rt": "-1.56",
            "prpr": "35115",
            "evlu_amt": "210690",
            "pchs_amt": "214020",
            "cblc_weit": "53.06651890"
        },
        {
            "cblc_dvsn": "01",
            "cblc_dvsn_name": "사용자",
            "pdno": "091160",
            "prdt_name": "KODEX 반도체",
            "hldg_qty": "7",
            "slpsb_qty": "7",
            "pchs_avg_pric": "35820.0000",
            "evlu_pfls_amt": "-64400",
            "evlu_pfls_rt": "-25.68",
            "prpr": "26620",
            "evlu_amt": "186340",
            "pchs_amt": "250740",
            "cblc_weit": "46.93348110"
        }
    ],
    "output2": [
        {
            "pchs_amt_smtl_amt": "464760",
            "evlu_amt_smtl_amt": "397030",
            "evlu_pfls_smtl_amt": "-67730",
            "trad_pfls_smtl": "0",
            "thdt_tot_pfls_amt": "-67730",
            "pftrt": "-14.57311300"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

퇴직연금 미체결내역[v1_국내주식-033]

REST

퇴직연금 미체결내역[v1_국내주식-033]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/pension/inquire-daily-ccld
  • Format
     
  • Content-Type
     

개요

​※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.

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 TTTC2201R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
ACNT_PRDT_CD 계좌상품코드 String Y 2 29
USER_DVSN_CD 사용자구분코드 String Y 2 %%
SLL_BUY_DVSN_CD 매도매수구분코드 String Y 2 00 : 전체 / 01 : 매도 / 02 : 매수
CCLD_NCCS_DVSN 체결미체결구분 String Y 2 %% : 전체 / 01 : 체결 / 02 : 미체결
INQR_DVSN_3 조회구분3 String Y 2 00 : 전체
CTX_AREA_FK100 연속조회검색조건100 String Y 100
CTX_AREA_NK100 연속조회키100 String Y 100

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
msg1 응답메세지 String Y 80
output 응답상세1 Object Array Y Array
-ord_gno_brno 주문채번지점번호 String Y 5
-sll_buy_dvsn_cd 매도매수구분코드 String Y 2
-trad_dvsn_name 매매구분명 String Y 60
-odno 주문번호 String Y 10
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-ord_unpr 주문단가 String Y 19
-ord_qty 주문수량 String Y 10
-tot_ccld_qty 총체결수량 String Y 10
-nccs_qty 미체결수량 String Y 10
-ord_dvsn_cd 주문구분코드 String Y 2
-ord_dvsn_name 주문구분명 String Y 60
-orgn_odno 원주문번호 String Y 10
-ord_tmd 주문시각 String Y 6
-objt_cust_dvsn_name 대상고객구분명 String Y 10
-pchs_avg_pric 매입평균가격 String Y 18.4

Example

Request

{
"CANO":"63512345",
"ACNT_PRDT_CD":"29",
"USER_DVSN_CD":"%%",
"SLL_BUY_DVSN_CD":"00",
"CCLD_NCCS_DVSN":"%%",
"INQR_DVSN_3":"00",
"CTX_AREA_FK100":"",
"CTX_AREA_NK100":""
}

Response

{
    "ctx_area_fk100": "63512345^29^%%^00^%%^00^                                                                            ",
    "ctx_area_nk100": "^^                                                                                                  ",
    "output": [],
    "rt_cd": "0",
    "msg_cd": "KIOK0490",
    "msg1": "조회가 계속됩니다                                                               "
}

퇴직연금 매수가능조회[v1_국내주식-034]

REST

퇴직연금 매수가능조회[v1_국내주식-034]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/pension/inquire-psbl-order
  • Format
     
  • Content-Type
     

개요

​※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.

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 TTTC0503R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
ACNT_PRDT_CD 계좌상품코드 String Y 2 29
PDNO 상품번호 String Y 12
ACCA_DVSN_CD 적립금구분코드 String Y 2 00
CMA_EVLU_AMT_ICLD_YN CMA평가금액포함여부 String Y 1
ORD_DVSN 주문구분 String Y 2 00 : 지정가 / 01 : 시장가
ORD_UNPR 주문단가 String Y 19

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
msg1 응답메세지 String Y 80
output 응답상세1 Object Y
-ord_psbl_cash 주문가능현금 String Y 19
-ruse_psbl_amt 재사용가능금액 String Y 19
-psbl_qty_calc_unpr 가능수량계산단가 String Y 19
-max_buy_amt 최대매수금액 String Y 19
-max_buy_qty 최대매수수량 String Y 10

Example

Request

{
"CANO":"63512345",
"ACNT_PRDT_CD":"29",
"PDNO":"029513",
"ORD_UNPR":"55000",
"ORD_DVSN":"00",
"CMA_EVLU_AMT_ICLD_YN":"N",
"ACCA_DVSN_CD":"00"
}

Response

{
    "output": {
        "ord_psbl_cash": "11054042",
        "ruse_psbl_amt": "0",
        "psbl_qty_calc_unpr": "55000",
        "max_buy_amt": "11054042",
        "max_buy_qty": "200"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

퇴직연금 예수금조회[v1_국내주식-035]

REST

퇴직연금 예수금조회[v1_국내주식-035]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/pension/inquire-deposit
  • Format
     
  • Content-Type
     

개요

​※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.

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 TTTC0506R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
ACNT_PRDT_CD 계좌상품코드 String Y 2 29
ACCA_DVSN_CD 적립금구분코드 String Y 2 00

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
msg1 응답메세지 String Y 80
output 응답상세1 Object Y
-dnca_tota 예수금총액 String Y 19
-nxdy_excc_amt 익일정산액 String Y 19
-nxdy_sttl_amt 익일결제금액 String Y 19
-nx2_day_sttl_amt 2익일결제금액 String Y 19

Example

Request

{
"CANO":"63512345",
"ACNT_PRDT_CD":"29",
"ACCA_DVSN_CD":"00"
}

Response

{
    "output": {
        "dnca_tota": "57622382",
        "nxdy_excc_amt": "11054042",
        "nxdy_sttl_amt": "0",
        "nx2_day_sttl_amt": "0"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

퇴직연금 잔고조회[v1_국내주식-036]

REST

퇴직연금 잔고조회[v1_국내주식-036]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/pension/inquire-balance
  • Format
     
  • Content-Type
     

개요

주식, ETF, ETN만 조회 가능하며 펀드는 조회 불가합니다.

​※ 55번 계좌(DC가입자계좌)의 경우 해당 API 이용이 불가합니다.
KIS Developers API의 경우 HTS ID에 반드시 연결되어있어야만 API 신청 및 앱정보 발급이 가능한 서비스로 개발되어서 실물계좌가 아닌 55번 계좌는 API 이용이 불가능한 점 양해 부탁드립니다.

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 TTTC2208R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
ACNT_PRDT_CD 계좌상품코드 String Y 2 29
ACCA_DVSN_CD 적립금구분코드 String Y 2 00
INQR_DVSN 조회구분 String Y 2 00 : 전체
CTX_AREA_FK100 연속조회검색조건100 String Y 100
CTX_AREA_NK100 연속조회키100 String Y 100

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Array Y Array
-cblc_dvsn_name 잔고구분명 String Y 60
-prdt_name 상품명 String Y 60
-pdno 상품번호 String Y 12
-item_dvsn_name 종목구분명 String Y 60
-thdt_buyqty 금일매수수량 String Y 10
-thdt_sll_qty 금일매도수량 String Y 10
-hldg_qty 보유수량 String Y 19
-ord_psbl_qty 주문가능수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 18.4
-pchs_amt 매입금액 String Y 19
-prpr 현재가 String Y 19
-evlu_amt 평가금액 String Y 19
-evlu_pfls_amt 평가손익금액 String Y 19
-evlu_erng_rt 평가수익율 String Y 23.8
output2 응답상세2 Object Y
-dnca_tot_amt 예수금총금액 String Y 19
-nxdy_excc_amt 익일정산금액 String Y 19
-prvs_rcdl_excc_amt 가수도정산금액 String Y 19
-thdt_buy_amt 금일매수금액 String Y 19
-thdt_sll_amt 금일매도금액 String Y 19
-thdt_tlex_amt 금일제비용금액 String Y 19
-scts_evlu_amt 유가평가금액 String Y 19
-tot_evlu_amt 총평가금액 String Y 19

Example

Request

{
"CANO":"12345678",
"ACNT_PRDT_CD":"29",
"ACCA_DVSN_CD":"00",
"INQR_DVSN":"00",
"CTX_AREA_FK100":"",
"CTX_AREA_NK100":""
}

Response

{
    "ctx_area_fk100": "12345678^29^00^00^                                                                                  ",
    "ctx_area_nk100": "                                                                                                    ",
    "output1": [
        {
            "cblc_dvsn_name": "사용자",
            "prdt_name": "ACE 미국S&P500",
            "pdno": "360200",
            "item_dvsn_name": "현금",
            "thdt_buyqty": "5",
            "thdt_sll_qty": "0",
            "hldg_qty": "5",
            "ord_psbl_qty": "5",
            "pchs_avg_pric": "13235.0000",
            "pchs_amt": "66175",
            "prpr": "13235",
            "evlu_amt": "66175",
            "evlu_pfls_amt": "0",
            "evlu_erng_rt": "0.00000000"
        }
    ],
    "output2": {
        "dnca_tot_amt": "100000",
        "nxdy_excc_amt": "100000",
        "prvs_rcdl_excc_amt": "33825",
        "thdt_buy_amt": "66175",
        "thdt_sll_amt": "0",
        "thdt_tlex_amt": "0",
        "scts_evlu_amt": "66175",
        "tot_evlu_amt": "100000"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

주식잔고조회_실현손익[v1_국내주식-041]

REST

주식잔고조회_실현손익[v1_국내주식-041]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
     
  • URL
    /uapi/domestic-stock/v1/trading/inquire-balance-rlz-pl
  • Format
     
  • Content-Type
     

개요

주식잔고조회_실현손익 API입니다.
한국투자 HTS(eFriend Plus) [0800] 국내 체결기준잔고 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
(참고: 포럼 - 공지사항 - 신규 API 추가 안내(주식잔고조회_실현손익 외 1건))

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 TTTC8494R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
AFHR_FLPR_YN 시간외단일가여부 String Y 1 'N : 기본값
Y : 시간외단일가'
OFL_YN 오프라인여부 String Y 1 공란
INQR_DVSN 조회구분 String Y 2 00 : 전체
UNPR_DVSN 단가구분 String Y 2 01 : 기본값
FUND_STTL_ICLD_YN 펀드결제포함여부 String Y 1 N : 포함하지 않음
Y : 포함
FNCG_AMT_AUTO_RDPT_YN 융자금액자동상환여부 String Y 1 N : 기본값
PRCS_DVSN PRCS_DVSN String Y 2 00 : 전일매매포함
01 : 전일매매미포함
COST_ICLD_YN 비용포함여부 String Y 1
CTX_AREA_FK100 연속조회검색조건100 String Y 100 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK100 값 : 다음페이지 조회시(2번째부터)
CTX_AREA_NK100 연속조회키100 String Y 100 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK100 값 : 다음페이지 조회시(2번째부터)

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
msg1 응답메세지 String Y 80
Output1 응답상세 Object Array Y Array
-pdno 상품번호 String Y 12 종목번호(뒷 6자리)
-prdt_name 상품명 String Y 60 종목명
-trad_dvsn_name 매매구분명 String Y 60 매수매도구분
-bfdy_buy_qty 전일매수수량 String Y 10
-bfdy_sll_qty 전일매도수량 String Y 10
-thdt_buyqty 금일매수수량 String Y 10
-thdt_sll_qty 금일매도수량 String Y 10
-hldg_qty 보유수량 String Y 19
-ord_psbl_qty 주문가능수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 23 매입금액 / 보유수량
-pchs_amt 매입금액 String Y 19
-prpr 현재가 String Y 19
-evlu_amt 평가금액 String Y 19
-evlu_pfls_amt 평가손익금액 String Y 19 평가금액 - 매입금액
-evlu_pfls_rt 평가손익율 String Y 10
-evlu_erng_rt 평가수익율 String Y 32
-loan_dt 대출일자 String Y 8
-loan_amt 대출금액 String Y 19
-stln_slng_chgs 대주매각대금 String Y 19 신용 거래에서, 고객이 증권 회사로부터 대부받은 주식의 매각 대금
-expd_dt 만기일자 String Y 8
-stck_loan_unpr 주식대출단가 String Y 23
-bfdy_cprs_icdc 전일대비증감 String Y 19
-fltt_rt 등락율 String Y 32
Output2 응답상세2 Object Array Y Array
-dnca_tot_amt 예수금총금액 String Y 19
-nxdy_excc_amt 익일정산금액 String Y 19
-prvs_rcdl_excc_amt 가수도정산금액 String Y 19
-cma_evlu_amt CMA평가금액 String Y 19
-bfdy_buy_amt 전일매수금액 String Y 19
-thdt_buy_amt 금일매수금액 String Y 19
-nxdy_auto_rdpt_amt 익일자동상환금액 String Y 19
-bfdy_sll_amt 전일매도금액 String Y 19
-thdt_sll_amt 금일매도금액 String Y 19
-d2_auto_rdpt_amt D+2자동상환금액 String Y 19
-bfdy_tlex_amt 전일제비용금액 String Y 19
-thdt_tlex_amt 금일제비용금액 String Y 19
-tot_loan_amt 총대출금액 String Y 19
-scts_evlu_amt 유가평가금액 String Y 19
-tot_evlu_amt 총평가금액 String Y 19
-nass_amt 순자산금액 String Y 19
-fncg_gld_auto_rdpt_yn 융자금자동상환여부 String Y 1
-pchs_amt_smtl_amt 매입금액합계금액 String Y 19
-evlu_amt_smtl_amt 평가금액합계금액 String Y 19
-evlu_pfls_smtl_amt 평가손익합계금액 String Y 19
-tot_stln_slng_chgs 총대주매각대금 String Y 19
-bfdy_tot_asst_evlu_amt 전일총자산평가금액 String Y 19
-asst_icdc_amt 자산증감액 String Y 19
-asst_icdc_erng_rt 자산증감수익율 String Y 32
-rlzt_pfls 실현손익 String Y 19
-rlzt_erng_rt 실현수익율 String Y 32
-real_evlu_pfls 실평가손익 String Y 19
-real_evlu_pfls_erng_rt 실평가손익수익율 String Y 32

Example

Request

{
"CANO":"12345678",
"ACNT_PRDT_CD":"01",
"AFHR_FLPR_YN":"N",
"OFL_YN":"",
"INQR_DVSN":"02",
"UNPR_DVSN":"01",
"FUND_STTL_ICLD_YN":"N",
"FNCG_AMT_AUTO_RDPT_YN":"N",
"PRCS_DVSN":"01",
"COST_ICLD_YN":"N",
"CTX_AREA_FK100":"",
"CTX_AREA_NK100":""
}

Response

{
    "ctx_area_fk100": "12345678^01^N^N^02^01^N^                                                                            ",
    "ctx_area_nk100": "N^00000A900270^300^00000000^00^                                                                     ",
    "output1": [
        {
            "pdno": "000080",
            "prdt_name": "하이트진로",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "22975.0000",
            "pchs_amt": "45950",
            "prpr": "22600",
            "evlu_amt": "45200",
            "evlu_pfls_amt": "-750",
            "evlu_pfls_rt": "-1.63",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "000100",
            "prdt_name": "유한양행",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "64800.0000",
            "pchs_amt": "129600",
            "prpr": "67600",
            "evlu_amt": "135200",
            "evlu_pfls_amt": "5600",
            "evlu_pfls_rt": "4.32",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "2900",
            "fltt_rt": "4.48222566"
        },
        {
            "pdno": "000120",
            "prdt_name": "CJ대한통운",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "116800.0000",
            "pchs_amt": "1168000",
            "prpr": "129500",
            "evlu_amt": "1295000",
            "evlu_pfls_amt": "127000",
            "evlu_pfls_rt": "10.87",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "500",
            "fltt_rt": "0.38759690"
        },
        {
            "pdno": "000210",
            "prdt_name": "DL",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "50400.0000",
            "pchs_amt": "504000",
            "prpr": "45800",
            "evlu_amt": "458000",
            "evlu_pfls_amt": "-46000",
            "evlu_pfls_rt": "-9.12",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "-5500",
            "fltt_rt": "-10.72124756"
        },
        {
            "pdno": "000240",
            "prdt_name": "한국앤컴퍼니",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "23850.0000",
            "pchs_amt": "47700",
            "prpr": "17450",
            "evlu_amt": "34900",
            "evlu_pfls_amt": "-12800",
            "evlu_pfls_rt": "-26.83",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "000270",
            "prdt_name": "기아",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "84500.0000",
            "pchs_amt": "845000",
            "prpr": "89500",
            "evlu_amt": "895000",
            "evlu_pfls_amt": "50000",
            "evlu_pfls_rt": "5.91",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "-35300",
            "fltt_rt": "-28.28525641"
        },
        {
            "pdno": "000660",
            "prdt_name": "SK하이닉스",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "12",
            "ord_psbl_qty": "12",
            "pchs_avg_pric": "122583.3333",
            "pchs_amt": "1471000",
            "prpr": "161700",
            "evlu_amt": "1940400",
            "evlu_pfls_amt": "469400",
            "evlu_pfls_rt": "31.91",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "1700",
            "fltt_rt": "1.06250000"
        },
        {
            "pdno": "000670",
            "prdt_name": "영풍",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "4",
            "thdt_sll_qty": "0",
            "hldg_qty": "4",
            "ord_psbl_qty": "4",
            "pchs_avg_pric": "640750.0000",
            "pchs_amt": "2563000",
            "prpr": "525000",
            "evlu_amt": "2100000",
            "evlu_pfls_amt": "-463000",
            "evlu_pfls_rt": "-18.06",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "000990",
            "prdt_name": "DB하이텍",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "23000.0000",
            "pchs_amt": "46000",
            "prpr": "49600",
            "evlu_amt": "99200",
            "evlu_pfls_amt": "53200",
            "evlu_pfls_rt": "115.65",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "001120",
            "prdt_name": "LX인터내셔널",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "1",
            "thdt_sll_qty": "0",
            "hldg_qty": "1",
            "ord_psbl_qty": "1",
            "pchs_avg_pric": "34050.0000",
            "pchs_amt": "34050",
            "prpr": "28950",
            "evlu_amt": "28950",
            "evlu_pfls_amt": "-5100",
            "evlu_pfls_rt": "-14.97",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "002380",
            "prdt_name": "KCC",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "1",
            "thdt_sll_qty": "0",
            "hldg_qty": "1",
            "ord_psbl_qty": "1",
            "pchs_avg_pric": "252000.0000",
            "pchs_amt": "252000",
            "prpr": "250000",
            "evlu_amt": "250000",
            "evlu_pfls_amt": "-2000",
            "evlu_pfls_rt": "-0.79",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "003550",
            "prdt_name": "LG",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "105600.0000",
            "pchs_amt": "211200",
            "prpr": "85000",
            "evlu_amt": "170000",
            "evlu_pfls_amt": "-41200",
            "evlu_pfls_rt": "-19.50",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "-16200",
            "fltt_rt": "-16.00790514"
        },
        {
            "pdno": "003670",
            "prdt_name": "포스코퓨처엠",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "531000.0000",
            "pchs_amt": "1062000",
            "prpr": "296000",
            "evlu_amt": "592000",
            "evlu_pfls_amt": "-470000",
            "evlu_pfls_rt": "-44.25",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "004800",
            "prdt_name": "효성",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "66400.0000",
            "pchs_amt": "132800",
            "prpr": "64700",
            "evlu_amt": "129400",
            "evlu_pfls_amt": "-3400",
            "evlu_pfls_rt": "-2.56",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "005380",
            "prdt_name": "현대차",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "240500.0000",
            "pchs_amt": "481000",
            "prpr": "244000",
            "evlu_amt": "488000",
            "evlu_pfls_amt": "7000",
            "evlu_pfls_rt": "1.45",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "22000",
            "fltt_rt": "9.90990991"
        },
        {
            "pdno": "005490",
            "prdt_name": "POSCO홀딩스",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "133500.0000",
            "pchs_amt": "1335000",
            "prpr": "421500",
            "evlu_amt": "4215000",
            "evlu_pfls_amt": "2880000",
            "evlu_pfls_rt": "215.73",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "005930",
            "prdt_name": "삼성전자",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "1417",
            "thdt_sll_qty": "2",
            "hldg_qty": "1415",
            "ord_psbl_qty": "1415",
            "pchs_avg_pric": "53397.8247",
            "pchs_amt": "75557922",
            "prpr": "73900",
            "evlu_amt": "104568500",
            "evlu_pfls_amt": "29010578",
            "evlu_pfls_rt": "38.39",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "-400",
            "fltt_rt": "-0.53835801"
        },
        {
            "pdno": "005930",
            "prdt_name": "삼성전자",
            "trad_dvsn_name": "자기융자",
            "bfdy_buy_qty": "1",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "0",
            "thdt_sll_qty": "0",
            "hldg_qty": "1",
            "ord_psbl_qty": "1",
            "pchs_avg_pric": "45100.0000",
            "pchs_amt": "45100",
            "prpr": "73900",
            "evlu_amt": "73900",
            "evlu_pfls_amt": "28800",
            "evlu_pfls_rt": "63.85",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "45100",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "45100.0000",
            "bfdy_cprs_icdc": "-400",
            "fltt_rt": "-0.53835801"
        },
        {
            "pdno": "005940",
            "prdt_name": "NH투자증권",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "11710.0000",
            "pchs_amt": "117100",
            "prpr": "10650",
            "evlu_amt": "106500",
            "evlu_pfls_amt": "-10600",
            "evlu_pfls_rt": "-9.05",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "006260",
            "prdt_name": "LS",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "122000.0000",
            "pchs_amt": "1220000",
            "prpr": "96600",
            "evlu_amt": "966000",
            "evlu_pfls_amt": "-254000",
            "evlu_pfls_rt": "-20.81",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "008770",
            "prdt_name": "호텔신라",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "99850.0000",
            "pchs_amt": "199700",
            "prpr": "59300",
            "evlu_amt": "118600",
            "evlu_pfls_amt": "-81100",
            "evlu_pfls_rt": "-40.61",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "-2100",
            "fltt_rt": "-3.42019544"
        },
        {
            "pdno": "009540",
            "prdt_name": "HD한국조선해양",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "170000.0000",
            "pchs_amt": "1700000",
            "prpr": "126000",
            "evlu_amt": "1260000",
            "evlu_pfls_amt": "-440000",
            "evlu_pfls_rt": "-25.88",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "1000",
            "fltt_rt": "0.80000000"
        },
        {
            "pdno": "011780",
            "prdt_name": "금호석유",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "200000.0000",
            "pchs_amt": "2000000",
            "prpr": "151900",
            "evlu_amt": "1519000",
            "evlu_pfls_amt": "-481000",
            "evlu_pfls_rt": "-24.05",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "011790",
            "prdt_name": "SKC",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "49950.0000",
            "pchs_amt": "499500",
            "prpr": "92100",
            "evlu_amt": "921000",
            "evlu_pfls_amt": "421500",
            "evlu_pfls_rt": "84.38",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "015760",
            "prdt_name": "한국전력",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "4",
            "thdt_sll_qty": "0",
            "hldg_qty": "4",
            "ord_psbl_qty": "4",
            "pchs_avg_pric": "8030.0000",
            "pchs_amt": "32120",
            "prpr": "23000",
            "evlu_amt": "92000",
            "evlu_pfls_amt": "59880",
            "evlu_pfls_rt": "186.42",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "017670",
            "prdt_name": "SK텔레콤",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "50100.0000",
            "pchs_amt": "501000",
            "prpr": "53200",
            "evlu_amt": "532000",
            "evlu_pfls_amt": "31000",
            "evlu_pfls_rt": "6.18",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "018260",
            "prdt_name": "삼성에스디에스",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "250000.0000",
            "pchs_amt": "500000",
            "prpr": "174000",
            "evlu_amt": "348000",
            "evlu_pfls_amt": "-152000",
            "evlu_pfls_rt": "-30.40",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "3200",
            "fltt_rt": "1.87353630"
        },
        {
            "pdno": "028260",
            "prdt_name": "삼성물산",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "5",
            "thdt_sll_qty": "0",
            "hldg_qty": "5",
            "ord_psbl_qty": "5",
            "pchs_avg_pric": "156100.0000",
            "pchs_amt": "780500",
            "prpr": "128000",
            "evlu_amt": "640000",
            "evlu_pfls_amt": "-140500",
            "evlu_pfls_rt": "-18.00",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "028670",
            "prdt_name": "팬오션",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "4865.0000",
            "pchs_amt": "9730",
            "prpr": "5000",
            "evlu_amt": "10000",
            "evlu_pfls_amt": "270",
            "evlu_pfls_rt": "2.77",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "385",
            "fltt_rt": "8.34236186"
        },
        {
            "pdno": "030200",
            "prdt_name": "KT",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "26050.0000",
            "pchs_amt": "260500",
            "prpr": "40650",
            "evlu_amt": "406500",
            "evlu_pfls_amt": "146000",
            "evlu_pfls_rt": "56.04",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "034730",
            "prdt_name": "SK",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "182700.0000",
            "pchs_amt": "1827000",
            "prpr": "207000",
            "evlu_amt": "2070000",
            "evlu_pfls_amt": "243000",
            "evlu_pfls_rt": "13.30",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "035250",
            "prdt_name": "강원랜드",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "20950.0000",
            "pchs_amt": "209500",
            "prpr": "19000",
            "evlu_amt": "190000",
            "evlu_pfls_amt": "-19500",
            "evlu_pfls_rt": "-9.30",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "1230",
            "fltt_rt": "6.92177828"
        },
        {
            "pdno": "035420",
            "prdt_name": "NAVER",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "356000.0000",
            "pchs_amt": "3560000",
            "prpr": "270000",
            "evlu_amt": "2700000",
            "evlu_pfls_amt": "-860000",
            "evlu_pfls_rt": "-24.15",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "61000",
            "fltt_rt": "29.18660287"
        },
        {
            "pdno": "035760",
            "prdt_name": "CJ ENM",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "11",
            "thdt_sll_qty": "0",
            "hldg_qty": "11",
            "ord_psbl_qty": "11",
            "pchs_avg_pric": "58836.3636",
            "pchs_amt": "647199",
            "prpr": "82200",
            "evlu_amt": "904200",
            "evlu_pfls_amt": "257000",
            "evlu_pfls_rt": "39.70",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "036460",
            "prdt_name": "한국가스공사",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "27850.0000",
            "pchs_amt": "55700",
            "prpr": "30400",
            "evlu_amt": "60800",
            "evlu_pfls_amt": "5100",
            "evlu_pfls_rt": "9.15",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "047050",
            "prdt_name": "포스코인터내셔널",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "74400.0000",
            "pchs_amt": "148800",
            "prpr": "58400",
            "evlu_amt": "116800",
            "evlu_pfls_amt": "-32000",
            "evlu_pfls_rt": "-21.50",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "057050",
            "prdt_name": "현대홈쇼핑",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "30100.0000",
            "pchs_amt": "60200",
            "prpr": "46850",
            "evlu_amt": "93700",
            "evlu_pfls_amt": "33500",
            "evlu_pfls_rt": "55.64",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "093370",
            "prdt_name": "후성",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "15510.0000",
            "pchs_amt": "31020",
            "prpr": "9000",
            "evlu_amt": "18000",
            "evlu_pfls_amt": "-13020",
            "evlu_pfls_rt": "-41.97",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "096770",
            "prdt_name": "SK이노베이션",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "228000.0000",
            "pchs_amt": "2280000",
            "prpr": "124100",
            "evlu_amt": "1241000",
            "evlu_pfls_amt": "-1039000",
            "evlu_pfls_rt": "-45.57",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "097950",
            "prdt_name": "CJ제일제당",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "210500.0000",
            "pchs_amt": "2105000",
            "prpr": "309500",
            "evlu_amt": "3095000",
            "evlu_pfls_amt": "990000",
            "evlu_pfls_rt": "47.03",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "114090",
            "prdt_name": "GKL",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "1",
            "thdt_sll_qty": "0",
            "hldg_qty": "1",
            "ord_psbl_qty": "1",
            "pchs_avg_pric": "15010.0000",
            "pchs_amt": "15010",
            "prpr": "13070",
            "evlu_amt": "13070",
            "evlu_pfls_amt": "-1940",
            "evlu_pfls_rt": "-12.92",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "136480",
            "prdt_name": "하림",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "228",
            "thdt_sll_qty": "7",
            "hldg_qty": "222",
            "ord_psbl_qty": "222",
            "pchs_avg_pric": "2317.1937",
            "pchs_amt": "514417",
            "prpr": "3150",
            "evlu_amt": "699300",
            "evlu_pfls_amt": "184883",
            "evlu_pfls_rt": "35.94",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "285130",
            "prdt_name": "SK케미칼",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "100000.0000",
            "pchs_amt": "1000000",
            "prpr": "70700",
            "evlu_amt": "707000",
            "evlu_pfls_amt": "-293000",
            "evlu_pfls_rt": "-29.29",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "298020",
            "prdt_name": "효성티앤씨",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "365000.0000",
            "pchs_amt": "730000",
            "prpr": "304000",
            "evlu_amt": "608000",
            "evlu_pfls_amt": "-122000",
            "evlu_pfls_rt": "-16.71",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "298050",
            "prdt_name": "효성첨단소재",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "480000.0000",
            "pchs_amt": "960000",
            "prpr": "327500",
            "evlu_amt": "655000",
            "evlu_pfls_amt": "-305000",
            "evlu_pfls_rt": "-31.77",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "302440",
            "prdt_name": "SK바이오사이언스",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "100000.0000",
            "pchs_amt": "1000000",
            "prpr": "65000",
            "evlu_amt": "650000",
            "evlu_pfls_amt": "-350000",
            "evlu_pfls_rt": "-35.00",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "352820",
            "prdt_name": "하이브",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "2",
            "thdt_sll_qty": "0",
            "hldg_qty": "2",
            "ord_psbl_qty": "2",
            "pchs_avg_pric": "383000.0000",
            "pchs_amt": "766000",
            "prpr": "218500",
            "evlu_amt": "437000",
            "evlu_pfls_amt": "-329000",
            "evlu_pfls_rt": "-42.95",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "361610",
            "prdt_name": "SK아이이테크놀로지",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "110000.0000",
            "pchs_amt": "1100000",
            "prpr": "71700",
            "evlu_amt": "717000",
            "evlu_pfls_amt": "-383000",
            "evlu_pfls_rt": "-34.81",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        },
        {
            "pdno": "373220",
            "prdt_name": "LG에너지솔루션",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "552000.0000",
            "pchs_amt": "5520000",
            "prpr": "530000",
            "evlu_amt": "5300000",
            "evlu_pfls_amt": "-220000",
            "evlu_pfls_rt": "-3.98",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "10000",
            "fltt_rt": "1.92307692"
        },
        {
            "pdno": "402340",
            "prdt_name": "SK스퀘어",
            "trad_dvsn_name": "현금",
            "bfdy_buy_qty": "0",
            "bfdy_sll_qty": "0",
            "thdt_buyqty": "10",
            "thdt_sll_qty": "0",
            "hldg_qty": "10",
            "ord_psbl_qty": "10",
            "pchs_avg_pric": "59000.0000",
            "pchs_amt": "590000",
            "prpr": "59600",
            "evlu_amt": "596000",
            "evlu_pfls_amt": "6000",
            "evlu_pfls_rt": "1.01",
            "evlu_erng_rt": "0.00000000",
            "loan_dt": "",
            "loan_amt": "0",
            "stln_slng_chgs": "0",
            "expd_dt": "",
            "stck_loan_unpr": "0.0000",
            "bfdy_cprs_icdc": "0",
            "fltt_rt": "0.00000000"
        }
    ],
    "output2": [
        {
            "dnca_tot_amt": "249855303",
            "nxdy_excc_amt": "249855303",
            "prvs_rcdl_excc_amt": "249855303",
            "cma_evlu_amt": "0",
            "bfdy_buy_amt": "0",
            "thdt_buy_amt": "0",
            "nxdy_auto_rdpt_amt": "0",
            "bfdy_sll_amt": "0",
            "thdt_sll_amt": "0",
            "d2_auto_rdpt_amt": "0",
            "bfdy_tlex_amt": "0",
            "thdt_tlex_amt": "0",
            "tot_loan_amt": "45100",
            "scts_evlu_amt": "145336415",
            "tot_evlu_amt": "395191718",
            "nass_amt": "395146618",
            "fncg_gld_auto_rdpt_yn": "N",
            "pchs_amt_smtl_amt": "116903507",
            "evlu_amt_smtl_amt": "145336415",
            "evlu_pfls_smtl_amt": "28432908",
            "tot_stln_slng_chgs": "0",
            "bfdy_tot_asst_evlu_amt": "0",
            "asst_icdc_amt": "395146618",
            "asst_icdc_erng_rt": "0.00000000",
            "rlzt_pfls": "46526",
            "rlzt_erng_rt": "36.68403914",
            "real_evlu_pfls": "27955091",
            "real_evlu_pfls_erng_rt": "23.91296182"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "KIOK0500",
    "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오.                                   "
}

신용매수가능조회[v1_국내주식-042]

REST

신용매수가능조회[v1_국내주식-042]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    제공 안함
  • URL
    /uapi/domestic-stock/v1/trading/inquire-credit-psamount
  • Format
     
  • Content-Type
    application/json; charset=utf-8

개요

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 TTTC8909R
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 ※ 입력 불필요
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PDNO 상품번호 String Y 12 종목코드(6자리)
ORD_UNPR 주문단가 String Y 19 1주당 가격
* 장전 시간외, 장후 시간외, 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력 권고
ORD_DVSN 주문구분 String Y 2 00 : 지정가
01 : 시장가
02 : 조건부지정가
03 : 최유리지정가
04 : 최우선지정가
05 : 장전 시간외
06 : 장후 시간외
07 : 시간외 단일가 등
CRDT_TYPE 신용유형 String Y 2 21 : 자기융자신규
23 : 유통융자신규
26 : 유통대주상환
28 : 자기대주상환
25 : 자기융자상환
27 : 유통융자상환
22 : 유통대주신규
24 : 자기대주신규
CMA_EVLU_AMT_ICLD_YN CMA평가금액포함여부 String Y 1 Y/N
OVRS_ICLD_YN 해외포함여부 String Y 1 Y/N

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 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메시지
Output1 응답상세 Object Y
-ord_psbl_cash 주문가능현금 String Y 19
-ord_psbl_sbst 주문가능대용 String Y 19
-ruse_psbl_amt 재사용가능금액 String Y 19
-fund_rpch_chgs 펀드환매대금 String Y 19
-psbl_qty_calc_unpr 가능수량계산단가 String Y 19
-nrcvb_buy_amt 미수없는매수금액 String Y 19
-nrcvb_buy_qty 미수없는매수수량 String Y 10
-max_buy_amt 최대매수금액 String Y 19
-max_buy_qty 최대매수수량 String Y 10
-cma_evlu_amt CMA평가금액 String Y 19
-ovrs_re_use_amt_wcrc 해외재사용금액원화 String Y 19
-ord_psbl_frcr_amt_wcrc 주문가능외화금액원화 String Y 19

Example

Request

{
"CANO": "12345678",
"ACNT_PRDT_CD": "01",
"PDNO": "005930",
"ORD_UNPR" : "55000",
"ORD_DVSN": "01",
"CRDT_TYPE": "21",
"CMA_EVLU_AMT_ICLD_YN": "N",
"OVRS_ICLD_YN": "N"
}

Response

{
    "output": {
        "ord_psbl_cash": "99965177664",
        "ord_psbl_sbst": "156772560",
        "ruse_psbl_amt": "0",
        "fund_rpch_chgs": "0",
        "psbl_qty_calc_unpr": "69200",
        "nrcvb_buy_amt": "0",
        "nrcvb_buy_qty": "0",
        "max_buy_amt": "0",
        "max_buy_qty": "0",
        "cma_evlu_amt": "0",
        "ovrs_re_use_amt_wcrc": "0",
        "ord_psbl_frcr_amt_wcrc": "157998704172856"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

투자계좌자산현황조회[v1_국내주식-048]

REST

투자계좌자산현황조회[v1_국내주식-048]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/inquire-account-balance
  • Format
     
  • Content-Type
     

개요

투자계좌자산현황조회 API입니다.

output1은 한국투자 HTS(eFriend Plus) > [0891] 계좌 자산비중(결제기준) 화면 아래 테이블의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

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 CTRP6548R
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 ※ 입력 불필요
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
INQR_DVSN_1 조회구분1 String Y 1 공백입력
BSPR_BF_DT_APLY_YN 기준가이전일자적용여부 String Y 1 공백입력

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
msg1 응답메세지 String Y 80
Output1 응답상세 Object Array Y Array [아래 순서대로 출력 : 19항목]
1: 주식
2: 펀드/MMW
3: 채권
4: ELS/DLS
5: WRAP
6: 신탁/퇴직연금/외화신탁
7: RP/발행어음
8: 해외주식
9: 해외채권
10: 금현물
11: CD/CP
12: 단기사채
13: 타사상품
14: 외화단기사채
15: 외화 ELS/DLS
16: 외화
17: 예수금+CMA
18: 청약자예수금
19: <합계>

[21번 계좌일 경우 : 16항목]
1: 수익증권
2: 채권
3: ELS/DLS
4: wrap
5: 신탁
6: rp
7: 외화rp
8: 해외채권
9: CD/CP
10: 전자단기사채
11: 외화전자단기사채
12: 외화ELS/DLS
13: 외화평가금액
14: 예수금+cma
15: 청약자예수금
16: 합계
-pchs_amt 매입금액 String Y 19
-evlu_amt 평가금액 String Y 19
-evlu_pfls_amt 평가손익금액 String Y 19
-crdt_lnd_amt 신용대출금액 String Y 19
-real_nass_amt 실제순자산금액 String Y 19
-whol_weit_rt 전체비중율 String Y 228
Output2 응답상세2 Object Y
-pchs_amt_smtl 매입금액합계 String Y 19 유가매입금액
-nass_tot_amt 순자산총금액 String Y 19
-loan_amt_smtl 대출금액합계 String Y 19
-evlu_pfls_amt_smtl 평가손익금액합계 String Y 19 평가손익금액
-evlu_amt_smtl 평가금액합계 String Y 19 유가평가금액
-tot_asst_amt 총자산금액 String Y 19 총 자산금액
-tot_lnda_tot_ulst_lnda 총대출금액총융자대출금액 String Y 19
-cma_auto_loan_amt CMA자동대출금액 String Y 19
-tot_mgln_amt 총담보대출금액 String Y 19
-stln_evlu_amt 대주평가금액 String Y 19
-crdt_fncg_amt 신용융자금액 String Y 19
-ocl_apl_loan_amt OCL_APL대출금액 String Y 19
-pldg_stup_amt 질권설정금액 String Y 19
-frcr_evlu_tota 외화평가총액 String Y 19
-tot_dncl_amt 총예수금액 String Y 19
-cma_evlu_amt CMA평가금액 String Y 19
-dncl_amt 예수금액 String Y 19
-tot_sbst_amt 총대용금액 String Y 19
-thdt_rcvb_amt 당일미수금액 String Y 20
-ovrs_stck_evlu_amt1 해외주식평가금액1 String Y 236
-ovrs_bond_evlu_amt 해외채권평가금액 String Y 236
-mmf_cma_mgge_loan_amt MMFCMA담보대출금액 String Y 19
-sbsc_dncl_amt 청약예수금액 String Y 19
-pbst_sbsc_fnds_loan_use_amt 공모주청약자금대출사용금액 String Y 20
-etpr_crdt_grnt_loan_amt 기업신용공여대출금액 String Y 19

Example

Request

{
"CANO":"12345678",
"ACNT_PRDT_CD":"01",
"INQR_DVSN_1":"",
"BSPR_BF_DT_APLY_YN":"",
}

Response

{
    "output1": [
        {
            "pchs_amt": "129105",
            "evlu_amt": "406000",
            "evlu_pfls_amt": "276895",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "406000",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "161026228",
            "evlu_amt": "185144504",
            "evlu_pfls_amt": "24118276",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "185144504",
            "whol_weit_rt": "0.01000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "1651434483743",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "1651434483743",
            "whol_weit_rt": "99.97000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "249855300",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "249855300",
            "whol_weit_rt": "0.01000000"
        },
        {
            "pchs_amt": "0",
            "evlu_amt": "0",
            "evlu_pfls_amt": "0",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "0",
            "whol_weit_rt": "0.00000000"
        },
        {
            "pchs_amt": "161155333",
            "evlu_amt": "1651869889547",
            "evlu_pfls_amt": "24395171",
            "crdt_lnd_amt": "0",
            "real_nass_amt": "1651869889547",
            "whol_weit_rt": "100.00000000"
        }
    ],
    "output2": {
        "pchs_amt_smtl": "161155333",
        "nass_tot_amt": "185550504",
        "loan_amt_smtl": "0",
        "evlu_pfls_amt_smtl": "24395171",
        "evlu_amt_smtl": "185550504",
        "tot_asst_amt": "1651869889547",
        "tot_lnda_tot_ulst_lnda": "0",
        "cma_auto_loan_amt": "0",
        "tot_mgln_amt": "0",
        "stln_evlu_amt": "0",
        "crdt_fncg_amt": "0",
        "ocl_apl_loan_amt": "0",
        "pldg_stup_amt": "0",
        "frcr_evlu_tota": "1651434483743",
        "tot_dncl_amt": "249855300",
        "cma_evlu_amt": "0",
        "dncl_amt": "249855300",
        "tot_sbst_amt": "0",
        "thdt_rcvb_amt": "0",
        "ovrs_stck_evlu_amt1": "185144504.000000",
        "ovrs_bond_evlu_amt": "0.000000",
        "mmf_cma_mgge_loan_amt": "0",
        "sbsc_dncl_amt": "0",
        "pbst_sbsc_fnds_loan_use_amt": "0",
        "etpr_crdt_grnt_loan_amt": "0"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0530",
    "msg1": "조회되었습니다                                                                  "
}

기간별매매손익현황조회[v1_국내주식-060]

REST

기간별매매손익현황조회[v1_국내주식-060]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/inquire-period-trade-profit
  • Format
     
  • Content-Type
     

개요

기간별매매손익현황조회 API입니다.
한국투자 HTS(eFriend Plus) > [0856] 기간별 매매손익 화면 에서 "종목별" 클릭 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

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 TTTC8715R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8
SORT_DVSN 정렬구분 String Y 2 00: 최근 순, 01: 과거 순, 02: 최근 순
ACNT_PRDT_CD 계좌상품코드 String Y 2
PDNO 상품번호 String Y 12 ""공란입력 시, 전체
INQR_STRT_DT 조회시작일자 String Y 8
INQR_END_DT 조회종료일자 String Y 8
CTX_AREA_NK100 연속조회키100 String Y 100
CBLC_DVSN 잔고구분 String Y 2 00: 전체
CTX_AREA_FK100 연속조회검색조건100 String Y 100

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
msg1 응답메세지 String Y 80
ctx_area_nk100 연속조회키100 String Y 100
ctx_area_fk100 연속조회검색조건100 String Y 100
output1 응답상세 Object Array Y array
-trad_dt 매매일자 String Y 8
-pdno 상품번호 String Y 12 종목번호(뒤 6자리만 해당)
-prdt_name 상품명 String Y 60
-trad_dvsn_name 매매구분명 String Y 60
-loan_dt 대출일자 String Y 8
-hldg_qty 보유수량 String Y 19
-pchs_unpr 매입단가 String Y 19
-buy_qty 매수수량 String Y 10
-buy_amt 매수금액 String Y 19
-sll_pric 매도가격 String Y 10
-sll_qty 매도수량 String Y 10
-sll_amt 매도금액 String Y 19
-rlzt_pfls 실현손익 String Y 19
-pfls_rt 손익률 String Y 238
-fee 수수료 String Y 19
-tl_tax 제세금 String Y 19
-loan_int 대출이자 String Y 19
output2 응답상세2 Object Y
-sll_qty_smtl 매도수량합계 String Y 19
-sll_tr_amt_smtl 매도거래금액합계 String Y 19
-sll_fee_smtl 매도수수료합계 String Y 19
-sll_tltx_smtl 매도제세금합계 String Y 19
-sll_excc_amt_smtl 매도정산금액합계 String Y 19
-buyqty_smtl 매수수량합계 String Y 8
-buy_tr_amt_smtl 매수거래금액합계 String Y 19
-buy_fee_smtl 매수수수료합계 String Y 19
-buy_tax_smtl 매수제세금합계 String Y 19
-buy_excc_amt_smtl 매수정산금액합계 String Y 19
-tot_qty 총수량 String Y 10
-tot_tr_amt 총거래금액 String Y 19
-tot_fee 총수수료 String Y 19
-tot_tltx 총제세금 String Y 19
-tot_excc_amt 총정산금액 String Y 19
-tot_rlzt_pfls 총실현손익 String Y 19
-loan_int 대출이자 String Y 19
-tot_pftrt 총수익률 String Y 238

Example

Request

{
"CANO":"12345678",
"ACNT_PRDT_CD":"01",
"PDNO":"",
"INQR_STRT_DT":"20240216",
"INQR_END_DT":"20240216",
"SORT_DVSN":"02",
"CBLC_DVSN":"00",
"CTX_AREA_FK100":""
"CTX_AREA_FK100":""
}

Response

{
    "ctx_area_fk100": "                                                                                                    ",
    "ctx_area_nk100": "20240216^00000A000120^300^0^00000000^                                                               ",
    "output1": [
        {
            "trad_dt": "20240216",
            "pdno": "000J2552221D",
            "prdt_name": "SG 17WR",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "135",
            "buy_qty": "2",
            "buy_amt": "271",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "000J00532219",
            "prdt_name": "국동 9WR",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "130",
            "buy_qty": "10",
            "buy_amt": "1300",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000Q520057",
            "prdt_name": "미래에셋 인버스 2X 코스닥150 선물 ETN",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "1",
            "pchs_unpr": "9365",
            "buy_qty": "1",
            "buy_amt": "9365",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A900270",
            "prdt_name": "헝셩그룹",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "66",
            "pchs_unpr": "322",
            "buy_qty": "66",
            "buy_amt": "21252",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A402340",
            "prdt_name": "SK스퀘어",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "59000",
            "buy_qty": "10",
            "buy_amt": "590000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A373220",
            "prdt_name": "LG에너지솔루션",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "552000",
            "buy_qty": "10",
            "buy_amt": "5520000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A361610",
            "prdt_name": "SK아이이테크놀로지",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "110000",
            "buy_qty": "10",
            "buy_amt": "1100000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A352820",
            "prdt_name": "하이브",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "383000",
            "buy_qty": "2",
            "buy_amt": "766000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A302440",
            "prdt_name": "SK바이오사이언스",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "100000",
            "buy_qty": "10",
            "buy_amt": "1000000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A298050",
            "prdt_name": "효성첨단소재",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "480000",
            "buy_qty": "2",
            "buy_amt": "960000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A298020",
            "prdt_name": "효성티앤씨",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "365000",
            "buy_qty": "2",
            "buy_amt": "730000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A285130",
            "prdt_name": "SK케미칼",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "100000",
            "buy_qty": "10",
            "buy_amt": "1000000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A136480",
            "prdt_name": "하림",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "220",
            "pchs_unpr": "2893",
            "buy_qty": "226",
            "buy_amt": "526563",
            "sll_pric": "2936",
            "sll_qty": "7",
            "sll_amt": "20555",
            "rlzt_pfls": "304",
            "pfls_rt": "1.50116044",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A114090",
            "prdt_name": "GKL",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "1",
            "pchs_unpr": "15010",
            "buy_qty": "1",
            "buy_amt": "15010",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A097950",
            "prdt_name": "CJ제일제당",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "210500",
            "buy_qty": "10",
            "buy_amt": "2105000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A096770",
            "prdt_name": "SK이노베이션",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "228000",
            "buy_qty": "10",
            "buy_amt": "2280000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A093370",
            "prdt_name": "후성",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "15510",
            "buy_qty": "2",
            "buy_amt": "31020",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A057050",
            "prdt_name": "현대홈쇼핑",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "30100",
            "buy_qty": "2",
            "buy_amt": "60200",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A047050",
            "prdt_name": "포스코인터내셔널",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "74400",
            "buy_qty": "2",
            "buy_amt": "148800",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A036460",
            "prdt_name": "한국가스공사",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "27850",
            "buy_qty": "2",
            "buy_amt": "55700",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A035760",
            "prdt_name": "CJ ENM",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "11",
            "pchs_unpr": "58836",
            "buy_qty": "11",
            "buy_amt": "647200",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A035420",
            "prdt_name": "NAVER",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "356000",
            "buy_qty": "10",
            "buy_amt": "3560000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A035250",
            "prdt_name": "강원랜드",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "20950",
            "buy_qty": "10",
            "buy_amt": "209500",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A034730",
            "prdt_name": "SK",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "182700",
            "buy_qty": "10",
            "buy_amt": "1827000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A030200",
            "prdt_name": "KT",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "26050",
            "buy_qty": "10",
            "buy_amt": "260500",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A028670",
            "prdt_name": "팬오션",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "4865",
            "buy_qty": "2",
            "buy_amt": "9730",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A028260",
            "prdt_name": "삼성물산",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "5",
            "pchs_unpr": "156100",
            "buy_qty": "5",
            "buy_amt": "780500",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A018260",
            "prdt_name": "삼성에스디에스",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "250000",
            "buy_qty": "2",
            "buy_amt": "500000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A017670",
            "prdt_name": "SK텔레콤",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "50100",
            "buy_qty": "10",
            "buy_amt": "501000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A015760",
            "prdt_name": "한국전력",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "4",
            "pchs_unpr": "8030",
            "buy_qty": "4",
            "buy_amt": "32120",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A011790",
            "prdt_name": "SKC",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "49950",
            "buy_qty": "10",
            "buy_amt": "499500",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A011780",
            "prdt_name": "금호석유",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "200000",
            "buy_qty": "10",
            "buy_amt": "2000000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A009540",
            "prdt_name": "HD한국조선해양",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "170000",
            "buy_qty": "10",
            "buy_amt": "1700000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A008770",
            "prdt_name": "호텔신라",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "99850",
            "buy_qty": "2",
            "buy_amt": "199700",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A006260",
            "prdt_name": "LS",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "122000",
            "buy_qty": "10",
            "buy_amt": "1220000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A005940",
            "prdt_name": "NH투자증권",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "11710",
            "buy_qty": "10",
            "buy_amt": "117100",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A005930",
            "prdt_name": "삼성전자",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "1414",
            "pchs_unpr": "53213",
            "buy_qty": "1415",
            "buy_amt": "75510700",
            "sll_pric": "75900",
            "sll_qty": "1",
            "sll_amt": "75900",
            "rlzt_pfls": "22687",
            "pfls_rt": "42.63431868",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A005490",
            "prdt_name": "POSCO홀딩스",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "133500",
            "buy_qty": "10",
            "buy_amt": "1335000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A005380",
            "prdt_name": "현대차",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "240500",
            "buy_qty": "2",
            "buy_amt": "481000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A004800",
            "prdt_name": "효성",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "66400",
            "buy_qty": "2",
            "buy_amt": "132800",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A003670",
            "prdt_name": "포스코퓨처엠",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "531000",
            "buy_qty": "2",
            "buy_amt": "1062000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A003550",
            "prdt_name": "LG",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "105600",
            "buy_qty": "2",
            "buy_amt": "211200",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A002380",
            "prdt_name": "KCC",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "1",
            "pchs_unpr": "252000",
            "buy_qty": "1",
            "buy_amt": "252000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A001120",
            "prdt_name": "LX인터내셔널",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "1",
            "pchs_unpr": "34050",
            "buy_qty": "1",
            "buy_amt": "34050",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000990",
            "prdt_name": "DB하이텍",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "23000",
            "buy_qty": "2",
            "buy_amt": "46000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000670",
            "prdt_name": "영풍",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "4",
            "pchs_unpr": "640750",
            "buy_qty": "4",
            "buy_amt": "2563000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000660",
            "prdt_name": "SK하이닉스",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "12",
            "pchs_unpr": "122583",
            "buy_qty": "10",
            "buy_amt": "1345000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000270",
            "prdt_name": "기아",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "84500",
            "buy_qty": "10",
            "buy_amt": "845000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000240",
            "prdt_name": "한국앤컴퍼니",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "2",
            "pchs_unpr": "23850",
            "buy_qty": "2",
            "buy_amt": "47700",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        },
        {
            "trad_dt": "20240216",
            "pdno": "00000A000210",
            "prdt_name": "DL",
            "trad_dvsn_name": "현금",
            "loan_dt": "",
            "hldg_qty": "10",
            "pchs_unpr": "50400",
            "buy_qty": "10",
            "buy_amt": "504000",
            "sll_pric": "0",
            "sll_qty": "0",
            "sll_amt": "0",
            "rlzt_pfls": "0",
            "pfls_rt": "0.00000000",
            "fee": "0",
            "tl_tax": "0",
            "loan_int": "0"
        }
    ],
    "output2": {
        "sll_qty_smtl": "8",
        "sll_tr_amt_smtl": "96455",
        "sll_fee_smtl": "0",
        "sll_tltx_smtl": "0",
        "sll_excc_amt_smtl": "96455",
        "buyqty_smtl": "2003",
        "buy_tr_amt_smtl": "116697331",
        "buy_fee_smtl": "0",
        "buy_tax_smtl": "0",
        "buy_excc_amt_smtl": "116697331",
        "tot_qty": "2011",
        "tot_tr_amt": "116793786",
        "tot_fee": "0",
        "tot_tltx": "0",
        "tot_excc_amt": "116793786",
        "tot_rlzt_pfls": "22991",
        "loan_int": "0",
        "tot_pftrt": "31.29560057"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0500",
    "msg1": "조회가 계속됩니다..다음버튼을 Click 하십시오.                                   "
}

기간별손익일별합산조회[v1_국내주식-052]

REST

기간별손익일별합산조회[v1_국내주식-052]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/inquire-period-profit
  • Format
     
  • Content-Type
     

개요

기간별손익일별합산조회 API입니다.
한국투자 HTS(eFriend Plus) > [0856] 기간별 매매손익 화면 에서 "일별" 클릭 시의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

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 TTTC8708R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
ACNT_PRDT_CD 계좌상품코드 String Y 2
CANO 종합계좌번호 String Y 8
INQR_STRT_DT 조회시작일자 String Y 8
PDNO 상품번호 String Y 12 ""공란입력 시, 전체
CTX_AREA_NK100 연속조회키100 String Y 100
INQR_END_DT 조회종료일자 String Y 8
SORT_DVSN 정렬구분 String Y 2 00: 최근 순, 01: 과거 순, 02: 최근 순
INQR_DVSN 조회구분 String Y 2 00 입력
CBLC_DVSN 잔고구분 String Y 2 00: 전체
CTX_AREA_FK100 연속조회검색조건100 String Y 100

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Array Y array
-trad_dt 매매일자 String Y 8
-buy_amt 매수금액 String Y 19
-sll_amt 매도금액 String Y 19
-rlzt_pfls 실현손익 String Y 19
-fee 수수료 String Y 19
-loan_int 대출이자 String Y 19
-tl_tax 제세금 String Y 19
-pfls_rt 손익률 String Y 238
-sll_qty1 매도수량1 String Y 19
-buy_qty1 매수수량1 String Y 9
output2 응답상세2 Object Y
-sll_qty_smtl 매도수량합계 String Y 19
-sll_tr_amt_smtl 매도거래금액합계 String Y 19
-sll_fee_smtl 매도수수료합계 String Y 19
-sll_tltx_smtl 매도제세금합계 String Y 19
-sll_excc_amt_smtl 매도정산금액합계 String Y 19
-buy_qty_smtl 매수수량합계 String Y 19
-buy_tr_amt_smtl 매수거래금액합계 String Y 19
-buy_fee_smtl 매수수수료합계 String Y 19
-buy_tax_smtl 매수제세금합계 String Y 19
-buy_excc_amt_smtl 매수정산금액합계 String Y 19
-tot_qty 총수량 String Y 10
-tot_tr_amt 총거래금액 String Y 19
-tot_fee 총수수료 String Y 19
-tot_tltx 총제세금 String Y 19
-tot_excc_amt 총정산금액 String Y 19
-tot_rlzt_pfls 총실현손익 String Y 19 ※ HTS[0856] 기간별 매매손익 '일별' 화면의 우측 하단 '총손익률' 항목은
기간별매매손익현황조회(TTTC8715R) > output2 > tot_pftrt(총수익률) 으로 확인 가능
-loan_int 대출이자 String Y 19

Example

Request

{
"CANO":"12345678",
"ACNT_PRDT_CD":"01",
"PDNO":"",
"INQR_STRT_DT":"20230101",
"INQR_END_DT":"20240220",
"SORT_DVSN":"00",
"INQR_DVSN":"00",
"CBLC_DVSN":"00",
"CTX_AREA_FK100":"",
"CTX_AREA_NK100":""
}

Response

{
    "ctx_area_fk100": "                                                                                                    ",
    "ctx_area_nk100": "                                                                                                    ",
    "output1": [
        {
            "trad_dt": "20240220",
            "buy_amt": "116697331",
            "sll_amt": "96455",
            "rlzt_pfls": "22991",
            "fee": "0",
            "loan_int": "0",
            "tl_tax": "0",
            "pfls_rt": "31.29560057",
            "sll_qty1": "8",
            "buy_qty1": "2003"
        }
    ],
    "output2": {
        "sll_qty_smtl": "8",
        "sll_tr_amt_smtl": "96455",
        "sll_fee_smtl": "0",
        "sll_tltx_smtl": "0",
        "sll_excc_amt_smtl": "96455",
        "buy_qty_smtl": "2003",
        "buy_tr_amt_smtl": "116697331",
        "buy_fee_smtl": "0",
        "buy_tax_smtl": "0",
        "buy_excc_amt_smtl": "116697331",
        "tot_qty": "2011",
        "tot_tr_amt": "116793786",
        "tot_fee": "0",
        "tot_tltx": "0",
        "tot_excc_amt": "116793786",
        "tot_rlzt_pfls": "22991",
        "loan_int": "0"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

매도가능수량조회 [국내주식-165]

REST

매도가능수량조회 [국내주식-165]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/inquire-psbl-sell
  • Format
     
  • Content-Type
     

개요

매도가능수량조회 API입니다.
한국투자 HTS(eFriend Plus) > [0971] 주식 매도 화면에서 종목코드 입력 후 "가능" 클릭 시 매도가능수량이 확인되는 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

특정종목 매도가능수량 확인 시, 매도주문 내시려는 주문종목(PDNO)으로 API 호출 후
output > ord_psbl_qty(주문가능수량) 확인하실 수 있습니다.

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 TTTC8408R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 종합계좌번호
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌상품코드
PDNO 종목번호 String Y 12 보유종목 코드 ex)000660

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Y
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-buy_qty 매수수량 String Y 10
-sll_qty 매도수량 String Y 10
-cblc_qty 잔고수량 String Y 19
-nsvg_qty 비저축수량 String Y 19
-ord_psbl_qty 주문가능수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 184
-pchs_amt 매입금액 String Y 19
-now_pric 현재가 String Y 8
-evlu_amt 평가금액 String Y 19
-evlu_pfls_amt 평가손익금액 String Y 19
-evlu_pfls_rt 평가손익율 String Y 72

Example

Request

CANO:12345678
ACNT_PRDT_CD:01
PDNO:005930

Response

{
    "output": {
        "pdno": "005930",
        "prdt_name": "삼성전자",
        "buy_qty": "1746",
        "sll_qty": "2",
        "cblc_qty": "1744",
        "nsvg_qty": "0",
        "ord_psbl_qty": "1744",
        "pchs_avg_pric": "54388.4874",
        "pchs_amt": "0",
        "now_pric": "75800",
        "evlu_amt": "132195200",
        "evlu_pfls_amt": "37341678",
        "evlu_pfls_rt": "39.36"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0420",
    "msg1": "정상적으로 조회되었습니다                                                       "
}

주식통합증거금 현황 [국내주식-191]

REST

주식통합증거금 현황 [국내주식-191]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/domestic-stock/v1/trading/intgr-margin
  • Format
     
  • Content-Type
     

개요

주식통합증거금 현황 API입니다.
한국투자 HTS(eFriend Plus) > [0867] 통합증거금조회 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

※ 해당 화면은 일반계좌와 통합증거금 신청계좌에 대해서 국내 및 해외 주문가능금액을 간단하게 조회하는 화면입니다.
※ 해외 국가별 상세한 증거금현황을 원하시면 [해외주식] 주문/계좌 > 해외증거금 통화별조회 API를 이용하여 주시기 바랍니다.

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 TTTC0869R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
CMA_EVLU_AMT_ICLD_YN CMA평가금액포함여부 String Y 1 N 입력
WCRC_FRCR_DVSN_CD 원화외화구분코드 String Y 2 01(외화기준),02(원화기준)
FWEX_CTRT_FRCR_DVSN_CD 선도환계약외화구분코드 String Y 2 01(외화기준),02(원화기준)

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Y
-acmga_rt 계좌증거금율 String Y 11.4
-acmga_pct100_aptm_rson 계좌증거금100퍼센트지정사유 String Y 100
-stck_cash_objt_amt 주식현금대상금액 String Y 18.4
-stck_sbst_objt_amt 주식대용대상금액 String Y 18.4
-stck_evlu_objt_amt 주식평가대상금액 String Y 18.4
-stck_ruse_psbl_objt_amt 주식재사용가능대상금액 String Y 18.4
-stck_fund_rpch_chgs_objt_amt 주식펀드환매대금대상금액 String Y 18.4
-stck_fncg_rdpt_objt_atm 주식융자상환금대상금액 String Y 18.4
-bond_ruse_psbl_objt_amt 채권재사용가능대상금액 String Y 18.4
-stck_cash_use_amt 주식현금사용금액 String Y 18.4
-stck_sbst_use_amt 주식대용사용금액 String Y 18.4
-stck_evlu_use_amt 주식평가사용금액 String Y 18.4
-stck_ruse_psbl_amt_use_amt 주식재사용가능금사용금액 String Y 18.4
-stck_fund_rpch_chgs_use_amt 주식펀드환매대금사용금액 String Y 18.4
-stck_fncg_rdpt_amt_use_amt 주식융자상환금사용금액 String Y 18.4
-bond_ruse_psbl_amt_use_amt 채권재사용가능금사용금액 String Y 18.4
-stck_cash_ord_psbl_amt 주식현금주문가능금액 String Y 18.4
-stck_sbst_ord_psbl_amt 주식대용주문가능금액 String Y 18.4
-stck_evlu_ord_psbl_amt 주식평가주문가능금액 String Y 18.4
-stck_ruse_psbl_ord_psbl_amt 주식재사용가능주문가능금액 String Y 18.4
-stck_fund_rpch_ord_psbl_amt 주식펀드환매주문가능금액 String Y 18.4
-bond_ruse_psbl_ord_psbl_amt 채권재사용가능주문가능금액 String Y 18.4
-rcvb_amt 미수금액 String Y 19
-stck_loan_grta_ruse_psbl_amt 주식대출보증금재사용가능금액 String Y 18.4
-stck_cash20_max_ord_psbl_amt 주식현금20최대주문가능금액 String Y 18.4
-stck_cash30_max_ord_psbl_amt 주식현금30최대주문가능금액 String Y 18.4
-stck_cash40_max_ord_psbl_amt 주식현금40최대주문가능금액 String Y 18.4
-stck_cash50_max_ord_psbl_amt 주식현금50최대주문가능금액 String Y 18.4
-stck_cash60_max_ord_psbl_amt 주식현금60최대주문가능금액 String Y 18.4
-stck_cash100_max_ord_psbl_amt 주식현금100최대주문가능금액 String Y 18.4
-stck_rsip100_max_ord_psbl_amt 주식재사용불가100최대주문가능 String Y 18.4
-bond_max_ord_psbl_amt 채권최대주문가능금액 String Y 18.4
-stck_fncg45_max_ord_psbl_amt 주식융자45최대주문가능금액 String Y 18.2
-stck_fncg50_max_ord_psbl_amt 주식융자50최대주문가능금액 String Y 18.4
-stck_fncg60_max_ord_psbl_amt 주식융자60최대주문가능금액 String Y 18.4
-stck_fncg70_max_ord_psbl_amt 주식융자70최대주문가능금액 String Y 18.2
-stck_stln_max_ord_psbl_amt 주식대주최대주문가능금액 String Y 18.4
-lmt_amt 한도금액 String Y 19
-ovrs_stck_itgr_mgna_dvsn_name 해외주식통합증거금구분명 String Y 40
-usd_objt_amt 미화대상금액 String Y 18.2
-usd_use_amt 미화사용금액 String Y 18.2
-usd_ord_psbl_amt 미화주문가능금액 String Y 18.2
-hkd_objt_amt 홍콩달러대상금액 String Y 18.2
-hkd_use_amt 홍콩달러사용금액 String Y 18.2
-hkd_ord_psbl_amt 홍콩달러주문가능금액 String Y 18.2
-jpy_objt_amt 엔화대상금액 String Y 18.2
-jpy_use_amt 엔화사용금액 String Y 18.2
-jpy_ord_psbl_amt 엔화주문가능금액 String Y 18.2
-cny_objt_amt 위안화대상금액 String Y 18.2
-cny_use_amt 위안화사용금액 String Y 18.2
-cny_ord_psbl_amt 위안화주문가능금액 String Y 18.2
-usd_ruse_objt_amt 미화재사용대상금액 String Y 18.2
-usd_ruse_amt 미화재사용금액 String Y 18.2
-usd_ruse_ord_psbl_amt 미화재사용주문가능금액 String Y 18.2
-hkd_ruse_objt_amt 홍콩달러재사용대상금액 String Y 18.2
-hkd_ruse_amt 홍콩달러재사용금액 String Y 18.2
-hkd_ruse_ord_psbl_amt 홍콩달러재사용주문가능금액 String Y 17.2
-jpy_ruse_objt_amt 엔화재사용대상금액 String Y 18.2
-jpy_ruse_amt 엔화재사용금액 String Y 18.2
-jpy_ruse_ord_psbl_amt 엔화재사용주문가능금액 String Y 18.2
-cny_ruse_objt_amt 위안화재사용대상금액 String Y 18.2
-cny_ruse_amt 위안화재사용금액 String Y 18.2
-cny_ruse_ord_psbl_amt 위안화재사용주문가능금액 String Y 18.2
-usd_gnrl_ord_psbl_amt 미화일반주문가능금액 String Y 18.2
-usd_itgr_ord_psbl_amt 미화통합주문가능금액 String Y 18.2
-hkd_gnrl_ord_psbl_amt 홍콩달러일반주문가능금액 String Y 18.2
-hkd_itgr_ord_psbl_amt 홍콩달러통합주문가능금액 String Y 18.2
-jpy_gnrl_ord_psbl_amt 엔화일반주문가능금액 String Y 18.2
-jpy_itgr_ord_psbl_amt 엔화통합주문가능금액 String Y 18.2
-cny_gnrl_ord_psbl_amt 위안화일반주문가능금액 String Y 18.2
-cny_itgr_ord_psbl_amt 위안화통합주문가능금액 String Y 18.2
-stck_itgr_cash20_ord_psbl_amt 주식통합현금20주문가능금액 String Y 18.2
-stck_itgr_cash30_ord_psbl_amt 주식통합현금30주문가능금액 String Y 18.2
-stck_itgr_cash40_ord_psbl_amt 주식통합현금40주문가능금액 String Y 18.2
-stck_itgr_cash50_ord_psbl_amt 주식통합현금50주문가능금액 String Y 18.2
-stck_itgr_cash60_ord_psbl_amt 주식통합현금60주문가능금액 String Y 18.2
-stck_itgr_cash100_ord_psbl_amt 주식통합현금100주문가능금액 String Y 18.2
-stck_itgr_100_ord_psbl_amt 주식통합100주문가능금액 String Y 18.2
-stck_itgr_fncg45_ord_psbl_amt 주식통합융자45주문가능금액 String Y 18.2
-stck_itgr_fncg50_ord_psbl_amt 주식통합융자50주문가능금액 String Y 18.2
-stck_itgr_fncg60_ord_psbl_amt 주식통합융자60주문가능금액 String Y 18.2
-stck_itgr_fncg70_ord_psbl_amt 주식통합융자70주문가능금액 String Y 18.2
-stck_itgr_stln_ord_psbl_amt 주식통합대주주문가능금액 String Y 18.2
-bond_itgr_ord_psbl_amt 채권통합주문가능금액 String Y 18.2
-stck_cash_ovrs_use_amt 주식현금해외사용금액 String Y 18.2
-stck_sbst_ovrs_use_amt 주식대용해외사용금액 String Y 18.2
-stck_evlu_ovrs_use_amt 주식평가해외사용금액 String Y 18.2
-stck_re_use_amt_ovrs_use_amt 주식재사용금액해외사용금액 String Y 18.2
-stck_fund_rpch_ovrs_use_amt 주식펀드환매해외사용금액 String Y 18.2
-stck_fncg_rdpt_ovrs_use_amt 주식융자상환해외사용금액 String Y 18.2
-bond_re_use_ovrs_use_amt 채권재사용해외사용금액 String Y 18.2
-usd_oth_mket_use_amt 미화타시장사용금액 String Y 18.2
-jpy_oth_mket_use_amt 엔화타시장사용금액 String Y 18.2
-cny_oth_mket_use_amt 위안화타시장사용금액 String Y 18.2
-hkd_oth_mket_use_amt 홍콩달러타시장사용금액 String Y 18.2
-usd_re_use_oth_mket_use_amt 미화재사용타시장사용금액 String Y 18.2
-jpy_re_use_oth_mket_use_amt 엔화재사용타시장사용금액 String Y 18.2
-cny_re_use_oth_mket_use_amt 위안화재사용타시장사용금액 String Y 18.2
-hkd_re_use_oth_mket_use_amt 홍콩달러재사용타시장사용금액 String Y 18.2
-hgkg_cny_re_use_amt 홍콩위안화재사용금액 String Y 18.2

Example

Request

CANO:12345678
ACNT_PRDT_CD:01
CMA_EVLU_AMT_ICLD_YN:N
WCRC_FRCR_DVSN_CD:01
FWEX_CTRT_FRCR_DVSN_CD:01

Response

{
    "output": {
        "acmga_rt": "100.0000",
        "acmga_pct100_aptm_rson": "고객100%신청",
        "stck_cash_objt_amt": "249855306.0000",
        "stck_sbst_objt_amt": "137816.0000",
        "stck_evlu_objt_amt": "176966.0000",
        "stck_ruse_psbl_objt_amt": "261213.0000",
        "stck_fund_rpch_chgs_objt_amt": "0.0000",
        "stck_fncg_rdpt_objt_atm": "0.0000",
        "bond_ruse_psbl_objt_amt": "1024.0000",
        "stck_cash_use_amt": "240482730.0000",
        "stck_sbst_use_amt": "20295.0000",
        "stck_evlu_use_amt": "20295.0000",
        "stck_ruse_psbl_amt_use_amt": "261213.0000",
        "stck_fund_rpch_chgs_use_amt": "0.0000",
        "stck_fncg_rdpt_amt_use_amt": "0.0000",
        "bond_ruse_psbl_amt_use_amt": "1024.0000",
        "stck_cash_ord_psbl_amt": "9372576.0000",
        "stck_sbst_ord_psbl_amt": "117521.0000",
        "stck_evlu_ord_psbl_amt": "156671.0000",
        "stck_ruse_psbl_ord_psbl_amt": "0.0000",
        "stck_fund_rpch_ord_psbl_amt": "0.0000",
        "bond_ruse_psbl_ord_psbl_amt": "0.0000",
        "rcvb_amt": "0",
        "stck_loan_grta_ruse_psbl_amt": "0.0000",
        "stck_cash20_max_ord_psbl_amt": "8128560.1990",
        "stck_cash30_max_ord_psbl_amt": "8128560.1990",
        "stck_cash40_max_ord_psbl_amt": "8128560.1990",
        "stck_cash50_max_ord_psbl_amt": "8128560.1990",
        "stck_cash60_max_ord_psbl_amt": "8128560.1990",
        "stck_cash100_max_ord_psbl_amt": "8128560.1990",
        "stck_rsip100_max_ord_psbl_amt": "8128560.1990",
        "bond_max_ord_psbl_amt": "9316675.9443",
        "stck_fncg45_max_ord_psbl_amt": "20942905.49",
        "stck_fncg50_max_ord_psbl_amt": "18869350.4950",
        "stck_fncg60_max_ord_psbl_amt": "15750449.5868",
        "stck_fncg70_max_ord_psbl_amt": "13516343.26",
        "stck_stln_max_ord_psbl_amt": "9307424.0318",
        "lmt_amt": "0",
        "ovrs_stck_itgr_mgna_dvsn_name": "",
        "usd_objt_amt": "0.00",
        "usd_use_amt": "0.00",
        "usd_ord_psbl_amt": "0.00",
        "hkd_objt_amt": "0.00",
        "hkd_use_amt": "0.00",
        "hkd_ord_psbl_amt": "0.00",
        "jpy_objt_amt": "0.00",
        "jpy_use_amt": "0.00",
        "jpy_ord_psbl_amt": "0.00",
        "cny_objt_amt": "0.00",
        "cny_use_amt": "0.00",
        "cny_ord_psbl_amt": "0.00",
        "usd_ruse_objt_amt": "0.00",
        "usd_ruse_amt": "0.00",
        "usd_ruse_ord_psbl_amt": "0.00",
        "hkd_ruse_objt_amt": "0.00",
        "hkd_ruse_amt": "0.00",
        "hkd_ruse_ord_psbl_amt": "0.00",
        "jpy_ruse_objt_amt": "0.00",
        "jpy_ruse_amt": "0.00",
        "jpy_ruse_ord_psbl_amt": "0.00",
        "cny_ruse_objt_amt": "0.00",
        "cny_ruse_amt": "0.00",
        "cny_ruse_ord_psbl_amt": "0.00",
        "usd_gnrl_ord_psbl_amt": "0.00",
        "usd_itgr_ord_psbl_amt": "0.00",
        "hkd_gnrl_ord_psbl_amt": "0.00",
        "hkd_itgr_ord_psbl_amt": "0.00",
        "jpy_gnrl_ord_psbl_amt": "0.00",
        "jpy_itgr_ord_psbl_amt": "0.00",
        "cny_gnrl_ord_psbl_amt": "0.00",
        "cny_itgr_ord_psbl_amt": "0.00",
        "stck_itgr_cash20_ord_psbl_amt": "0.00",
        "stck_itgr_cash30_ord_psbl_amt": "0.00",
        "stck_itgr_cash40_ord_psbl_amt": "0.00",
        "stck_itgr_cash50_ord_psbl_amt": "0.00",
        "stck_itgr_cash60_ord_psbl_amt": "0.00",
        "stck_itgr_cash100_ord_psbl_amt": "0.00",
        "stck_itgr_100_ord_psbl_amt": "0.00",
        "stck_itgr_fncg45_ord_psbl_amt": "0.00",
        "stck_itgr_fncg50_ord_psbl_amt": "0.00",
        "stck_itgr_fncg60_ord_psbl_amt": "0.00",
        "stck_itgr_fncg70_ord_psbl_amt": "0.00",
        "stck_itgr_stln_ord_psbl_amt": "0.00",
        "bond_itgr_ord_psbl_amt": "0.00",
        "stck_cash_ovrs_use_amt": "0.00",
        "stck_sbst_ovrs_use_amt": "0.00",
        "stck_evlu_ovrs_use_amt": "0.00",
        "stck_re_use_amt_ovrs_use_amt": "0.00",
        "stck_fund_rpch_ovrs_use_amt": "0.00",
        "stck_fncg_rdpt_ovrs_use_amt": "0.00",
        "bond_re_use_ovrs_use_amt": "0.00",
        "usd_oth_mket_use_amt": "0.00",
        "jpy_oth_mket_use_amt": "0.00",
        "cny_oth_mket_use_amt": "0.00",
        "hkd_oth_mket_use_amt": "0.00",
        "usd_re_use_oth_mket_use_amt": "0.00",
        "jpy_re_use_oth_mket_use_amt": "0.00",
        "cny_re_use_oth_mket_use_amt": "0.00",
        "hkd_re_use_oth_mket_use_amt": "0.00",
        "hgkg_cny_re_use_amt": "0.00",
        "hgkg_cny_re_use_objt_amt": "0.00",
        "hgkg_cny_re_use_ord_psbl_amt": "0.00",
        "hgkg_cny_re_use_oth_use_amt": "0.00"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0510",
    "msg1": "조회가 완료되었습니다                                                           "
}

기간별계좌권리현황조회 [국내주식-211]

REST

기간별계좌권리현황조회 [국내주식-211]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/trading/period-rights
  • Format
     
  • Content-Type
     

개요

기간별계좌권리현황조회 API입니다.
한국투자 HTS(eFriend Plus) > [7344] 권리유형별 현황조회 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

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 CTRGA011R
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해야 함

Query Parameter

Element 한글명 Type Required Length Description
INQR_DVSN 조회구분 String Y 2 03 입력
CUST_RNCNO25 고객실명확인번호25 String Y 25 공란
HMID 홈넷ID String Y 8 공란
CANO 종합계좌번호 String Y 8 계좌번호 8자리 입력 (ex.12345678)
ACNT_PRDT_CD 계좌상품코드 String Y 2 상품계좌번호 2자리 입력(ex. 01 or 22)
INQR_STRT_DT 조회시작일자 String Y 8 조회시작일자(YYYYMMDD)
INQR_END_DT 조회종료일자 String Y 8 조회종료일자(YYYYMMDD)
RGHT_TYPE_CD 권리유형코드 String Y 2 공란
PDNO 상품번호 String Y 12 공란
PRDT_TYPE_CD 상품유형코드 String Y 3 공란
CTX_AREA_NK100 연속조회키100 String Y 100 다음조회시 입력
CTX_AREA_FK100 연속조회검색조건100 String Y 100 다음조회시 입력

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
msg1 응답메세지 String Y 80
output1 응답상세 Object Array Y array
-acno10 계좌번호10 String Y 10
-rght_type_cd 권리유형코드 String Y 2 1 유상
2 무상
3 배당
4 매수청구
5 공개매수
6 주주총회
7 신주인수권증서
8 반대의사
9 신주인수권증권
11 합병
12 회사분할
13 주식교환
14 액면분할
15 액면병합
16 종목변경
17 감자
18 신구주합병
21 후합병
22 후회사분할
23 후주식교환
24 후액면분할
25 후액면병합
26 후종목변경
27 후감자
28 후신구주합병
31 뮤츄얼펀드
32 ETF
33 선박투자회사
34 투융자회사
35 해외자원
36 부동산신탁(Ritz)
37 상장수익증권
41 ELW만기
42 ELS분배
43 DLS분배
44 하일드펀드
45 ETN
51 전환청구
52 교환청구
53 BW청구
54 WRT청구
55 채권풋옵션청구
56 전환우선주청구
57 전환조건부청구
58 전자증권일괄입고
59 클라우드펀딩일괄입고
61 원리금상환
62 스트립채권
71 WRT소멸
72 WRT증권
73 DR전환
74 배당옵션
75 특별배당
76 ISINCODE변경
77 실권주청약
81 해외분배금(청산)
82 해외분배금(조기상환)
83 해외분배금(상장폐지)
84 DR FEE
85 SECTION 871M
86 종목전환
87 재매수
88 종목교환
89 기타이벤트
91 공모주
92 청약
93 환매
99 기타권리사유
-bass_dt 기준일자 String Y 8
-rght_cblc_type_cd 권리잔고유형코드 String Y 2 1 입고
2 출고
3 출고입고
4 출고입금
5 출고출금
10 현금입금
11 단수주대금입금
12 교부금입금
13 유상감자대금입금
14 지연이자입금
15 이자지급
16 대주권리금출금
17 분할상환
18 만기상환
19 조기상환
20 출금
21 입고&입금
22 입고&입금&단수주대금입금
25 유상환불금입금
26 중도상환
27 분할합병세금출금
-rptt_pdno 대표상품번호 String Y 12
-pdno 상품번호 String Y 12
-prdt_type_cd 상품유형코드 String Y 3
-shtn_pdno 단축상품번호 String Y 12
-prdt_name 상품명 String Y 60
-cblc_qty 잔고수량 String Y 19
-last_alct_qty 최종배정수량 String Y 19
-excs_alct_qty 초과배정수량 String Y 19
-tot_alct_qty 총배정수량 String Y 19
-last_ftsk_qty 최종단수주수량 String Y 19.1
-last_alct_amt 최종배정금액 String Y 19
-last_ftsk_chgs 최종단수주대금 String Y 19
-rdpt_prca 상환원금 String Y 19
-dlay_int_amt 지연이자금액 String Y 19
-lstg_dt 상장일자 String Y 8
-sbsc_end_dt 청약종료일자 String Y 8
-cash_dfrm_dt 현금지급일자 String Y 8
-rqst_qty 신청수량 String Y 19
-rqst_amt 신청금액 String Y 19
-rqst_dt 신청일자 String Y 8
-rfnd_dt 환불일자 String Y 8
-rfnd_amt 환불금액 String Y 19
-lstg_stqt 상장주수 String Y 19
-tax_amt 세금금액 String Y 19
-sbsc_unpr 청약단가 String Y 22.4

Example

Request

INQR_DVSN:03
CUST_RNCNO25:
HMID:
CANO:12345678
ACNT_PRDT_CD:01
INQR_STRT_DT:20240508
INQR_END_DT:20241106
RGHT_TYPE_CD:
PDNO:
PRDT_TYPE_CD:
CTX_AREA_NK100:
CTX_AREA_FK100:

Response

{
    "ctx_area_nk100": "                                                                                                    ",
    "ctx_area_fk100": "03!^!^!^12345678!^01!^20240508!^20241106!^!^!^                                                      ",
    "output": [
        {
            "acno10": "1234567801",
            "rght_type_cd": "01",
            "bass_dt": "20240919",
            "rght_cblc_type_cd": "01",
            "rptt_pdno": "00000A357880",
            "pdno": "00000A357880",
            "prdt_type_cd": "300",
            "shtn_pdno": "357880",
            "prdt_name": "비트나인",
            "cblc_qty": "1000",
            "last_alct_qty": "1050",
            "excs_alct_qty": "0",
            "tot_alct_qty": "1050",
            "last_ftsk_qty": "0.0000000000",
            "last_alct_amt": "0",
            "last_ftsk_chgs": "0",
            "rdpt_prca": "0",
            "dlay_int_amt": "0",
            "lstg_dt": "",
            "sbsc_end_dt": "20241011",
            "cash_dfrm_dt": "",
            "rqst_qty": "1000",
            "rqst_amt": "1865000",
            "rqst_dt": "20241011",
            "rfnd_dt": "",
            "rfnd_amt": "0",
            "lstg_stqt": "0",
            "tax_amt": "0",
            "sbsc_unpr": "1865.0000"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "KIOK0460",
    "msg1": "조회 되었습니다. (마지막 자료)                                                  "
}