koreasecurities

krsec

한국 증권사 REST API 통합 게이트웨이. 증권사마다 다른 인증, 파라미터, 응답 구조를 broker.Broker 인터페이스 하나로 통일합니다.

지원 증권사

설치

go install github.com/smallfish06/krsec/cmd/krsec@latest

바이너리: Releases

설정

cp config.example.yaml config.yaml

server:
  port: 8080

accounts:
  - name: "main"
    broker: kis
    sandbox: true
    app_key: "YOUR_APP_KEY"
    app_secret: "YOUR_APP_SECRET"
    account_id: "12345678-01"

실행

krsec -config config.yaml

API

curl http://localhost:8080/quotes/KRX/005930

{"ok": true, "data": {"symbol": "005930", "price": 70000, ...}, "broker": "KIS"}

라이브러리로 사용

import (
    "github.com/smallfish06/krsec/pkg/broker"
    apiserver "github.com/smallfish06/krsec/pkg/server"
)

srv := apiserver.New(apiserver.Options{
    Port: 8080,
    Accounts: []apiserver.Account{{ID: "acc-1", Name: "Main", Broker: "custom"}},
    Brokers:  map[string]broker.Broker{"acc-1": myBroker},
})
srv.Run()

구조

cmd/krsec/        서버
pkg/broker/           공개 인터페이스
pkg/server/           임베드 가능한 HTTP 서버
internal/kis/         KIS 클라이언트 + 어댑터
internal/kiwoom/      키움 클라이언트 + 어댑터
internal/server/      HTTP 핸들러
examples/             사용 예시

개발

make test      # 테스트
make build     # 빌드
make lint      # lint
make mock      # mock 재생성

License

Apache 2.0