자주 묻는 질문

이동평균·RSI·MACD·볼린저밴드 같은 보조지표를 직접 반환하는 전용 TR은 제공하지 않습니다. 차트 데이터(t8410 일봉 / t8412 분봉 등)를 받아 클라이언트에서 계산하는 것이 표준 방식입니다. 전략 스튜디오의 샘플 코드에 지표 계산 예제가 포함되어 있으니 참고하세요.

상품선물(국내) 주문은 CFOAT00100(신규 주문), CFOAT00200(정정), CFOAT00300(취소)을 사용합니다. 잔고·체결 조회는 CFOAQ 계열 TR을 참고하세요.

주식선물 주문은 CFOAT00100 계열을 공통으로 사용하되, 종목코드에 주식선물 종목코드를 넣어 요청합니다. 상품/주식 선물은 종목코드 체계로 구분되며 주문 TR 자체는 동일 계열을 공유합니다.

해외선물은 별도 계좌 개설과 거래 신청이 필요합니다. 계좌가 준비되면 해외선물 주문 TR o3101(시세), CIDBT00100(주문) 계열을 사용합니다.

• 해외선물 전용 실계좌/모의계좌 개설
• 해외 파생상품 거래 약관 동의
• 해외선물 TR 권한 확인 후 주문 API 호출

모의투자 서버는 정규장 시간(09:00~15:30)에만 주문이 체결되며, 장 시작 전·점심 정산 시간·서버 점검 중에는 해당 메시지가 발생할 수 있습니다. 또한 모의투자는 실거래 대비 체결 처리에 지연이 있을 수 있으니, 응답 코드를 확인한 뒤 일정 간격을 두고 재시도하도록 구현하세요.

표준코드(ISIN) 또는 일부 화면에서 사용하는 표기 방식 때문입니다. 'A'는 보통주를 의미하는 접두 문자로, API 입력 시에는 'A'를 제외한 6자리 단축코드만 사용합니다. 예: A005930 → 005930으로 요청하세요.

응답의 연속 키(cts_ 필드)가 비어있지 않으면 다음 데이터가 더 있다는 의미입니다. 해당 키를 다음 요청의 입력에 그대로 넣고, 연속 조회 플래그를 true로 설정해 반복 호출합니다.

cts = ""
while True:
    res = api.request("t1305", {"shcode": "005930", "cts_date": cts}, cont=bool(cts))
    cts = res["t1305OutBlock"]["cts_date"]
    if not cts.strip(): break

실시간 뉴스 헤드라인은 t3102(뉴스 본문), t3101(뉴스 제목 목록)으로 조회합니다. 실시간 수신이 필요하면 실시간 TR NWS를 구독하세요.

• 제목 목록: t3101 ― 날짜·종목별 헤드라인
• 본문: t3102 ― 뉴스 키(realkey)로 상세 조회
• 실시간: NWS ― 신규 뉴스 푸시 수신

종목 마스터 조회 TR로 전체 종목 목록을 내려받은 뒤, 종목명·코드로 필터링하는 방식이 일반적입니다. OPEN API는 t8430(주식 종목 조회), xingAPI는 t8436(주식 종목 마스터)을 사용합니다.

res = api.request("t8430", {"gubun": "0"})  # 0:전체 1:코스피 2:코스닥
items = [x for x in res["t8430OutBlock"] if "삼성" in x["hname"]]