API 문서 오류 및 문의

[pjueon]

KIS Develovers 홈페이지의 API 문서 상의 오류를 확인하여 문의드립니다.

1. 해외주식 주문(해외주식 주문[v1_해외주식-001])시 Hashkey 필요 여부

문서 상에는 hashkey 항목의 required 항목이 "N"으로 되어있지만,
실제로 hashkey 적용없이 주문을 보내면 오류가 발생합니다. hashkey를 사용하도록 수정하면 정상 동작합니다.

2. 미국주식 미체결내역 조회 관련 문서 오류

"해외주식 미체결내역" 문서 상에는 거래소코드 부분에 "NASD : 나스닥, NYSE : 뉴욕, AMEX : 아멕스" 라고 되어있지만,
"NASD"나 "NAS"로 설정하면 미국전체(나스닥, 뉴욕, 아멕스)에 대한 내용이 반환됩니다.

3. 해외거래소코드 형식(4자리 or 3자리) 관련

"해외주식주문" 카테고리에 있는 API들에서는 해외거래소코드를 4자리의 코드로 사용하지만 "해외주식현재가" 카테고리에 있는 API들의 경우 3자리의 코드를 사용하는듯 합니다. 이는 특별한 이유가 없다면 한가지 방식으로 통합해주실 수는 없을까요?

또한 "해외주식 잔고" API의 문서를 보면 "NASD : 미국전체, NAS : 나스닥, NYSE : 뉴욕, AMEX : 아멕스"라고 나와있는데
이 API에 대해서만 "미국전체"라는 옵션이 존재하고, 다른 API들과는 "NASD", "NAS"의 의미가 달라서 매우 혼란스럽습니다.
이 부분도 혹시 수정 해주실 수 있을까요?

[pjueon]

@mingi3314
확인 부탁드립니다

[pjueon]

@koreainvestment
멘션을 착각하여 잘못 보냈네요. 확인 부탁드립니다.

[koreainvestment]

@pjueon

안녕하세요.
KIS Developers 팀입니다.

답변이 늦어 죄송합니다. 문의주신 내용에 대한 답변을 드립니다.

1. 해외주식 주문(해외주식 주문[v1_해외주식-001])시 Hashkey 필요 여부
   문서 상에는 hashkey 항목의 required 항목이 "N"으로 되어있지만,
   실제로 hashkey 적용없이 주문을 보내면 오류가 발생합니다. hashkey를 사용하도록 수정하면 정상 동작합니다.

지적 감사합니다!
말씀해주신대로 문서에 오류가 있었던 것 같습니다. 현재는 수정 반영되어 있습니다.

다만 이제 POST API 호출 시 header값으로 필수적으로 전달했던
"hashkey": HASH_KEY 값을 필수 → 비필수 값으로 변경했습니다.

hashkey를 전달하는 것이 필요치 않다는 고객요청이 빈번하여 hashkey를 옵션화 하였으므로
주문요청 과정에서 변작에 대한 우려를 갖는 고객께서는 hashkey를 사용하시면 되고
불필요하신 고객은 header에서 hashkey를 제거하시어도 정상 호출됩니다. 사용에 참고하시길 바랍니다.

2. 미국주식 미체결내역 조회 관련 문서 오류
   "해외주식 미체결내역" 문서 상에는 거래소코드 부분에 "NASD : 나스닥, NYSE : 뉴욕, AMEX : 아멕스" 라고 되어있지만,
   "NASD"나 "NAS"로 설정하면 미국전체(나스닥, 뉴욕, 아멕스)에 대한 내용이 반환됩니다.

해당 부분 IT 확인이 필요한 사항으로 확인 후 재회신드리겠습니다.

3. 해외거래소코드 형식(4자리 or 3자리) 관련
   "해외주식주문" 카테고리에 있는 API들에서는 해외거래소코드를 4자리의 코드로 사용하지만 "해외주식현재가" 카테고리에 있는 API들의 경우 3자리의 코드를 사용하는듯 합니다.
   이는 특별한 이유가 없다면 한가지 방식으로 통합해주실 수는 없을까요?

해당 TR을 수정해야 하는 부분이라 현재 당장 코드 방식을 통일하는 것은 불가능할 것 같습니다.ㅠㅠ
다만 IT 검토를 재요청해보겠습니다.

4. 또한 "해외주식 잔고" API의 문서를 보면 "NASD : 미국전체, NAS : 나스닥, NYSE : 뉴욕, AMEX : 아멕스"라고 나와있는데
   이 API에 대해서만 "미국전체"라는 옵션이 존재하고, 다른 API들과는 "NASD", "NAS"의 의미가 달라서 매우 혼란스럽습니다.
   이 부분도 혹시 수정 해주실 수 있을까요?

이 부분도 마찬가지로 해당 TR을 수정해야 하는 부분이라 빠른 수정이 어려울 것 같습니다. IT 검토를 재요청해놓겠습니다.

추가적인 문의사항이 있으시면 언제든 문의 부탁드립니다.
KIS Developers - Q&A 게시판을 사용하시면 좀 더 빠른 확인이 가능한 점 참고 부탁드립니다.

2번째 내용 확인 후 재회신드리겠습니다. 감사합니다 :)

[koreainvestment]

@pjueon
2.
IT 확인이 완료되어 회신드립니다.
해외주식 미체결내역[v1_해외주식-005] API의 경우, 보통 거래소별 구분 없이 미국 전체에 대해서 조회를 하는 경우가 많아 OVRS_EXCG_CD(해외거래소코드)에 'NASD' 입력 시 미국 전체에 대하여 결과가 출력되게끔 코딩되어 있습니다.
따라서 API문서를 NASD : 미국 전체로 수정하였습니다. 참고 부탁드립니다.

[pjueon]

@koreainvestment
답변 감사합니다.

그렇다고 하면 4번과도 연결되는 이야기지만 다른 API들에서도 그냥 NYSE, AMEX를 없애버리고 미국 시장을 한가지 코드로 가는게 깔끔하지 않을까 생각이 드네요. 뉴욕, 아멕스만 조회하는 기능이 꼭 필요하다고 하면 특정 API에서는 나스닥만 조회하는 기능이 빠져있는 것도 사용자 입장에서는 혼란스럽습니다. 추후 꼭 개선 됐으면 좋겠습니다.