API 문서 HOME API 문서 [국내선물옵션] 주문/계좌
[국내선물옵션] 주문/계좌
선물옵션 주문[v1_국내선물-001]
REST
선물옵션 주문[v1_국내선물-001]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/trading/order
- FormatJSON
- Content-Typeapplication/json; charset=UTF-8
개요
선물옵션 주문 API입니다.
* 선물옵션 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
* 선물옵션 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
※ 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 | 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 절차를 준용) ※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출 EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | [실전투자]
TTTO1101U : 선물 옵션 매수 매도 주문 주간 JTCE1001U : 선물 옵션 매수 매도 주문 야간 [모의투자] VTTO1101U : 선물 옵션 매수 매도 주문 주간 |
| 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 |
|---|---|---|---|---|---|
| ORD_PRCS_DVSN_CD | 주문처리구분코드 | String | Y | 2 | 02 : 주문전송 |
| CANO | 종합계좌번호 | String | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | String | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | String | Y | 2 | 01 : 매도
02 : 매수 |
| SHTN_PDNO | 단축상품번호 | String | Y | 12 | 종목번호
선물 6자리 (예: 101S03) 옵션 9자리 (예: 201S03370) |
| ORD_QTY | 주문수량 | String | Y | 10 | |
| UNIT_PRICE | 주문가격1 | String | Y | 23 | 시장가나 최유리 지정가인 경우 0으로 입력 |
| NMPR_TYPE_CD | 호가유형코드 | String | N | 2 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨
01 : 지정가 02 : 시장가 03 : 조건부 04 : 최유리 |
| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | String | N | 1 | ※ ORD_DVSN_CD(주문구분코드)를 입력한 경우 ""(공란)으로 입력해도 됨
0 : 없음 3 : IOC 4 : FOK |
| CTAC_TLNO | 연락전화번호 | String | N | 20 | 고객의 연락 가능한 전화번호 |
| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | String | N | 2 | 공란(Default) |
| ORD_DVSN_CD | 주문구분코드 | String | Y | 2 | 01 : 지정가
02 : 시장가 03 : 조건부 04 : 최유리, 10 : 지정가(IOC) 11 : 지정가(FOK) 12 : 시장가(IOC) 13 : 시장가(FOK) 14 : 최유리(IOC) 15 : 최유리(FOK) |
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 |
| 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 | ||
| -ACNT_NAME | 계좌명 | String | Y | 60 | 계좌의 고객명 |
| -TRAD_DVSN_NAME | 매매구분명 | String | Y | 60 | 매도/매수 등 구분값 |
| -ITEM_NAME | 종목명 | String | Y | 60 | 주문 종목 명칭 |
| -ORD_TMD | 주문시각 | String | Y | 6 | 주문 접수 시간 |
| -ORD_GNO_BRNO | 주문채번지점번호 | String | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| -ODNO | 주문번호 | String | Y | 10 | 접수한 주문의 일련번호 |
Example
Request
{
"ORD_PRCS_DVSN_CD":"02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"SLL_BUY_DVSN_CD":"02",
"SHTN_PDNO":"167R12",
"ORD_QTY":"1",
"UNIT_PRICE":"123",
"NMPR_TYPE_CD":"",
"KRX_NMPR_CNDT_CD":"",
"CTAC_TLNO":"",
"FUOP_ITEM_DVSN_CD":"",
"ORD_DVSN_CD":"01"
}
"ORD_PRCS_DVSN_CD":"02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"SLL_BUY_DVSN_CD":"02",
"SHTN_PDNO":"167R12",
"ORD_QTY":"1",
"UNIT_PRICE":"123",
"NMPR_TYPE_CD":"",
"KRX_NMPR_CNDT_CD":"",
"CTAC_TLNO":"",
"FUOP_ITEM_DVSN_CD":"",
"ORD_DVSN_CD":"01"
}
Response
{
"rt_cd": "0",
"msg_cd": "APBK0029",
"msg1": "주문전송이 정상적으로 처리되었습니다.",
"output": {
"ACNT_NAME": "류민수",
"TRAD_DVSN_NAME": "매도",
"ITEM_NAME": "코스피200 F 202203",
"ORD_TMD": "131604",
"ORD_GNO_BRNO": "06010",
"ODNO": "0000007045"
}
}
"rt_cd": "0",
"msg_cd": "APBK0029",
"msg1": "주문전송이 정상적으로 처리되었습니다.",
"output": {
"ACNT_NAME": "류민수",
"TRAD_DVSN_NAME": "매도",
"ITEM_NAME": "코스피200 F 202203",
"ORD_TMD": "131604",
"ORD_GNO_BRNO": "06010",
"ODNO": "0000007045"
}
}
선물옵션 정정취소주문[v1_국내선물-002]
REST
선물옵션 정정취소주문[v1_국내선물-002]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/trading/order-rvsecncl
- FormatJSON
- Content-Typeapplication/json; charset=UTF-8
개요
선물옵션 주문 건에 대하여 정정 및 취소하는 API입니다. 단, 이미 체결된 건은 정정 및 취소가 불가합니다.
※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)
※ 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 절차를 준용) ※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출 EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | [실전투자]
TTTO1103U : 선물 옵션 정정 취소 주문 주간 JTCE1002U : 선물 옵션 정정 취소 주문 야간 [모의투자] VTTO1103U : 선물 옵션 정정 취소 주문 주간 |
| 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 |
|---|---|---|---|---|---|
| ORD_PRCS_DVSN_CD | 주문처리구분코드 | String | Y | 2 | 02 : 주문전송 |
| CANO | 종합계좌번호 | String | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | String | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| RVSE_CNCL_DVSN_CD | 정정취소구분코드 | String | Y | 2 | 01 : 정정
02 : 취소 |
| ORGN_ODNO | 원주문번호 | String | Y | 10 | 정정 혹은 취소할 주문의 번호 |
| ORD_QTY | 주문수량 | String | Y | 10 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]
전량일경우 0으로 입력 [Header tr_id JTCE1002U(선물옵션 정정취소 야간)] 일부수량 정정 및 취소 불가, 주문수량 반드시 입력 (공백 불가) 일부 미체결 시 잔량 전체에 대해서 취소 가능 EX) 2개 매수주문 후 1개 체결, 1개 미체결인 상태에서 취소주문 시 ORD_QTY는 1로 입력 ※ 모의계좌의 경우, 주문수량 반드시 입력 (공백 불가) |
| UNIT_PRICE | 주문가격1 | String | Y | 23 | 시장가나 최유리의 경우 0으로 입력 (취소 시에도 0 입력) |
| NMPR_TYPE_CD | 호가유형코드 | String | Y | 2 | 01 : 지정가
02 : 시장가 03 : 조건부 04 : 최유리 |
| KRX_NMPR_CNDT_CD | 한국거래소호가조건코드 | String | Y | 1 | 취소시 0으로 입력
정정시 0 : 없음 3 : IOC 4 : FOK |
| RMN_QTY_YN | 잔여수량여부 | String | Y | 1 | Y : 전량
N : 일부 |
| FUOP_ITEM_DVSN_CD | 선물옵션종목구분코드 | String | N | 2 | [Header tr_id TTTO1103U(선물옵션 정정취소 주간)]
공란(Default) [Header tr_id JTCE1002U(선물옵션 정정취소 야간)] 01 : 선물 02 : 콜옵션 03 : 풋옵션 04 : 스프레드 |
| ORD_DVSN_CD | 주문구분코드 | String | Y | 2 | [정정]
01 : 지정가 02 : 시장가 03 : 조건부 04 : 최유리, 10 : 지정가(IOC) 11 : 지정가(FOK) 12 : 시장가(IOC) 13 : 시장가(FOK) 14 : 최유리(IOC) 15 : 최유리(FOK) [취소] 01 로 입력 |
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 |
| 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 | ||
| -ACNT_NAME | 계좌명 | String | Y | 60 | 계좌의 고객명 |
| -TRAD_DVSN_NAME | 매매구분명 | String | Y | 60 | 매도/매수 등 구분값 |
| -ITEM_NAME | 종목명 | String | Y | 60 | 주문 종목 명칭 |
| -ORD_TMD | 주문시각 | String | Y | 6 | 주문 접수 시간 |
| -ORD_GNO_BRNO | 주문채번지점번호 | String | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| -ORGN_ODNO | 원주문번호 | String | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
| -ODNO | 주문번호 | String | Y | 10 | 접수한 주문(정정 또는 취소)의 일련번호 |
Example
Request
{
"ORD_PRCS_DVSN_CD": "02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "03",
"RVSE_CNCL_DVSN_CD": "02",
"ORGN_ODNO": "0000005605",
"ORD_QTY": "1",
"UNIT_PRICE": "460.00",
"NMPR_TYPE_CD": "",
"KRX_NMPR_CNDT_CD": "",
"RMN_QTY_YN": "N",
"CTAC_TLNO": "000 00000000",
"FUOP_ITEM_DVSN_CD": "",
"ORD_DVSN_CD": "01"
}
"ORD_PRCS_DVSN_CD": "02",
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "03",
"RVSE_CNCL_DVSN_CD": "02",
"ORGN_ODNO": "0000005605",
"ORD_QTY": "1",
"UNIT_PRICE": "460.00",
"NMPR_TYPE_CD": "",
"KRX_NMPR_CNDT_CD": "",
"RMN_QTY_YN": "N",
"CTAC_TLNO": "000 00000000",
"FUOP_ITEM_DVSN_CD": "",
"ORD_DVSN_CD": "01"
}
선물옵션 주문체결내역조회[v1_국내선물-003]
REST
선물옵션 주문체결내역조회[v1_국내선물-003]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/trading/inquire-ccnl
- FormatJSON
- Content-Typeapplication/json; charset=utf-8
개요
선물옵션 주문체결내역조회 API입니다. 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
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 | [실전투자]
TTTO5201R : 선물 옵션 주문 체결 내역 조회 [모의투자] VTTO5201R : 선물 옵션 주문 체결 내역 조회 |
| 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자리 |
| STRT_ORD_DT | 시작주문일자 | String | Y | 8 | 주문내역 조회 시작 일자, YYYYMMDD |
| END_ORD_DT | 종료주문일자 | String | Y | 8 | 주문내역 조회 마지막 일자, YYYYMMDD |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | String | Y | 2 | 00 : 전체
01 : 매도 02 : 매수 |
| CCLD_NCCS_DVSN | 체결미체결구분 | String | Y | 2 | 00 : 전체
01 : 체결 02 : 미체결 |
| SORT_SQN | 정렬순서 | String | Y | 2 | AS : 정순
DS : 역순 |
| STRT_ODNO | 시작주문번호 | String | Y | 10 | 조회 시작 번호 입력 |
| PDNO | 상품번호 | String | Y | 12 | 공란 시, 전체 조회
선물 6자리 (예: 101S03) 옵션 9자리 (예: 201S03370) |
| MKET_ID_CD | 시장ID코드 | String | Y | 3 | 공란(Default) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(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_fk200 | 연속조회검색조건200 | String | Y | 200 | |
| ctx_area_nk200 | 연속조회키200 | String | Y | 200 | |
| output1 | 응답상세1 | Array | Y | ||
| -ord_gno_brno | 주문채번지점번호 | String | Y | 5 | 계좌 개설 시 관리점으로 선택한 영업점의 고유번호 |
| -cano | 종합계좌번호 | String | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| -csac_name | 종합계좌명 | String | Y | 60 | 계좌의 고객명 |
| -acnt_prdt_cd | 계좌상품코드 | String | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| -ord_dt | 주문일자 | String | Y | 8 | 주문의 접수일자 |
| -odno | 주문번호 | String | Y | 10 | 접수한 주문의 일련번호 |
| -orgn_odno | 원주문번호 | String | Y | 10 | 정정 또는 취소 대상 주문의 일련번호 |
| -sll_buy_dvsn_cd | 매도매수구분코드 | String | Y | 2 | 00 : 전체
01 : 매도 02 : 매수 |
| -trad_dvsn_name | 매매구분명 | String | Y | 60 | 매도/매수 등 구분값 |
| -nmpr_type_cd | 호가유형코드 | String | Y | 2 | 01 : 지정가
02 : 시장가 03 : 조건부 04 : 최유리 |
| -nmpr_type_name | 호가유형명 | String | Y | 60 | 호가 유형의 명칭 |
| -pdno | 상품번호 | String | Y | 12 | 선물옵션종목코드 |
| -prdt_name | 상품명 | String | Y | 60 | |
| -prdt_type_cd | 상품유형코드 | String | Y | 3 | |
| -ord_qty | 주문수량 | String | Y | 10 | 주문 수량 |
| -ord_idx | 주문지수 | String | Y | 24 | 주문 가격 |
| -qty | 잔량 | String | Y | 10 | 주문 체결되지 않고 남은 수량 |
| -ord_tmd | 주문시각 | String | Y | 6 | 주문 접수 시간 |
| -tot_ccld_qty | 총체결수량 | String | Y | 10 | 주문 체결된 수량 |
| -avg_idx | 평균지수 | String | Y | 27 | 체결된 주문 수량의 평균 체결 가격 |
| -tot_ccld_amt | 총체결금액 | String | Y | 19 | 체결된 주문의 합계금액 |
| -rjct_qty | 거부수량 | String | Y | 10 | 접수된 주문이 정상 처리되지 못하고 거부된 수량 |
| -ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | String | Y | 5 | 정상 처리되지 못하고 거부된 주문의 사유코드 |
| -ingr_trad_rjct_rson_name | 장내매매거부사유명 | String | Y | 60 | 정상 처리되지 못하고 거부된 주문의 사유 |
| -ord_stfno | 주문직원번호 | String | Y | 6 | 주문 접수한 직원의 사번 또는 온라인 주문 시 매체 유형코드 |
| -sprd_item_yn | 스프레드종목여부 | String | Y | 1 | 스프레드 종목 여부 구분값 |
| -ord_ip_addr | 주문IP주소 | String | Y | 200 | 주문 시 사용한 매체의 IP 주소 |
| output2 | 응답상세2 | Object | Y | ||
| -tot_ord_qty | 총주문수량 | String | Y | 10 | 전체 주문 수량 |
| -tot_ccld_amt_smtl | 총체결금액합계 | String | Y | 19 | 체결된 주문 전체의 합계 금액 |
| -tot_ccld_qty_smtl | 총체결수량합계 | String | Y | 19 | 체결된 주문 전체의 합계 수량 |
| -fee_smtl | 수수료합계 | String | Y | 19 | 체결된 주문에 대한 매매수수료의 합계 금액 |
| -ctac_tlno | 연락전화번호 | String | Y | 20 | 고객의 연락 가능한 전화번호 |
Example
Request
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT": "20211122",
"END_ORD_DT": "20211122",
"SLL_BUY_DVSN_CD": "00",
"CCLD_NCCS_DVSN": "00",
"SORT_SQN": "DS",
"STRT_ODNO": "",
"PDNO": "",
"MKET_ID_CD": "00",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT": "20211122",
"END_ORD_DT": "20211122",
"SLL_BUY_DVSN_CD": "00",
"CCLD_NCCS_DVSN": "00",
"SORT_SQN": "DS",
"STRT_ODNO": "",
"PDNO": "",
"MKET_ID_CD": "00",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
Response
{
"ctx_area_fk200": "81055689^03^20220101^20220114^DS^ ",
"ctx_area_nk200": " ",
"output1": [
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220113",
"odno": "0000007045",
"orgn_odno": "0000000000",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "HTS SELL",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "400.00",
"qty": "0",
"ord_tmd": "131604",
"tot_ccld_qty": "1",
"avg_idx": "400.00000000",
"tot_ccld_amt": "100000000",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
},
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220111",
"odno": "0000007006",
"orgn_odno": "0000007004",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "CANCEL CONFIRM",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "0.00",
"qty": "0",
"ord_tmd": "150233",
"tot_ccld_qty": "0",
"avg_idx": "0.00000000",
"tot_ccld_amt": "0",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
}
],
"output2": {
"tot_ord_qty": "4",
"tot_ccld_amt_smtl": "200000000",
"tot_ccld_qty_smtl": "2",
"fee_smtl": "28570",
"ctac_tlno": "01047859775"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
"ctx_area_fk200": "81055689^03^20220101^20220114^DS^ ",
"ctx_area_nk200": " ",
"output1": [
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220113",
"odno": "0000007045",
"orgn_odno": "0000000000",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "HTS SELL",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "400.00",
"qty": "0",
"ord_tmd": "131604",
"tot_ccld_qty": "1",
"avg_idx": "400.00000000",
"tot_ccld_amt": "100000000",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
},
{
"ord_gno_brno": "06010",
"cano": "810XXXXX",
"csac_name": "",
"acnt_prdt_cd": "03",
"ord_dt": "20220111",
"odno": "0000007006",
"orgn_odno": "0000007004",
"sll_buy_dvsn_cd": "01",
"trad_dvsn_name": "CANCEL CONFIRM",
"nmpr_type_cd": "01",
"nmpr_type_name": "Limit Order",
"pdno": "101S03",
"prdt_name": "F 202203",
"prdt_type_cd": "301",
"ord_qty": "1",
"ord_idx": "0.00",
"qty": "0",
"ord_tmd": "150233",
"tot_ccld_qty": "0",
"avg_idx": "0.00000000",
"tot_ccld_amt": "0",
"rjct_qty": "0",
"ingr_trad_rjct_rson_cd": "00000",
"ingr_trad_rjct_rson_name": "NORMAL",
"ord_stfno": "Nsmart",
"sprd_item_yn": "N",
"ord_ip_addr": "P01032651641"
}
],
"output2": {
"tot_ord_qty": "4",
"tot_ccld_amt_smtl": "200000000",
"tot_ccld_qty_smtl": "2",
"fee_smtl": "28570",
"ctac_tlno": "01047859775"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
선물옵션 잔고현황[v1_국내선물-004]
REST
선물옵션 잔고현황[v1_국내선물-004]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/trading/inquire-balance
- Format
- Content-Type
개요
선물옵션 잔고현황 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 | [실전투자]
CTFO6118R : 선물 옵션 잔고 현황 [모의투자] VTFO6118R : 선물 옵션 잔고 현황 |
| 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자리 |
| MGNA_DVSN | 증거금 구분 | String | Y | 2 | 01 : 개시
02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | String | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(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_fk200 | 연속조회검색조건200 | String | Y | 200 | |
| ctx_area_nk200 | 연속조회키200 | String | Y | 200 | |
| output1 | 응답상세1 | Array | Y | ||
| -cano | 종합계좌번호 | String | Y | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| -acnt_prdt_cd | 계좌상품코드 | String | Y | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| -pdno | 상품번호 | String | Y | 12 | 선물옵션종목코드 |
| -prdt_type_cd | 상품유형코드 | String | Y | 3 | |
| -shtn_pdno | 단축상품번호 | String | Y | 12 | 단축상품번호 (예: 101P09) |
| -prdt_name | 상품명 | String | Y | 60 | |
| -sll_buy_dvsn_name | 매도매수구분명 | String | Y | 4 | 매도/매수 구분의 명칭
- 매수잔고를 가진 경우, "매수" 혹은 "BUY"로 출력 - 매도잔고를 가진 경우, "매도" 혹은 "SLL"로 출력 - 당일 잔고를 청산하여 잔고를 가지고 있지 않은 경우 빈칸으로 출력 |
| -cblc_qty | 잔고수량 | String | Y | 10 | 보유한 종목의 수량 |
| -excc_unpr | 정산단가 | String | Y | 32 | 당일 종가로 정산한 가격 |
| -ccld_avg_unpr1 | 체결평균단가1 | String | Y | 32 | 보유한 종목의 평균 체결 가격 |
| -idx_clpr | 지수종가 | String | Y | 32 | |
| -pchs_amt | 매입금액 | String | Y | 19 | 보유 종목을 매수한 금액 |
| -evlu_amt | 평가금액 | String | Y | 19 | 보유 종목을 현재가로 평가하여 산출한 금액 |
| -evlu_pfls_amt | 평가손익금액 | String | Y | 19 | 매입금액과 평가금액을 비교한 손익 |
| -trad_pfls_amt | 매매손익금액 | String | Y | 19 | 매수와 매도가 완료된 수량에 대한 실현 손익 |
| -lqd_psbl_qty | 청산가능수량 | String | Y | 19 | 청산 가능한 수량 |
| output2 | 응답상세2 | Array | Y | ||
| -dnca_cash | 예수금현금 | String | Y | 19 | 원화로 보유한 현금 (현금미수금액, 수수료미수금액 차감) |
| -frcr_dncl_amt | 외화예수금액 | String | Y | 19 | 외화로 보유한 현금 |
| -dnca_sbst | 예수금대용 | String | Y | 19 | 주식대용금액+채권대용금액+전일대용매도대용금액+당일대용매도대용금액 |
| -tot_dncl_amt | 총예수금액 | String | Y | 19 | 상기 3개 예수금 항목의 합계 금액 |
| -tot_ccld_amt | 총체결금액 | String | Y | 19 | 체결된 주문의 합계금액 |
| -cash_mgna | 현금증거금 | String | Y | 19 | 원화 현금 중 주문증거금으로 사용된 금액 |
| -sbst_mgna | 대용증거금 | String | Y | 19 | 대용 예수금 중 주문증거금으로 사용된 금액 |
| -mgna_tota | 증거금총액 | String | Y | 19 | 증거금으로 사용된 항목의 합계 금액 |
| -opt_dfpa | 옵션차금 | String | Y | 19 | 당일옵션매도금에서 당일옵션매수금을 차감한 금액 |
| -thdt_dfpa | 당일차금 | String | Y | 19 | 당일의 각 매수거래에 대하여 1에 의하여 산출한 금액의 합계액과 당일의 각 매도거래에 대하여 2에 의하여 산출한 금액의 합계액을 합산한 금액
1. 매수거래수량*(당일의 정산가격-체결가격)*최소가격변동금액*환산승수 2. 매도거래수량*(체결가격-당일의 정산가격)*최소가격변동금액*환산승수 |
| -rnwl_dfpa | 갱신차금 | String | Y | 19 | 직전 거래일의 매수미결제약정에 대하여 1에 의하여 산출한 금액과 직전거래일의 매도미결제약정에 대하여 2에 의하여 산출한 금액을 합산한 금액
1. 매수미결제약정*(당일의 정산가격-직전거래일의 정산가격)*최소가격변동 금액*환산승수 2. 매도미결제약정*(직전거래일의 정산가격-당일의 정산가격)*최소가격변동 금액*환산승수 |
| -fee | 수수료 | String | Y | 19 | 체결된 주문에 의한 매매수수료 |
| -nxdy_dnca | 익일예수금 | String | Y | 19 | 당일 매매내역을 근거로 익일(결제일) 고객님 계좌에 있는 현금 |
| -nxdy_dncl_amt | 익일예수금액 | String | Y | 19 | |
| -prsm_dpast | 추정예탁자산 | String | Y | 19 | 보유한 잔고를 정산 기준으로 평가한 금액과 예수금을 합한 금액 |
| -prsm_dpast_amt | 추정예탁자산금액 | String | Y | 19 | |
| -pprt_ord_psbl_cash | 적정주문가능현금 | String | Y | 19 | 미수없는 주문가능금액 |
| -add_mgna_cash | 추가증거금현금 | String | Y | 19 | 장 종료 후 예탁평가액이 유지증거금을 하회할 경우 또는 예탁현금이 결제금액 보다 적은 경우 고객이 추가적으로 납부해야
하는 증거금 |
| -add_mgna_tota | 추가증거금총액 | String | Y | 19 | |
| -futr_trad_pfls_amt | 선물매매손익금액 | String | Y | 19 | 선물 매수와 매도가 완료된 수량에 대한 실현 손익 |
| -opt_trad_pfls_amt | 옵션매매손익금액 | String | Y | 19 | 옵션 매수와 매도가 완료된 수량에 대한 실현 손익 |
| -futr_evlu_pfls_amt | 선물평가손익금액 | String | Y | 19 | 선물 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
| -opt_evlu_pfls_amt | 옵션평가손익금액 | String | Y | 19 | 옵션 잔고의 매입가격 또는 정산가격과 평가금액을 비교한 손익 |
| -trad_pfls_amt_smtl | 매매손익금액합계 | String | Y | 19 | 선물매매손익금액과 옵션매매손익금액을 합한 금액 |
| -evlu_pfls_amt_smtl | 평가손익금액합계 | String | Y | 19 | 선물평가손익금액과 옵션평가손익금액을 합한 금액 |
| -wdrw_psbl_tot_amt | 인출가능총금액 | String | Y | 19 | 출금 가능한 현금(예탁현금+예탁대용-예탁증거금총액) |
| -ord_psbl_cash | 주문가능현금 | String | Y | 19 | 예수금현금에서 현금증거금을 차감한 금액 |
| -ord_psbl_sbst | 주문가능대용 | String | Y | 19 | 예수금대용에서 대용증거금을 차감한 금액 |
| -ord_psbl_tota | 주문가능총액 | String | Y | 19 | 주문가능현금과 주문가능대용을 합한 금액 |
| -pchs_amt_smtl | 매입금액합계 | String | Y | 19 | 종목별 매입금액의 합계 금액 |
| -evlu_amt_smtl | 평가금액합계 | String | Y | 19 | 종목별 평가금액의 합계 금액 |
Example
Request
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"3",
"MGNA_DVSN": "01",
"EXCC_STAT_CD": "1",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"3",
"MGNA_DVSN": "01",
"EXCC_STAT_CD": "1",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}
Response
{
"ctx_area_fk200": "연속조회검색조건200을 입력하세요.",
"output1": {
"lqd_psbl_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"pdno": [
"KR4101RC0000",
"KR4101S30001",
"KR4111RA0000",
"KR41ACRC0005",
"KR41ACS60004",
"KR41ADRC0004",
"KR41ADS30005",
"KR41AES90007",
"KR41DRRA0007"
],
"prdt_type_cd": [
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301"
],
"pchs_amt": [
"586950000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"sll_buy_dvsn_name": [
"SLL",
"BUY",
"BUY",
"BUY",
"SLL",
"BUY",
"SLL",
"SLL",
"BUY"
],
"trad_pfls_amt": [
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"shtn_pdno": [
"101R12",
"101S03",
"111R10",
"1ACR12",
"1ACS06",
"1ADR12",
"1ADS03",
"1AES09",
"1DRR10"
],
"acnt_prdt_cd": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"cblc_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"excc_unpr": [
"391.30000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"cano": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"idx_clpr": [
"380.55000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"ccld_avg_unpr1": [
"402.28975400",
"406.38538995",
"71618.18181818",
"4626.00000000",
"4766.50000000",
"6992.50000000",
"5695.50000000",
"3430.50000000",
"87700.00000000"
],
"evlu_pfls_amt": [
"16125000",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"evlu_amt": [
"570825000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"prdt_name": [
"F 202112",
"F 202203",
"SamsungEle F 202110 ( 10)",
"BBIG K-NewDeal F 202112",
"BBIG K-NewDeal F 202206",
"Battery K-NewDeal F 202112",
"Battery K-NewDeal F 202203",
"Bio K-NewDeal F 202209",
"C2S F 202110 ( 10)"
]
},
"rt_cd": "0",
"output2": {
"nxdy_dnca": "90016125000",
"sbst_mgna": "1391065523",
"cash_mgna": "0",
"ord_psbl_tota": "88608934477",
"opt_dfpa": "0",
"fee": "0",
"pchs_amt_smtl": "31000465000",
"prsm_dpast": "90016125000",
"evlu_pfls_amt_smtl": "16125000",
"thdt_dfpa": "0",
"prsm_dpast_amt": "90016125000",
"frcr_dncl_amt": "0",
"pprt_ord_psbl_cash": "88608934477",
"evlu_amt_smtl": "30984340000",
"futr_trad_pfls_amt": "0",
"rnwl_dfpa": "16125000",
"futr_evlu_pfls_amt": "16125000",
"wdrw_psbl_tot_amt": "88608934477",
"dnca_sbst": "0",
"opt_evlu_pfls_amt": "0",
"dnca_cash": "90000000000",
"tot_dncl_amt": "90000000000",
"nxdy_dncl_amt": "90016125000",
"tot_ccld_amt": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"ord_psbl_cash": "88608934477",
"mgna_tota": "1391065523",
"ord_psbl_sbst": "0",
"add_mgna_tota": "0",
"add_mgna_cash": "0"
},
"msg1": "조회 되었습니다. (마지막 자료) ",
"msg_cd": "KIOK0460",
"ctx_area_nk200": ""
}
"ctx_area_fk200": "연속조회검색조건200을 입력하세요.",
"output1": {
"lqd_psbl_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"pdno": [
"KR4101RC0000",
"KR4101S30001",
"KR4111RA0000",
"KR41ACRC0005",
"KR41ACS60004",
"KR41ADRC0004",
"KR41ADS30005",
"KR41AES90007",
"KR41DRRA0007"
],
"prdt_type_cd": [
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301",
"301"
],
"pchs_amt": [
"586950000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"sll_buy_dvsn_name": [
"SLL",
"BUY",
"BUY",
"BUY",
"SLL",
"BUY",
"SLL",
"SLL",
"BUY"
],
"trad_pfls_amt": [
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"shtn_pdno": [
"101R12",
"101S03",
"111R10",
"1ACR12",
"1ACS06",
"1ADR12",
"1ADS03",
"1AES09",
"1DRR10"
],
"acnt_prdt_cd": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"cblc_qty": [
"6",
"133",
"110",
"1000",
"1000",
"1000",
"1000",
"1",
"25"
],
"excc_unpr": [
"391.30000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"cano": [
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"idx_clpr": [
"380.55000000",
"389.10000000",
"71800.00000000",
"3003.00000000",
"3012.00000000",
"5686.00000000",
"5672.00000000",
"2610.00000000",
"85400.00000000"
],
"ccld_avg_unpr1": [
"402.28975400",
"406.38538995",
"71618.18181818",
"4626.00000000",
"4766.50000000",
"6992.50000000",
"5695.50000000",
"3430.50000000",
"87700.00000000"
],
"evlu_pfls_amt": [
"16125000",
"0",
"0",
"0",
"0",
"0",
"0",
"0",
"0"
],
"evlu_amt": [
"570825000",
"12937575000",
"78980000",
"3003000000",
"3012000000",
"5686000000",
"5672000000",
"2610000",
"21350000"
],
"prdt_name": [
"F 202112",
"F 202203",
"SamsungEle F 202110 ( 10)",
"BBIG K-NewDeal F 202112",
"BBIG K-NewDeal F 202206",
"Battery K-NewDeal F 202112",
"Battery K-NewDeal F 202203",
"Bio K-NewDeal F 202209",
"C2S F 202110 ( 10)"
]
},
"rt_cd": "0",
"output2": {
"nxdy_dnca": "90016125000",
"sbst_mgna": "1391065523",
"cash_mgna": "0",
"ord_psbl_tota": "88608934477",
"opt_dfpa": "0",
"fee": "0",
"pchs_amt_smtl": "31000465000",
"prsm_dpast": "90016125000",
"evlu_pfls_amt_smtl": "16125000",
"thdt_dfpa": "0",
"prsm_dpast_amt": "90016125000",
"frcr_dncl_amt": "0",
"pprt_ord_psbl_cash": "88608934477",
"evlu_amt_smtl": "30984340000",
"futr_trad_pfls_amt": "0",
"rnwl_dfpa": "16125000",
"futr_evlu_pfls_amt": "16125000",
"wdrw_psbl_tot_amt": "88608934477",
"dnca_sbst": "0",
"opt_evlu_pfls_amt": "0",
"dnca_cash": "90000000000",
"tot_dncl_amt": "90000000000",
"nxdy_dncl_amt": "90016125000",
"tot_ccld_amt": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"ord_psbl_cash": "88608934477",
"mgna_tota": "1391065523",
"ord_psbl_sbst": "0",
"add_mgna_tota": "0",
"add_mgna_cash": "0"
},
"msg1": "조회 되었습니다. (마지막 자료) ",
"msg_cd": "KIOK0460",
"ctx_area_nk200": ""
}
선물옵션 주문가능[v1_국내선물-005]
REST
선물옵션 주문가능[v1_국내선물-005]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-futureoption/v1/trading/inquire-psbl-order
- Format
- Content-Type
개요
선물옵션 주문가능 API입니다. 주문가능 내역과 수량을 확인하실 수 있습니다.
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의 Credentials Grant 절차를 준용) 제휴사(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | [실전투자]
TTTO5105R : 선물 옵션 주문 가능 [모의투자] VTTO5105R : 선물 옵션 주문 가능 |
| 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 | N | 8 | 계좌번호 체계(8-2)의 앞 8자리 |
| ACNT_PRDT_CD | 계좌상품코드 | String | N | 2 | 계좌번호 체계(8-2)의 뒤 2자리 |
| PDNO | 상품번호 | String | N | 12 | 선물옵션종목코드
선물 6자리 (예: 101S03) 옵션 9자리 (예: 201S03370) |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | String | N | 2 | 01 : 매도
02 : 매수 |
| UNIT_PRICE | 주문가격1 | String | N | 23 | 주문가격
※ 주문가격 '0'일 경우 - 옵션매수 : 현재가 - 그 이외 : 기준가 |
| ORD_DVSN_CD | 주문구분코드 | String | N | 2 | 01 : 지정가
02 : 시장가 03 : 조건부 04 : 최유리, 10 : 지정가(IOC) 11 : 지정가(FOK) 12 : 시장가(IOC) 13 : 시장가(FOK) 14 : 최유리(IOC) 15 : 최유리(FOK) |
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 | ||
| -tot_psbl_qty | 총가능수량 | String | Y | 10 | 총가능수량 |
| -lqd_psbl_qty1 | 청산가능수량1 | String | Y | 10 | 청산가능수량 |
| -ord_psbl_qty | 주문가능수량 | String | Y | 10 | 주문가능수량 |
| -bass_idx | 기준지수 | String | Y | 32 | 기준지수 |
Example
Request
{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"PDNO": "101R12",
"SLL_BUY_DVSN_CD": "02",
"UNIT_PRICE": "397.95",
"ORD_DVSN_CD": "01"
}
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"03",
"PDNO": "101R12",
"SLL_BUY_DVSN_CD": "02",
"UNIT_PRICE": "397.95",
"ORD_DVSN_CD": "01"
}
Response
{
"output": {
"tot_psbl_qty": "11679",
"lqd_psbl_qty1": "0",
"ord_psbl_qty": "11665",
"bass_idx": "379.67000000"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
"output": {
"tot_psbl_qty": "11679",
"lqd_psbl_qty1": "0",
"ord_psbl_qty": "11665",
"bass_idx": "379.67000000"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
(야간)선물옵션 주문체결 내역조회 [국내선물-009]
REST
(야간)선물옵션 주문체결 내역조회 [국내선물-009]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-ngt-ccnl
- Format
- Content-Type
개요
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 | JTCE5005R |
| 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자리 |
| STRT_ORD_DT | 시작주문일자 | String | Y | 8 | |
| END_ORD_DT | 종료주문일자 | String | Y | 8 | 조회하려는 마지막 일자 다음일자로 조회
(ex. 20221011 까지의 내역을 조회하고자 할 경우, 20221012로 종료주문일자 설정) |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | String | Y | 2 | 공란 : default (00: 전체 ,01 : 매도, 02 : 매수) |
| CCLD_NCCS_DVSN | 체결미체결구분 | String | Y | 2 | 00 : 전체
01 : 체결 02 : 미체결 |
| SORT_SQN | 정렬순서 | String | Y | 2 | 공란 : default (DS : 정순, 그외 : 역순) |
| STRT_ODNO | 시작주문번호 | String | Y | 10 | 공란 : default |
| PDNO | 상품번호 | String | Y | 12 | 공란 : default |
| MKET_ID_CD | 시장ID코드 | String | Y | 3 | 공란 : default |
| FUOP_DVSN_CD | 선물옵션구분코드 | String | Y | 2 | 공란 : 전체, 01 : 선물, 02 : 옵션 |
| SCRN_DVSN | 화면구분 | String | Y | 2 | 02(Default) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | Array | Y | ||
| -tot_ord_qty | 총주문수량 | String | Y | 10 | |
| -tot_ccld_qty | 총체결수량 | String | Y | 10 | |
| -tot_ccld_amt | 총체결금액 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| output1 | 응답상세2 | Object Array | Y | 시간별체결 정보 | |
| -ord_gno_brno | 주문채번지점번호 | String | Y | 5 | |
| -cano | 종합계좌번호 | String | Y | 8 | |
| -csac_name | 종합계좌명 | String | Y | 60 | |
| -acnt_prdt_cd | 계좌상품코드 | String | Y | 2 | |
| -ord_dt | 주문일자 | String | Y | 8 | |
| -odno | 주문번호 | String | Y | 10 | |
| -orgn_odno | 원주문번호 | String | Y | 10 | |
| -sll_buy_dvsn_cd | 매도매수구분코드 | String | Y | 2 | |
| -trad_dvsn_name | 매매구분명 | String | Y | 60 | |
| -nmpr_type_name | 호가유형명 | String | Y | 60 | |
| -pdno | 상품번호 | String | Y | 12 | |
| -prdt_name | 상품명 | String | Y | 60 | |
| -prdt_type_cd | 상품유형코드 | String | Y | 3 | |
| -ord_qty | 주문수량 | String | Y | 10 | |
| -ord_idx | 주문지수 | String | Y | 20 | |
| -qty | 잔량 | String | Y | 10 | |
| -ord_tmd | 주문시각 | String | Y | 6 | |
| -tot_ccld_qty | 총체결수량 | String | Y | 10 | |
| -avg_idx | 평균지수 | String | Y | 19 | |
| -tot_ccld_amt | 총체결금액 | String | Y | 19 | |
| -rjct_qty | 거부수량 | String | Y | 10 | |
| -ingr_trad_rjct_rson_cd | 장내매매거부사유코드 | String | Y | 5 | |
| -ingr_trad_rjct_rson_name | 장내매매거부사유명 | String | Y | 60 | |
| -ord_stfno | 주문직원번호 | String | Y | 6 | |
| -sprd_item_yn | 스프레드종목여부 | String | Y | 1 | |
| -ord_ip_addr | 주문IP주소 | String | Y | 200 |
Example
Request
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT":"20220730",
"END_ORD_DT":"20221214",
"SLL_BUY_DVSN_CD":"00",
"CCLD_NCCS_DVSN":"00",
"SORT_SQN":"DS",
"STRT_ODNO":"",
"PDNO":"",
"MKET_ID_CD":"00",
"FUOP_DVSN_CD":"",
"SCRN_DVSN":"00",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"STRT_ORD_DT":"20220730",
"END_ORD_DT":"20221214",
"SLL_BUY_DVSN_CD":"00",
"CCLD_NCCS_DVSN":"00",
"SORT_SQN":"DS",
"STRT_ODNO":"",
"PDNO":"",
"MKET_ID_CD":"00",
"FUOP_DVSN_CD":"",
"SCRN_DVSN":"00",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "81012345^03^20221214^20221214^DS^ ",
"ctx_area_nk200": " ",
"output1": [],
"output2": {
"tot_ord_qty": "0",
"tot_ccld_qty": "0",
"tot_ccld_amt": "0",
"fee": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0560",
"msg1": "조회할 내용이 없습니다 "
}
"ctx_area_fk200": "81012345^03^20221214^20221214^DS^ ",
"ctx_area_nk200": " ",
"output1": [],
"output2": {
"tot_ord_qty": "0",
"tot_ccld_qty": "0",
"tot_ccld_amt": "0",
"fee": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0560",
"msg1": "조회할 내용이 없습니다 "
}
(야간)선물옵션 잔고현황 [국내선물-010]
REST
(야간)선물옵션 잔고현황 [국내선물-010]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-ngt-balance
- Format
- Content-Type
개요
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 | JTCE6001R |
| 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자리 |
| ACNT_PWD | 계좌비밀번호 | String | Y | 84 | 공란("")으로 조회 |
| MGNA_DVSN | 증거금구분 | String | Y | 2 | 01 : 개시, 02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | String | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터) |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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_cash | 예수금현금 | String | Y | 19 | 총주문수량 |
| -frcr_dncl_amt | 외화예수금액 | String | Y | 19 | 주문채번지점번호 |
| -dnca_sbst | 예수금대용 | String | Y | 19 | |
| -tot_dncl_amt | 총예수금액 | String | Y | 19 | |
| -cash_mgna | 현금증거금 | String | Y | 19 | |
| -sbst_mgna | 대용증거금 | String | Y | 19 | |
| -mgna_tota | 증거금총액 | String | Y | 19 | |
| -opt_dfpa | 옵션차금 | String | Y | 19 | |
| -thdt_dfpa | 당일차금 | String | Y | 19 | |
| -rnwl_dfpa | 갱신차금 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| -nxdy_dnca | 익일예수금 | String | Y | 19 | |
| -prsm_dpast | 추정예탁자산 | String | Y | 19 | 종합계좌번호 |
| -pprt_ord_psbl_cash | 적정주문가능현금 | String | Y | 19 | 총체결수량 |
| -add_mgna_cash | 추가증거금현금 | String | Y | 19 | 총체결금액 |
| -add_mgna_tota | 추가증거금총액 | String | Y | 19 | 종합계좌명 |
| -futr_trad_pfls_amt | 선물매매손익금액 | String | Y | 19 | 수수료 |
| -opt_trad_pfls_amt | 옵션매매손익금액 | String | Y | 19 | 계좌상품코드 |
| -futr_evlu_pfls_amt | 선물평가손익금액 | String | Y | 19 | 주문일자 |
| -opt_evlu_pfls_amt | 옵션평가손익금액 | String | Y | 19 | 주문번호 |
| -trad_pfls_amt_smtl | 매매손익금액합계 | String | Y | 19 | |
| -evlu_pfls_amt_smtl | 평가손익금액합계 | String | Y | 19 | |
| -wdrw_psbl_tot_amt | 인출가능총금액 | String | Y | 19 | |
| -ord_psbl_cash | 주문가능현금 | String | Y | 19 | |
| -ord_psbl_sbst | 주문가능대용 | String | Y | 19 | |
| -ord_psbl_tota | 주문가능총액 | String | Y | 19 | |
| -mmga_tot_amt | 유지증거금총금액 | String | Y | 19 | |
| -mmga_cash_amt | 유지증거금현금금액 | String | Y | 19 | |
| -mtnc_rt | 유지비율 | String | Y | 32238 | |
| -isfc_amt | 부족금액 | String | Y | 19 | |
| -pchs_amt_smtl | 매입금액합계 | String | Y | 19 | |
| -evlu_amt_smtl | 평가금액합계 | String | Y | 19 | |
| output1 | 응답상세2 | Object Array | Y | 시간별체결 정보 | |
| -cano | 종합계좌번호 | String | Y | 8 | |
| -acnt_prdt_cd | 계좌상품코드 | String | Y | 2 | |
| -pdno | 상품번호 | String | Y | 12 | |
| -prdt_type_cd | 상품유형코드 | String | Y | 3 | |
| -shtn_pdno | 단축상품번호 | String | Y | 12 | |
| -prdt_name | 상품명 | String | Y | 60 | |
| -sll_buy_dvsn_cd | 매도매수구분코드 | String | Y | 2 | |
| -trad_dvsn_name | 매매구분명 | String | Y | 60 | |
| -cblc_qty | 잔고수량 | String | Y | 19 | |
| -excc_unpr | 정산단가 | String | Y | 32238 | |
| -ccld_avg_unpr1 | 체결평균단가1 | String | Y | 32238 | |
| -idx_clpr | 지수종가 | String | Y | 32238 | |
| -pchs_amt | 매입금액 | String | Y | 19 | |
| -evlu_amt | 평가금액 | String | Y | 19 | |
| -evlu_pfls_amt | 평가손익금액 | String | Y | 19 | |
| -trad_pfls_amt | 매매손익금액 | String | Y | 19 | |
| -lqd_psbl_qty | 청산가능수량 | String | Y | 19 |
Example
Request
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"ACNT_PWD":"",
"MGNA_DVSN":"01",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"ACNT_PWD":"",
"MGNA_DVSN":"01",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "80012345^03^01^1^ ",
"ctx_area_nk200": " ",
"output1": [
{
"cano": "80012345",
"acnt_prdt_cd": "03",
"pdno": "KR4101SC0009",
"prdt_type_cd": "301",
"shtn_pdno": "101S12",
"prdt_name": "F 202212",
"sll_buy_dvsn_cd": "02",
"trad_dvsn_name": "매수",
"cblc_qty": "3",
"excc_unpr": "309.10000000",
"ccld_avg_unpr1": "320.50000000",
"idx_clpr": "307.45000000",
"pchs_amt": "231825000",
"evlu_amt": "230587500",
"evlu_pfls_amt": "-1237500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "3"
}
],
"output2": {
"dnca_cash": "10101527360",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "10101527360",
"cash_mgna": "108922232",
"sbst_mgna": "133854708",
"mgna_tota": "242776940",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-16200000",
"fee": "0",
"nxdy_dnca": "10085327360",
"prsm_dpast": "10085327360",
"pprt_ord_psbl_cash": "9858750420",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "-1237500",
"opt_evlu_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "-1237500",
"wdrw_psbl_tot_amt": "9858750420",
"ord_psbl_cash": "9858750420",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "9858750420",
"mmga_tot_amt": "0",
"mmga_cash_amt": "0",
"mtnc_rt": "0.00000000",
"isfc_amt": "0",
"pchs_amt_smtl": "231825000",
"evlu_amt_smtl": "230587500"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
"ctx_area_fk200": "80012345^03^01^1^ ",
"ctx_area_nk200": " ",
"output1": [
{
"cano": "80012345",
"acnt_prdt_cd": "03",
"pdno": "KR4101SC0009",
"prdt_type_cd": "301",
"shtn_pdno": "101S12",
"prdt_name": "F 202212",
"sll_buy_dvsn_cd": "02",
"trad_dvsn_name": "매수",
"cblc_qty": "3",
"excc_unpr": "309.10000000",
"ccld_avg_unpr1": "320.50000000",
"idx_clpr": "307.45000000",
"pchs_amt": "231825000",
"evlu_amt": "230587500",
"evlu_pfls_amt": "-1237500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "3"
}
],
"output2": {
"dnca_cash": "10101527360",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "10101527360",
"cash_mgna": "108922232",
"sbst_mgna": "133854708",
"mgna_tota": "242776940",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-16200000",
"fee": "0",
"nxdy_dnca": "10085327360",
"prsm_dpast": "10085327360",
"pprt_ord_psbl_cash": "9858750420",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "-1237500",
"opt_evlu_pfls_amt": "0",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "-1237500",
"wdrw_psbl_tot_amt": "9858750420",
"ord_psbl_cash": "9858750420",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "9858750420",
"mmga_tot_amt": "0",
"mmga_cash_amt": "0",
"mtnc_rt": "0.00000000",
"isfc_amt": "0",
"pchs_amt_smtl": "231825000",
"evlu_amt_smtl": "230587500"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
(야간)선물옵션 주문가능 조회 [국내선물-011]
REST
(야간)선물옵션 주문가능 조회 [국내선물-011]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-psbl-ngt-order
- Format
- Content-Type
개요
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 | JTCE1004R |
| 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 | |
| PRDT_TYPE_CD | 상품유형코드 | String | Y | 3 | 301 : 선물옵션 |
| SLL_BUY_DVSN_CD | 매도매수구분코드 | String | Y | 2 | 01 : 매도 , 02 : 매수 |
| UNIT_PRICE | 주문가격1 | String | Y | 23 | |
| ORD_DVSN_CD | 주문구분코드 | String | Y | 2 | '01 : 지정가 02 : 시장가
03 : 조건부 04 : 최유리, 10 : 지정가(IOC) 11 : 지정가(FOK) 12 : 시장가(IOC) 13 : 시장가(FOK) 14 : 최유리(IOC) 15 : 최유리(FOK)' |
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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | ||
| -max_ord_psbl_qty | 최대주문가능수량 | String | Y | 19 | 최대주문가능수량 |
| -lqd_psbl_qty | 청산가능수량 | String | Y | 19 | 청산가능수량 |
| -ord_psbl_qty | 주문가능수량 | String | Y | 19 | 주문가능수량 |
Example
Request
{
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"PDNO":"101T03",
"PRDT_TYPE_CD":"301",
"SLL_BUY_DVSN_CD":"02",
"UNIT_PRICE":"",
"ORD_DVSN_CD":"01"
}
"CANO":"80012345",
"ACNT_PRDT_CD":"03",
"PDNO":"101T03",
"PRDT_TYPE_CD":"301",
"SLL_BUY_DVSN_CD":"02",
"UNIT_PRICE":"",
"ORD_DVSN_CD":"01"
}
Response
{
"output": {
"max_ord_psbl_qty": "996",
"lqd_psbl_qty": "0",
"ord_psbl_qty": "996"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
"output": {
"max_ord_psbl_qty": "996",
"lqd_psbl_qty": "0",
"ord_psbl_qty": "996"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
선물옵션 잔고정산손익내역[v1_국내선물-013]
REST
선물옵션 잔고정산손익내역[v1_국내선물-013]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-balance-settlement-pl
- Format
- Content-Type
개요
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 | CTFO6117R |
| 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_DT | 조회일자 | String | Y | 8 | 조회일자(YYYYMMDD) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 연속조회키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 | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | |
| output2 | 응답상세 | Object | Y | ||
| -nxdy_dnca | 익일예수금 | String | Y | 19 | |
| -mmga_cash | 유지증거금현금 | String | Y | 19 | |
| -brkg_mgna_cash | 위탁증거금현금 | String | Y | 19 | |
| -opt_buy_chgs | 옵션매수대금 | String | Y | 19 | |
| -opt_lqd_evlu_amt | 옵션청산평가금액 | String | Y | 19 | |
| -dnca_sbst | 예수금대용 | String | Y | 19 | |
| -mmga_tota | 유지증거금총액 | String | Y | 19 | |
| -brkg_mgna_tota | 위탁증거금총액 | String | Y | 19 | |
| -opt_sll_chgs | 옵션매도대금 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| -thdt_dfpa | 당일차금 | String | Y | 19 | |
| -rnwl_dfpa | 갱신차금 | String | Y | 19 | |
| -dnca_cash | 예수금현금 | String | Y | 19 | |
| output1 | 응답상세2 | Array | Y | array | |
| -pdno | 상품번호 | String | Y | 12 | |
| -prdt_name | 상품명 | String | Y | 60 | |
| -trad_dvsn_name | 매매구분명 | String | Y | 60 | |
| -bfdy_cblc_qty | 전일잔고수량 | String | Y | 19 | |
| -new_qty | 신규수량 | String | Y | 10 | |
| -mnpl_rpch_qty | 전매환매수량 | String | Y | 10 | |
| -cblc_qty | 잔고수량 | String | Y | 19 | |
| -cblc_amt | 잔고금액 | String | Y | 19 | |
| -trad_pfls_amt | 매매손익금액 | String | Y | 19 | |
| -evlu_amt | 평가금액 | String | Y | 19 | |
| -evlu_pfls_amt | 평가손익금액 | String | Y | 19 |
Example
Request
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_DT":"20230906",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_DT":"20230906",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "12345678!^03!^20230906 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"pdno": "101T09",
"prdt_name": "F 202309",
"trad_dvsn_name": "매수",
"bfdy_cblc_qty": "2",
"new_qty": "0",
"mnpl_rpch_qty": "0",
"cblc_qty": "2",
"cblc_amt": "-425000",
"trad_pfls_amt": "0",
"evlu_amt": "149350000",
"evlu_pfls_amt": "-1675000"
}
],
"output2": {
"nxdy_dnca": "0",
"mmga_cash": "0",
"brkg_mgna_cash": "0",
"opt_buy_chgs": "0",
"opt_lqd_evlu_amt": "0",
"dnca_sbst": "0",
"mmga_tota": "0",
"brkg_mgna_tota": "0",
"opt_sll_chgs": "0",
"fee": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "0",
"dnca_cash": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
"ctx_area_fk200": "12345678!^03!^20230906 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"pdno": "101T09",
"prdt_name": "F 202309",
"trad_dvsn_name": "매수",
"bfdy_cblc_qty": "2",
"new_qty": "0",
"mnpl_rpch_qty": "0",
"cblc_qty": "2",
"cblc_amt": "-425000",
"trad_pfls_amt": "0",
"evlu_amt": "149350000",
"evlu_pfls_amt": "-1675000"
}
],
"output2": {
"nxdy_dnca": "0",
"mmga_cash": "0",
"brkg_mgna_cash": "0",
"opt_buy_chgs": "0",
"opt_lqd_evlu_amt": "0",
"dnca_sbst": "0",
"mmga_tota": "0",
"brkg_mgna_tota": "0",
"opt_sll_chgs": "0",
"fee": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "0",
"dnca_cash": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
선물옵션 총자산현황[v1_국내선물-014]
REST
선물옵션 총자산현황[v1_국내선물-014]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-deposit
- Format
- Content-Type
개요
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 | CTRP6550R |
| 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자리 |
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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | Y | ||
| -dnca_tota | 예수금총액 | String | Y | 19 | |
| -bfdy_chck_amt | 전일수표금액 | String | Y | 19 | |
| -thdt_chck_amt | 당일수표금액 | String | Y | 19 | |
| -rlth_uwdl_dpos_amt | 실물인수도예치금액 | String | Y | 19 | |
| -brkg_mgna_cash | 위탁증거금현금 | String | Y | 19 | |
| -wdrw_psbl_tot_amt | 인출가능총금액 | String | Y | 19 | |
| -ord_psbl_cash | 주문가능현금 | String | Y | 19 | |
| -ord_psbl_tota | 주문가능총액 | String | Y | 19 | |
| -dnca_sbst | 예수금대용 | String | Y | 19 | |
| -scts_sbst_amt | 유가증권대용금액 | String | Y | 19 | |
| -frcr_evlu_amt | 외화평가금액 | String | Y | 19 | |
| -brkg_mgna_sbst | 위탁증거금대용 | String | Y | 19 | |
| -sbst_rlse_psbl_amt | 대용해제가능금액 | String | Y | 19 | |
| -mtnc_rt | 유지비율 | String | Y | 238 | |
| -add_mgna_tota | 추가증거금총액 | String | Y | 19 | |
| -add_mgna_cash | 추가증거금현금 | String | Y | 19 | |
| -rcva | 미수금 | String | Y | 19 | |
| -futr_trad_pfls | 선물매매손익 | String | Y | 19 | |
| -opt_trad_pfls_amt | 옵션매매손익금액 | String | Y | 19 | |
| -trad_pfls_smtl | 매매손익합계 | String | Y | 19 | |
| -futr_evlu_pfls_amt | 선물평가손익금액 | String | Y | 19 | |
| -opt_evlu_pfls_amt | 옵션평가손익금액 | String | Y | 19 | |
| -evlu_pfls_smtl | 평가손익합계 | String | Y | 19 | |
| -excc_dfpa | 정산차금 | String | Y | 19 | |
| -opt_dfpa | 옵션차금 | String | Y | 19 | |
| -brkg_fee | 위탁수수료 | String | Y | 19 | |
| -nxdy_dnca | 익일예수금 | String | Y | 19 | |
| -prsm_dpast_amt | 추정예탁자산금액 | String | Y | 19 | |
| -cash_mntn_amt | 현금유지금액 | String | Y | 19 | |
| -hack_acdt_acnt_move_amt | 해킹사고계좌이전금액 | String | Y | 19 |
Example
Request
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
}
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
}
Response
{
"output": {
"dnca_tota": "100000000",
"bfdy_chck_amt": "0",
"thdt_chck_amt": "0",
"rlth_uwdl_dpos_amt": "0",
"brkg_mgna_cash": "17907612",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_tota": "64184775",
"dnca_sbst": "0",
"scts_sbst_amt": "0",
"frcr_evlu_amt": "0",
"brkg_mgna_sbst": "17907613",
"sbst_rlse_psbl_amt": "0",
"mtnc_rt": "418.23000000",
"add_mgna_tota": "0",
"add_mgna_cash": "0",
"rcva": "0",
"futr_trad_pfls": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_smtl": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"evlu_pfls_smtl": "3490000",
"excc_dfpa": "-30138000",
"opt_dfpa": "0",
"brkg_fee": "0",
"nxdy_dnca": "69862000",
"prsm_dpast_amt": "69864500",
"cash_mntn_amt": "0",
"hack_acdt_acnt_move_amt": "0"
},
"rt_cd": "0",
"msg_cd": "APRP0126",
"msg1": "조회이(가) 완료되었습니다. "
}
"output": {
"dnca_tota": "100000000",
"bfdy_chck_amt": "0",
"thdt_chck_amt": "0",
"rlth_uwdl_dpos_amt": "0",
"brkg_mgna_cash": "17907612",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_tota": "64184775",
"dnca_sbst": "0",
"scts_sbst_amt": "0",
"frcr_evlu_amt": "0",
"brkg_mgna_sbst": "17907613",
"sbst_rlse_psbl_amt": "0",
"mtnc_rt": "418.23000000",
"add_mgna_tota": "0",
"add_mgna_cash": "0",
"rcva": "0",
"futr_trad_pfls": "0",
"opt_trad_pfls_amt": "0",
"trad_pfls_smtl": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"evlu_pfls_smtl": "3490000",
"excc_dfpa": "-30138000",
"opt_dfpa": "0",
"brkg_fee": "0",
"nxdy_dnca": "69862000",
"prsm_dpast_amt": "69864500",
"cash_mntn_amt": "0",
"hack_acdt_acnt_move_amt": "0"
},
"rt_cd": "0",
"msg_cd": "APRP0126",
"msg1": "조회이(가) 완료되었습니다. "
}
선물옵션 잔고평가손익내역[v1_국내선물-015]
REST
선물옵션 잔고평가손익내역[v1_국내선물-015]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-balance-valuation-pl
- Format
- Content-Type
개요
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 | CTFO6159R |
| 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자리 |
| MGNA_DVSN | 증거금구분 | String | Y | 2 | 01 : 개시, 02 : 유지 |
| EXCC_STAT_CD | 정산상태코드 | String | Y | 1 | 1 : 정산 (정산가격으로 잔고 조회)
2 : 본정산 (매입가격으로 잔고 조회) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 연속조회키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 | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | |
| output2 | 응답상세 | Object | Y | ||
| -dnca_cash | 예수금현금 | String | Y | 19 | |
| -frcr_dncl_amt | 외화예수금액 | String | Y | 19 | |
| -dnca_sbst | 예수금대용 | String | Y | 19 | |
| -tot_dncl_amt | 총예수금액 | String | Y | 19 | |
| -tot_ccld_amt | 총체결금액 | String | Y | 19 | |
| -cash_mgna | 현금증거금 | String | Y | 19 | |
| -sbst_mgna | 대용증거금 | String | Y | 19 | |
| -mgna_tota | 증거금총액 | String | Y | 19 | |
| -opt_dfpa | 옵션차금 | String | Y | 19 | |
| -thdt_dfpa | 당일차금 | String | Y | 19 | |
| -rnwl_dfpa | 갱신차금 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| -nxdy_dnca | 익일예수금 | String | Y | 19 | |
| -nxdy_dncl_amt | 익일예수금액 | String | Y | 19 | |
| -prsm_dpast | 추정예탁자산 | String | Y | 19 | |
| -prsm_dpast_amt | 추정예탁자산금액 | String | Y | 19 | |
| -pprt_ord_psbl_cash | 적정주문가능현금 | String | Y | 19 | |
| -add_mgna_cash | 추가증거금현금 | String | Y | 19 | |
| -add_mgna_tota | 추가증거금총액 | String | Y | 19 | |
| -futr_trad_pfls_amt | 선물매매손익금액 | String | Y | 19 | |
| -opt_trad_pfls_amt | 옵션매매손익금액 | String | Y | 19 | |
| -futr_evlu_pfls_amt | 선물평가손익금액 | String | Y | 19 | |
| -opt_evlu_pfls_amt | 옵션평가손익금액 | String | Y | 19 | |
| -trad_pfls_amt_smtl | 매매손익금액합계 | String | Y | 19 | |
| -evlu_pfls_amt_smtl | 평가손익금액합계 | String | Y | 19 | |
| -wdrw_psbl_tot_amt | 인출가능총금액 | String | Y | 19 | |
| -ord_psbl_cash | 주문가능현금 | String | Y | 19 | |
| -ord_psbl_sbst | 주문가능대용 | String | Y | 19 | |
| -ord_psbl_tota | 주문가능총액 | String | Y | 19 | |
| output1 | 응답상세2 | Array | Y | array | |
| -cano | 종합계좌번호 | String | Y | 8 | |
| -acnt_prdt_cd | 계좌상품코드 | String | Y | 2 | |
| -pdno | 상품번호 | String | Y | 12 | |
| -prdt_type_cd | 상품유형코드 | String | Y | 3 | |
| -shtn_pdno | 단축상품번호 | String | Y | 12 | |
| -prdt_name | 상품명 | String | Y | 60 | |
| -sll_buy_dvsn_name | 매도매수구분명 | String | Y | 4 | |
| -cblc_qty1 | 잔고수량1 | String | Y | 10 | |
| -excc_unpr | 정산단가 | String | Y | 24 | |
| -ccld_avg_unpr1 | 체결평균단가1 | String | Y | 24 | |
| -idx_clpr | 지수종가 | String | Y | 24 | |
| -pchs_amt | 매입금액 | String | Y | 19 | |
| -evlu_amt | 평가금액 | String | Y | 19 | |
| -evlu_pfls_amt | 평가손익금액 | String | Y | 19 | |
| -trad_pfls_amt | 매매손익금액 | String | Y | 19 | |
| -lqd_psbl_qty | 청산가능수량 | String | Y | 19 |
Example
Request
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"MGNA_DVSN":"02",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"MGNA_DVSN":"02",
"EXCC_STAT_CD":"1",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "12345678!^03!^02!^1 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101T90003",
"prdt_type_cd": "301",
"shtn_pdno": "101T09",
"prdt_name": "F 202309",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "2",
"excc_unpr": "340.30000000",
"ccld_avg_unpr1": "345.50000000",
"idx_clpr": "0.00000000",
"pchs_amt": "170150000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "2"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101TC0008",
"prdt_type_cd": "301",
"shtn_pdno": "101T12",
"prdt_name": "F 202312",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "5",
"excc_unpr": "350.00000000",
"ccld_avg_unpr1": "335.50000000",
"idx_clpr": "353.35000000",
"pchs_amt": "437500000",
"evlu_amt": "441687500",
"evlu_pfls_amt": "4187500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "5"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4175TA0001",
"prdt_type_cd": "301",
"shtn_pdno": "175T10",
"prdt_name": "미국달러 F 202310",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "1349.20000000",
"ccld_avg_unpr1": "1338.60000000",
"idx_clpr": "0.00000000",
"pchs_amt": "13492000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4201TA3409",
"prdt_type_cd": "301",
"shtn_pdno": "201T10340",
"prdt_name": "C 202310 340.0",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "2.80000000",
"ccld_avg_unpr1": "2.80000000",
"idx_clpr": "0.01000000",
"pchs_amt": "700000",
"evlu_amt": "2500",
"evlu_pfls_amt": "-697500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
}
],
"output2": {
"dnca_cash": "100000000",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "100000000",
"tot_ccld_amt": "0",
"cash_mgna": "0",
"sbst_mgna": "23910150",
"mgna_tota": "23910150",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-30138000",
"fee": "0",
"nxdy_dnca": "69862000",
"nxdy_dncl_amt": "69862000",
"prsm_dpast": "69864500",
"prsm_dpast_amt": "69864500",
"pprt_ord_psbl_cash": "64184775",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "3490000",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "64184775"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
"ctx_area_fk200": "12345678!^03!^02!^1 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101T90003",
"prdt_type_cd": "301",
"shtn_pdno": "101T09",
"prdt_name": "F 202309",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "2",
"excc_unpr": "340.30000000",
"ccld_avg_unpr1": "345.50000000",
"idx_clpr": "0.00000000",
"pchs_amt": "170150000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "2"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4101TC0008",
"prdt_type_cd": "301",
"shtn_pdno": "101T12",
"prdt_name": "F 202312",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "5",
"excc_unpr": "350.00000000",
"ccld_avg_unpr1": "335.50000000",
"idx_clpr": "353.35000000",
"pchs_amt": "437500000",
"evlu_amt": "441687500",
"evlu_pfls_amt": "4187500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "5"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4175TA0001",
"prdt_type_cd": "301",
"shtn_pdno": "175T10",
"prdt_name": "미국달러 F 202310",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "1349.20000000",
"ccld_avg_unpr1": "1338.60000000",
"idx_clpr": "0.00000000",
"pchs_amt": "13492000",
"evlu_amt": "0",
"evlu_pfls_amt": "0",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
},
{
"cano": "12345678",
"acnt_prdt_cd": "03",
"pdno": "KR4201TA3409",
"prdt_type_cd": "301",
"shtn_pdno": "201T10340",
"prdt_name": "C 202310 340.0",
"sll_buy_dvsn_name": "매수",
"cblc_qty1": "1",
"excc_unpr": "2.80000000",
"ccld_avg_unpr1": "2.80000000",
"idx_clpr": "0.01000000",
"pchs_amt": "700000",
"evlu_amt": "2500",
"evlu_pfls_amt": "-697500",
"trad_pfls_amt": "0",
"lqd_psbl_qty": "1"
}
],
"output2": {
"dnca_cash": "100000000",
"frcr_dncl_amt": "0",
"dnca_sbst": "0",
"tot_dncl_amt": "100000000",
"tot_ccld_amt": "0",
"cash_mgna": "0",
"sbst_mgna": "23910150",
"mgna_tota": "23910150",
"opt_dfpa": "0",
"thdt_dfpa": "0",
"rnwl_dfpa": "-30138000",
"fee": "0",
"nxdy_dnca": "69862000",
"nxdy_dncl_amt": "69862000",
"prsm_dpast": "69864500",
"prsm_dpast_amt": "69864500",
"pprt_ord_psbl_cash": "64184775",
"add_mgna_cash": "0",
"add_mgna_tota": "0",
"futr_trad_pfls_amt": "0",
"opt_trad_pfls_amt": "0",
"futr_evlu_pfls_amt": "4187500",
"opt_evlu_pfls_amt": "-697500",
"trad_pfls_amt_smtl": "0",
"evlu_pfls_amt_smtl": "3490000",
"wdrw_psbl_tot_amt": "34046775",
"ord_psbl_cash": "64184775",
"ord_psbl_sbst": "0",
"ord_psbl_tota": "64184775"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
선물옵션 기준일체결내역[v1_국내선물-016]
REST
선물옵션 기준일체결내역[v1_국내선물-016]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-ccnl-bstime
- Format
- Content-Type
개요
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 | CTFO5139R |
| 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자리 |
| ORD_DT | 주문일자 | String | Y | 8 | 주문일자(YYYYMMDD) |
| FUOP_TR_STRT_TMD | 선물옵션거래시작시각 | String | Y | 6 | 선물옵션거래시작시간(HHMMSS) |
| FUOP_TR_END_TMD | 선물옵션거래종료시각 | String | Y | 6 | 선물옵션거래종료시간(HHMMSS) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 연속조회키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 | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | 응답상세 | Array | Y | array | |
| -pdno | 상품번호 | String | Y | 12 | |
| -prdt_name | 상품명 | String | Y | 60 | |
| -odno | 주문번호 | String | Y | 10 | |
| -tr_type_name | 거래유형명 | String | Y | 60 | |
| -last_sttldt | 최종결제일 | String | Y | 8 | |
| -ccld_idx | 체결지수 | String | Y | 24 | |
| -ccld_qty | 체결량 | String | Y | 10 | |
| -trad_amt | 매매금액 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| -ccld_btwn | 체결시간 | String | Y | 6 | |
| output2 | 응답상세2 | Object | Y | ||
| -tot_ccld_qty_smtl | 총체결수량합계 | String | Y | 19 | |
| -tot_ccld_amt_smtl | 총체결금액합계 | String | Y | 19 | |
| -fee_adjt | 수수료조정 | String | Y | 19 | |
| -fee_smtl | 수수료합계 | String | Y | 19 |
Example
Request
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"ORD_DT":"20230920",
"FUOP_TR_STRT_TMD":"000000",
"FUOP_TR_END_TMD":"240000",
"CTX_AREA_FK200":"",
'CTX_AREA_NK200":""
}
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"ORD_DT":"20230920",
"FUOP_TR_STRT_TMD":"000000",
"FUOP_TR_END_TMD":"240000",
"CTX_AREA_FK200":"",
'CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "12345678!^03!^20230920!^000000!^240000 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"pdno": "201T10340",
"prdt_name": "코스피200 C 202310 340.0",
"odno": "0000219602",
"tr_type_name": "지수콜옵션매수",
"last_sttldt": "20231012",
"ccld_idx": "2.80000000",
"ccld_qty": "1",
"trad_amt": "700000",
"fee": "2758",
"ccld_btwn": "140144"
},
{
"pdno": "101T12",
"prdt_name": "코스피200 F 202312",
"odno": "0000219606",
"tr_type_name": "지수선물매수",
"last_sttldt": "20231214",
"ccld_idx": "335.50000000",
"ccld_qty": "5",
"trad_amt": "419375000",
"fee": "41144",
"ccld_btwn": "140121"
}
],
"output2": {
"tot_ccld_qty_smtl": "6",
"tot_ccld_amt_smtl": "420075000",
"fee_adjt": "43902",
"fee_smtl": "43890"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
"ctx_area_fk200": "12345678!^03!^20230920!^000000!^240000 ",
"ctx_area_nk200": " !^ !^ !^ ",
"output1": [
{
"pdno": "201T10340",
"prdt_name": "코스피200 C 202310 340.0",
"odno": "0000219602",
"tr_type_name": "지수콜옵션매수",
"last_sttldt": "20231012",
"ccld_idx": "2.80000000",
"ccld_qty": "1",
"trad_amt": "700000",
"fee": "2758",
"ccld_btwn": "140144"
},
{
"pdno": "101T12",
"prdt_name": "코스피200 F 202312",
"odno": "0000219606",
"tr_type_name": "지수선물매수",
"last_sttldt": "20231214",
"ccld_idx": "335.50000000",
"ccld_qty": "5",
"trad_amt": "419375000",
"fee": "41144",
"ccld_btwn": "140121"
}
],
"output2": {
"tot_ccld_qty_smtl": "6",
"tot_ccld_amt_smtl": "420075000",
"fee_adjt": "43902",
"fee_smtl": "43890"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
선물옵션기간약정수수료일별[v1_국내선물-017]
REST
선물옵션기간약정수수료일별[v1_국내선물-017]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/domestic-futureoption/v1/trading/inquire-daily-amount-fee
- Format
- Content-Type
개요
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 | CTFO6119R |
| 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_DAY | 조회시작일 | String | Y | 8 | 조회시작일(YYYYMMDD) |
| INQR_END_DAY | 조회종료일 | String | Y | 8 | 조회종료일(YYYYMMDD) |
| CTX_AREA_FK200 | 연속조회검색조건200 | String | Y | 200 | 연속조회검색조건200 |
| CTX_AREA_NK200 | 연속조회키200 | String | Y | 200 | 연속조회키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 | N | 1 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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 | 응답상세 | Array | Y | array | |
| -ord_dt | 주문일자 | String | Y | 8 | |
| -pdno | 상품번호 | String | Y | 12 | |
| -item_name | 종목명 | String | Y | 60 | |
| -sll_agrm_amt | 매도약정금액 | String | Y | 19 | |
| -sll_fee | 매도수수료 | String | Y | 19 | |
| -buy_agrm_amt | 매수약정금액 | String | Y | 19 | |
| -buy_fee | 매수수수료 | String | Y | 19 | |
| -tot_fee_smtl | 총수수료합계 | String | Y | 19 | |
| -trad_pfls | 매매손익 | String | Y | 19 | |
| output2 | 응답상세2 | Object | Y | ||
| -futr_agrm | 선물약정 | String | Y | 19 | |
| -futr_agrm_amt | 선물약정금액 | String | Y | 19 | |
| -futr_agrm_amt_smtl | 선물약정금액합계 | String | Y | 19 | |
| -futr_sll_fee_smtl | 선물매도수수료합계 | String | Y | 19 | |
| -futr_buy_fee_smtl | 선물매수수수료합계 | String | Y | 19 | |
| -futr_fee_smtl | 선물수수료합계 | String | Y | 19 | |
| -opt_agrm | 옵션약정 | String | Y | 19 | |
| -opt_agrm_amt | 옵션약정금액 | String | Y | 19 | |
| -opt_agrm_amt_smtl | 옵션약정금액합계 | String | Y | 19 | |
| -opt_sll_fee_smtl | 옵션매도수수료합계 | String | Y | 19 | |
| -opt_buy_fee_smtl | 옵션매수수수료합계 | String | Y | 19 | |
| -opt_fee_smtl | 옵션수수료합계 | String | Y | 19 | |
| -prdt_futr_agrm | 상품선물약정 | String | Y | 19 | |
| -prdt_fuop | 상품선물옵션 | String | Y | 19 | |
| -prdt_futr_evlu_amt | 상품선물평가금액 | String | Y | 8 | |
| -futr_fee | 선물수수료 | String | Y | 19 | |
| -opt_fee | 옵션수수료 | String | Y | 19 | |
| -fee | 수수료 | String | Y | 19 | |
| -sll_agrm_amt | 매도약정금액 | String | Y | 19 | |
| -buy_agrm_amt | 매수약정금액 | String | Y | 19 | |
| -agrm_amt_smtl | 약정금액합계 | String | Y | 19 | |
| -sll_fee | 매도수수료 | String | Y | 19 | |
| -buy_fee | 매수수수료 | String | Y | 19 | |
| -fee_smtl | 수수료합계 | String | Y | 19 | |
| -trad_pfls_smtl | 매매손익합계 | String | Y | 19 |
Example
Request
{
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_STRT_DAY":"20230901",
"INQR_END_DAY":"20230920",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
"CANO":"12345678",
"ACNT_PRDT_CD":"03",
"INQR_STRT_DAY":"20230901",
"INQR_END_DAY":"20230920",
"CTX_AREA_FK200":"",
"CTX_AREA_NK200":""
}
Response
{
"ctx_area_fk200": "12345678!^03!^20230901!^20230920 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"ord_dt": "20230901",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230904",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230905",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230906",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230907",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230908",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230911",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230914",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4101TC0008",
"item_name": "F 202312",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "419375000",
"buy_fee": "41140",
"tot_fee_smtl": "41140",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4201TA3409",
"item_name": "C 202310 340.0",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "700000",
"buy_fee": "2750",
"tot_fee_smtl": "2750",
"trad_pfls": "0"
}
],
"output2": {
"futr_agrm": "0",
"futr_agrm_amt": "419375000",
"futr_agrm_amt_smtl": "419375000",
"futr_sll_fee_smtl": "0",
"futr_buy_fee_smtl": "41140",
"futr_fee_smtl": "41140",
"opt_agrm": "0",
"opt_agrm_amt": "700000",
"opt_agrm_amt_smtl": "700000",
"opt_sll_fee_smtl": "0",
"opt_buy_fee_smtl": "2750",
"opt_fee_smtl": "2750",
"prdt_futr_agrm": "0",
"prdt_fuop": "0",
"prdt_futr_evlu_amt": "0",
"futr_fee": "0",
"opt_fee": "0",
"fee": "0",
"sll_agrm_amt": "0",
"buy_agrm_amt": "420075000",
"agrm_amt_smtl": "420075000",
"sll_fee": "0",
"buy_fee": "43890",
"fee_smtl": "43890",
"trad_pfls_smtl": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
"ctx_area_fk200": "12345678!^03!^20230901!^20230920 ",
"ctx_area_nk200": " !^ ",
"output1": [
{
"ord_dt": "20230901",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230904",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230905",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230906",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230907",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230908",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230911",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230914",
"pdno": "KR4101T90003",
"item_name": "F 202309",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "0",
"buy_fee": "0",
"tot_fee_smtl": "0",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4101TC0008",
"item_name": "F 202312",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "419375000",
"buy_fee": "41140",
"tot_fee_smtl": "41140",
"trad_pfls": "0"
},
{
"ord_dt": "20230920",
"pdno": "KR4201TA3409",
"item_name": "C 202310 340.0",
"sll_agrm_amt": "0",
"sll_fee": "0",
"buy_agrm_amt": "700000",
"buy_fee": "2750",
"tot_fee_smtl": "2750",
"trad_pfls": "0"
}
],
"output2": {
"futr_agrm": "0",
"futr_agrm_amt": "419375000",
"futr_agrm_amt_smtl": "419375000",
"futr_sll_fee_smtl": "0",
"futr_buy_fee_smtl": "41140",
"futr_fee_smtl": "41140",
"opt_agrm": "0",
"opt_agrm_amt": "700000",
"opt_agrm_amt_smtl": "700000",
"opt_sll_fee_smtl": "0",
"opt_buy_fee_smtl": "2750",
"opt_fee_smtl": "2750",
"prdt_futr_agrm": "0",
"prdt_fuop": "0",
"prdt_futr_evlu_amt": "0",
"futr_fee": "0",
"opt_fee": "0",
"fee": "0",
"sll_agrm_amt": "0",
"buy_agrm_amt": "420075000",
"agrm_amt_smtl": "420075000",
"sll_fee": "0",
"buy_fee": "43890",
"fee_smtl": "43890",
"trad_pfls_smtl": "0"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
(야간)선물옵션 증거금 상세 [국내선물-024]
REST
(야간)선물옵션 증거금 상세 [국내선물-024]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain미지원
- URL/uapi/domestic-futureoption/v1/trading/ngt-margin-detail
- Format
- Content-Type
개요
(야간)선물옵션 증거금상세 API입니다.
한국투자 HTS(eFriend Force) > [2537] 야간선물옵션 증거금상세 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Force) > [2537] 야간선물옵션 증거금상세 화면 의 기능을 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 | JTCE6003R |
| 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 | |
| CRCY_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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| 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
아래 18가지 항목이 순서대로 출력됨 (1) A. 신규증거금 - 선물 - 1.개별종목 (2) A. 신규증거금 - 선물 - 2.스프레드 (3) A. 신규증거금 - 3. 옵션매수증거금 (4) A. 신규증거금 - 4. 옵션매도증거금 (5) A. 소계(1+2+3+4) (6) B. 순위험증거금 - 1. 가격변동증거금 (7) B. 순위험증거금 - 2. 선물스프레드증거금 (8) B. 순위험증거금 - 3. 인수수도 증거금 등 (9) B. 순위험증거금 - 4. 최소증거금 (10) B. 순위험증거금 - 5. 옵션가격증거금 (11) B. 순위험증거금 - 6. 총위험증거금 (12) B. 소계SUM상품군별MAX[{MAX(1+2+3,4)+5},6] (13) C. 결제예정금액 - 1. 당일옵션매수금액 (14) C. 결제예정금액 - 2. 당일옵션매도금액 (15) C. 결제예정금액 - 3. 당일선물손실 (16) C. 결제예정금액 - 4. 당일선물이익 (17) C.소계(1-2+3-4) (18) (A)+B+(C) |
|
| -cash_amt | 현금금액 | String | Y | 19 | |
| -tot_amt | 총금액 | String | Y | 19 | |
| output2 | 응답상세 | Object Array | Y | array
아래 5가지 항목이 순서대로 출력됨 (1) 예수금 (2) 인출가능금액 (3) 주문가능금액 (4) 위탁증거금액 (5) 추가증거금액 ※ 인출가능금액은 정산 후 인출가능 예정 금액입니다. 현재 시점 실제 인출 가능금액은 정규장, 야간시장 인출가능금액 중 적은 금액 기준입니다. |
|
| -cash_amt | 현금금액 | String | Y | 19 | |
| -sbst_amt | 대용금액 | String | Y | 19 | |
| -tot_amt | 총금액 | String | Y | 19 | |
| output3 | 응답상세 | Object | Y | ||
| -base_dpsa_gdat_grad_cd | 기본예탁금차등등급코드 | String | Y | 2 | |
| -bfdy_sbst_sll_ccld_amt | 전일대용매도체결금액 | String | Y | 19 | |
| -bfdy_sbst_sll_sbst_amt | 전일대용매도대용금액 | String | Y | 19 | |
| -excc_dfpa | 정산차금 | String | Y | 19 | |
| -fee_amt | 수수료금액 | String | Y | 19 | |
| -nxdy_dncl_amt | 익일예수금액 | String | Y | 19 | |
| -opt_base_dpsa_gdat_grad_cd | 옵션기본예탁금차등등급코드 | String | Y | 2 | |
| -opt_buy_exus_acnt_yn | 옵션매수전용계좌여부 | String | Y | 1 | |
| -opt_dfpa | 옵션차금 | String | Y | 19 | |
| -prsm_dpast_amt | 추정예탁자산금액 | String | Y | 19 | |
| -thdt_sbst_sll_ccld_amt | 당일대용매도체결금액 | String | Y | 19 | |
| -thdt_sbst_sll_sbst_amt | 당일대용매도대용금액 | String | Y | 19 |
Example
Request
CANO:12345678
ACNT_PRDT_CD:03
MGNA_DVSN_CD:01
ACNT_PRDT_CD:03
MGNA_DVSN_CD:01
Response
{
"output1": [
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
}
],
"output2": [
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
}
],
"output3": {
"bfdy_sbst_sll_sbst_amt": "0",
"thdt_sbst_sll_sbst_amt": "0",
"bfdy_sbst_sll_ccld_amt": "0",
"thdt_sbst_sll_ccld_amt": "0",
"opt_buy_exus_acnt_yn": "N",
"base_dpsa_gdat_grad_cd": "03",
"opt_dfpa": "0",
"excc_dfpa": "0",
"fee_amt": "0",
"nxdy_dncl_amt": "100000000",
"prsm_dpast_amt": "100000000",
"opt_base_dpsa_gdat_grad_cd": "01"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}
"output1": [
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"tot_amt": "0"
}
],
"output2": [
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "100000000",
"sbst_amt": "0",
"tot_amt": "100000000"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
},
{
"cash_amt": "0",
"sbst_amt": "0",
"tot_amt": "0"
}
],
"output3": {
"bfdy_sbst_sll_sbst_amt": "0",
"thdt_sbst_sll_sbst_amt": "0",
"bfdy_sbst_sll_ccld_amt": "0",
"thdt_sbst_sll_ccld_amt": "0",
"opt_buy_exus_acnt_yn": "N",
"base_dpsa_gdat_grad_cd": "03",
"opt_dfpa": "0",
"excc_dfpa": "0",
"fee_amt": "0",
"nxdy_dncl_amt": "100000000",
"prsm_dpast_amt": "100000000",
"opt_base_dpsa_gdat_grad_cd": "01"
},
"rt_cd": "0",
"msg_cd": "KIOK0510",
"msg1": "조회가 완료되었습니다 "
}