한국 주식 거래 시작하기

한국 주식은 증권사 오픈API 로 주문하고 시세를 받습니다. 암호화폐 거래소와 절차가 다릅니다 — 증권사 계좌가 먼저 있어야 합니다.

지원하는 증권사

• 과거 봉 수집: 백테스트는 내 에이전트 저장소의 캔들로 돕니다. 과거 봉을 받을 수 있는 증권사는 한국투자증권(KRX)·토스증권(KRX·NXT 통합) 입니다 — 다른 증권사 키로는 주문·시세·오늘 분봉까지만 됩니다(백테스트용 수집은 위 두 곳 키가 필요합니다).
• 미검증 경고: 실계좌 왕복이 아직 확인되지 않은 연동입니다. 자동 실행을 막지는 않고 배포할 때 이유를 함께 알려줍니다 — 모의 키가 있으면 모의로 먼저, 없으면(실전 전용) 소액으로 먼저 확인하세요.
• 증권사·시장은 따로 고릅니다: 시장(한국거래소 또는 KRX·NXT 통합)이 먼저고, 그 시장을 파는 증권사가 주문 경로입니다.

순서

1. 증권사 계좌 개설 — 이미 있다면 그대로 씁니다.

2. 그 증권사의 오픈API 신청 — 각 증권사 오픈API 센터에서 신청하고 앱 키·시크릿을 받습니다.

• ★ 주문·조회 권한만 신청하세요. 증권사 API 는 거래소와 달리 출금 권한 여부를 저희가 자동으로 확인할 수 없습니다.
• 모의투자 키를 주는 증권사는 모의 키를 먼저 받아 두세요(실계좌 키와 따로 나옵니다).

3. 에이전트에 키 등록 — 에이전트 관리 → API 키에서 시장 → 증권사 → 환경(실전/모의) 을 고르고 앱 키·시크릿, 그리고 위 표의 '키 외에 넣는 것'을 넣습니다.

• 한국투자증권 계좌번호는 12345678-01 형식(앞 8자리 계좌 - 뒤 2자리 상품코드)이고, HTS/MTS 의 하이픈 없는 10자리도 그대로 됩니다(종합계좌는 보통 뒤 01).

4. 연결 확인 — 잔고 조회가 되면 준비 끝입니다. 미검증 증권사는 모의 키(없으면 소액)로 주문이 증권사까지 갔다 오는지 한 번 확인해 두세요.

API 키는 내 서버(에이전트)에만 저장됩니다. 소리트레이딩 서버로는 보내지 않으며, 서버는 주문을 개시하지 않습니다.

주식은 코인과 다릅니다

전략을 짜기 전에 알아야 할 것들입니다.

• 거래시간 — 평일 09:00–15:30 (KST), 하루 6.5시간. 주말·공휴일은 쉽니다. 24시간 돌아가는 코인 전략을 그대로 옮기면 대부분의 시간 동안 아무 일도 일어나지 않습니다.
• 4시간 봉이 없습니다 — 하루가 6.5시간이라 4시간으로 나눠지지 않습니다. 1분·5분·15분·1시간·1일을 씁니다(토스증권의 KRX·NXT 통합 시장은 증권사가 주는 1분·1일만).
• 증권거래세 — 매도할 때마다 붙습니다(현재 0.18% 수준, 변동). 코인 수수료보다 훨씬 큽니다. 자주 사고파는 전략일수록 세금에 먹힙니다 — 세금이 빠진 백테스트는 실제보다 훨씬 좋아 보입니다.
• 상하한가 — 하루 ±30% 를 넘지 않습니다. 그보다 크게 움직인다고 가정한 전략은 체결되지 않습니다.
• 수량은 정수 — 0.5주 같은 주문은 없습니다. 코인 습관대로 소수 수량을 넣으면 증권사에 가기 전에 저희가 거부합니다.
• 액면분할·배당 — 과거 주가가 나중에 바뀝니다. 저희는 원주가를 그대로 저장하고 조정계수를 따로 둡니다.
• 종목이 3,400개가 넘습니다 — 한두 종목을 정해두기보다 조건으로 훑는(스캔) 전략이 주식에서는 훨씬 잘 맞습니다.

먼저 페이퍼로

주식 페이퍼 트레이딩은 에이전트의 가상 지갑에서 체결합니다. 시세·호가는 내 증권사 키로 받은 실시간 값이고(서버 시세가 아닙니다), 정수 주식만 되며 매도 거래세를 더합니다 — 증권사 수수료는 계좌마다 달라 반영하지 않습니다. 모의투자 키를 주는 증권사라면, 페이퍼 뒤에 모의 키로 실거래 경로(주문이 증권사까지 가는 길)를 한 번 더 확인한 뒤 실계좌 키로 넘어가세요.

해외 주식은?

• IBKR(인터랙티브 브로커스) — 미국·해외 거래소를 IBKR 게이트웨이로 연결합니다. 앱 키 대신 에이전트 관리 → 키 → [IBKR] 에서 게이트웨이를 설정합니다. 코드는 준비됐지만 실기기 확인 전입니다.
• 해외 증권사 — 에이전트 관리 → API 키 → [주식] 에서 시장 → 증권사를 고르고 그 증권사가 요구하는 칸을 채웁니다. 지금은 터미널에서 직접 내는 수동 주문만 됩니다 — 이 연결들에는 아직 시세·봉·잔고가 없어서 전략 자동 실행에는 쓸 수 없습니다(배포 화면에 나오지 않고, 서버도 이유와 함께 거절합니다).
• 연결 테스트 — 아직 검증되지 않은 해외 증권사는 키 줄의 [연결 테스트]로 내 계좌에서 소액 왕복(잔고 조회 → 지정가 매수 → 체결 확인 → 매도 → 잔고 0 확인)을 해 볼 수 있습니다. 실제 주문이고, 단계마다 직접 확인해야 다음으로 넘어갑니다. 끝까지 마치면 완료 기록(증권사·성공 여부 — 계좌번호·잔고·체결 내용은 저장하지 않음)이 계정에 남고, 서로 다른 사용자 10명이 마치면 그 증권사가 '검증됨'으로 바뀝니다.
• 해외 증권사에 자동 실행이 열리면, 10명 집계를 기다리지 않고 내 계좌로 연결 테스트를 통과한 계정부터 바로 쓸 수 있습니다(키를 바꾸면 다시 테스트).

소리트레이딩는 투자 판단이나 조언을 제공하지 않습니다. 확정 수익이나 원금을 보장하지 않습니다.