오픈소스 · 키는 내 컴퓨터 밖으로 나가지 않음 · MIT

국내 증권사 오픈 API,
하나의 인터페이스로.

넥스트·한국투자·키움·NH·LS·DB·토스·KB 의 시세·주문·계좌·실시간 스트림을
Kotlin·Python·JavaScript·Go 에서 같은 코드로 다룹니다.

quotes.pyhermetix

# 한 가지 API — 증권사만 고른다
import hermetix

client = hermetix.next(api_key="...", api_secret="...", account="...")
quote = client.get_quotes(["005930"])[0]

quote.price          # Decimal("71300")
client.get_candles("005930", CandleInterval.DAY_1, limit=30)
client.get_holdings()

responseunified

symbol"005930"

price71,300

bid / ask71,200 / 71,300

changeRate+0.0126

brokernext

같은 모양, 어느 증권사든 — 단위·부호·자릿수는 어댑터가 정규화

8증권사 어댑터

4언어 (Kotlin · Python · JS · Go)

12통일된 API 기능

MIT오픈소스 라이선스

한 번 쓰고, 어느 증권사에서나.

Hermetix 는 증권사마다 다른 오픈 API 를 하나의 인터페이스로 정규화합니다. 한 곳에서 작성한 코드가 나머지 증권사에서도 그대로 돕니다.

통일된 시세

현재가, 캔들(1m·1d), 거래일 캘린더를 같은 모델로. 부호 접두·zero-padding·TR-ID 같은 증권사 방언은 어댑터가 흡수합니다.

통일된 주문·계좌

주문 생성·조회·취소, 체결 내역, 계좌·보유·주문 가능 금액을 하나의 호출로. 금액·수량은 전부 Decimal 입니다.

실시간 스트림

체결가·호가·주문 통보를 같은 MarketStream 으로 구독합니다. 재접속·하트비트는 공용 부품이 처리합니다.

전략 엔진

StrategySpec 과 decide() 만 쓰면 정규장 시간 판단, 익절·손절, 비상정지는 엔진이 대신합니다.

키는 로컬에만

클라이언트 라이브러리입니다. API 키와 주문은 내 프로그램에서 증권사 서버로 직접 갑니다. 중간 서버가 없습니다.

공개 사용량 데이터

어느 증권사·기능이 실제로 쓰이는지, 각 API 의 에러율과 응답 시간은 어떤지 공개합니다.

사용량 랭킹 →API 현황 →

설치는 한 줄.

쓰는 언어의 패키지 관리자 명령 하나면 됩니다. 실시간 스트림은 Python 만 선택 설치입니다.

$pip install hermetix

$npm install hermetix

$go get github.com/tripleauth-dev/hermetix-securities/go@latest

gradleimplementation("com.github.tripleauth-dev.hermetix-securities:hermetix-engine:0.11.1")

Kotlin 은 JitPack 저장소(maven("https://jitpack.io"))를 추가합니다. Python 실시간: pip install 'hermetix[stream]'

전략 봇 템플릿으로 시작

예제 전략과 테스트가 들어 있습니다. 쓰는 언어 폴더를 복제해 전략 클래스만 바꾸세요.

Pythonpython -m strategyTypeScriptnpm startGogo run .Kotlin./gradlew bootRun

자주 묻는 질문

라이브러리, 라이선스, 그리고 데이터에 대해.

Hermetix 는 무엇인가요?+

국내 증권사 오픈 API 를 하나의 인터페이스로 묶은 오픈소스 트레이딩 라이브러리입니다. 연결 계층(시세·주문·계좌·스트림)만 써도 되고, 전략 엔진까지 써서 봇을 만들 수도 있습니다. Kotlin 이 레퍼런스이고 Python·JavaScript·Go 는 같은 규약을 손으로 포팅한 네이티브 구현입니다.

무료인가요?+

MIT 라이선스입니다. 상업적 사용을 포함해 자유롭게 쓸 수 있습니다. 증권사 API 이용 조건과 계좌 개설은 각 증권사 정책을 따릅니다.

내 API 키나 자금을 보관하나요?+

아니요. Hermetix 는 내 프로그램 안에서 실행되는 라이브러리이고, 키와 주문은 증권사 서버로 직접 전송됩니다. 게이트웨이나 중간 서버는 없습니다.

어떤 증권사·언어를 지원하나요?+

한국투자·키움·넥스트는 모의 서버로 실측 검증됐고, NH·LS·DB·토스·KB 는 공식 문서 기반 구현으로 아직 미검증입니다. 언어는 Kotlin/JVM, Python 3.10+, JavaScript/TypeScript(Node 22+), Go 입니다. 검증 상태는 API 현황 페이지에서 확인할 수 있습니다.

사용량 텔레메트리는 무엇을 보내나요?+

증권사·환경(모의/실전)·호출 종류별 건수·에러 분류·응답 시간 분포·스트림 건수·SDK 버전·설치 단위 무작위 ID 만 보냅니다. 종목·수량·가격·계좌·주문번호·키·전략 이름·IP 는 절대 보내지 않습니다. 이 데이터로 사용량 랭킹과 API 현황을 공개합니다. 항목 전체는 docs/telemetry.md 에 있습니다.

국내 증권사 오픈 API,하나의 인터페이스로.