KiwoomRestApi.Net

키움 REST API를 위한 현대적이고 직관적인 완전 비동기 .NET 래퍼입니다.

Getting Started API Reference Tutorial

🎮 실전 투입 전 전략을 검증하고 싶다면? 모의투자 게임 플랫폼 ox64.app 에서 먼저 테스트해보세요.

Why KiwoomRestApi.Net?

⚡

Fully Asynchronous

최신 C# async/await 패턴을 활용하여 블로킹 없는 고성능 API 호출을 구현합니다.

📦

Comprehensive Coverage

계정 정보, 차트, 주문, WebSocket 실시간 데이터 등 190개 이상의 API를 지원합니다.

📑

Intuitive & Type-Safe

유창한 API와 강력한 타입 지정으로 오류를 최소화하고 개발자 경험을 향상시킵니다.

🔒

OAuth 2.0 Built-in

접근 토큰 발급 및 폐기를 포함한 OAuth 2.0 인증이 내장되어 있습니다.

📈

Real-time WebSocket

체결, 호가, 잔고 등 실시간 데이터를 WebSocket으로 수신할 수 있습니다.

🌐

Gold Spot Trading

금현물 거래, 잔고 조회, 차트 등 금현물 관련 API를 완벽하게 지원합니다.

API Coverage

16개 카테고리에 걸쳐 190개 이상의 API 메서드를 제공합니다.

Account

Chart

StockInfo

MarketCondition

RankingInfo

ELW

ETF

Order

Getting Started

몇 분 안에 KiwoomRestApi.Net을 시작할 수 있습니다.

1. Installation

dotnet add package KiwoomRestApi.Net

2. Basic Usage

using KiwoomRestApi.Net.Clients;
using KiwoomRestApi.Net.Enums.StockInfo;

// 클라이언트 생성
var client = KiwoomRestApiClient.Create("YOUR_APP_KEY", "YOUR_SECRET_KEY", isMock: true);

// 삼성전자 주식 정보 가져오기
var stockInfo = await client.StockInfo.GetStockInfoAsync(
    stockCode: "005930",
    date: DateTime.Today,
    marginLoanType: KiwoomStockInfoMarginLoanType.Loan
);

if (stockInfo.IsSuccess)
{
    Console.WriteLine($"Stock: {stockInfo.Data?.StockName}");
    Console.WriteLine($"Price: {stockInfo.Data?.CurrentPrice:N0} KRW");
}
else
{
    Console.WriteLine($"Error: {stockInfo.ReturnMessage}");
}

Note: 개발 및 테스트 시에는 isMock: true로 설정하여 모의투자 모드를 사용하세요. 프로덕션 준비가 되면 false로 변경하세요.