Microsoft MVP성태의 닷넷 이야기
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일

C# XingAPI - 주식 종목에 따른 PBR, PER, ROE, ROA 등의 재무정보 구하는 방법(t3320, t8430 예제)

^^ 먼지 쌓인(?) XingAPINet을 다시 꺼냈는데요,

eBEST XingAPI의 C# 래퍼 버전 - XingAPINet Nuget 패키지
; https://www.sysnet.pe.kr/2/0/12134

그새 뭐가 많이 바뀌었는지 기존 코드로는 로그인도 안 되는군요. ^^; 일단 XingAPINet을 업데이트했고 1.1.5 버전으로 nuget에 올려두었습니다.

XingAPINet
; https://www.nuget.org/packages/XingAPINet/

자, 그럼 이것을 참조 추가해서,

Install-Package XingAPINet

다음과 같이 로그인 과정까지 완료할 수 있습니다.

using System;
using XingAPINet;

internal class Program
{
    static void Main(string[] args)
    {
        bool useDemoServer = true;
        Program pg = new Program();

        if (args.Length == 1)
        {
            if (args[0] == "hts")
            {
                useDemoServer = false;
            }
        }

        pg.Main(useDemoServer);
    }

    void Main(bool useDemoServer)
    {
        LoginInfo user = LoginInfo.FromPlainText("...id...", "...password...",
                                                 "...인증서 password..."); // 만약 demo 서버 접속이라면 인증서 계정은 필요 없습니다.

        using (XingClient xing = new XingClient(useDemoServer))
        {
            if (xing.ConnectWithLogin(user) == false)
            {
                Console.WriteLine(xing.ErrorMessage);
                return;
            }
        }
    }
}

그다음, 해야 할 일은 KODAQ과 KOSPI에 상장된 주식 종목을 가져오면 되는데요, 이것은 t8430 API를 이용해,

BEGIN_FUNCTION_MAP
    .Func,주식종목조회(t8430),t8430,block,headtype=A;
    BEGIN_DATA_MAP
    t8430InBlock,기본입력,input;
    begin
        구분(0:전체1:코스피2:코스닥),gubun,gubun,char,1;
    end
    t8430OutBlock,출력1,output,occurs;
    begin
        종목명,hname,hname,char,20;
        단축코드,shcode,shcode,char,6;
        확장코드,expcode,expcode,char,12;
        ETF구분(1:ETF),etfgubun,etfgubun,char,1;
        상한가,uplmtprice,uplmtprice,long,8;
        하한가,dnlmtprice,dnlmtprice,long,8;
        전일가,jnilclose,jnilclose,long,8;
        주문수량단위,memedan,memedan,char,5;
        기준가,recprice,recprice,long,8;
        구분(1:코스피2:코스닥),gubun,gubun,char,1;
    end
    END_DATA_MAP
END_FUNCTION_MAP

다음과 같이 간단하게 해결할 수 있습니다.

private SHCodeInfo[] GetStockList()
{
    List<SHCodeInfo> list = new List<SHCodeInfo>();

    foreach (var block in XQt8430.Get(XQt8430Gubun.전체))
    {
        if (block.etfgubun != '0') // ETF/ETN 유형은 제거
        {
            continue;
        }

        if (block.shcode[5] != '0') // 보통주만 허용
        {
            continue;
        }

        SHCodeInfo code = new SHCodeInfo(block.hname, block.shcode, block.expcode, false, false);
        list.Add(code);
    }

    return list.ToArray();
}

위의 코드를 보면, PBR과 PER 등의 정보는 주식과 관련이 있기 때문에 ETF/ETN에 해당하는 종목은 걸러내고 있습니다. 또한 우선주의 경우에는 이후 정보를 가져올 t3320 API로는 값이 안 나오기 떄문에 이것 역시 보통주만 선택하도록 필터링합니다.

자, 그다음 마지막으로 이제 해당 주식을 발행하는 회사의 PBR과 PER 등의 정보를 가져와야 하는데요, 이것은 t3320 API를 이용해 가져올 수 있습니다.

BEGIN_FUNCTION_MAP
    .Func,FNG_요약(t3320),t3320,attr,block,headtype=A;
    BEGIN_DATA_MAP
    t3320InBlock,기본입력,input;
    begin
        종목코드,gicode,gicode,char,7;
    end
    t3320OutBlock,기업기본정보,output;
    begin
        업종구분명,upgubunnm,upgubunnm,char,20;
        시장구분,sijangcd,sijangcd,char,1;
        시장구분명,marketnm,marketnm,char,10;
        한글기업명,company,company,char,100;
        본사주소,baddress,baddress,char,100;
        본사전화번호,btelno,btelno,char,20;
        최근결산년도,gsyyyy,gsyyyy,char,4;
        결산월,gsmm,gsmm,char,2;
        최근결산년월,gsym,gsym,char,6;
        주당액면가,lstprice,lstprice,long,12;
        주식수,gstock,gstock,long,12;
        Homepage,homeurl,homeurl,char,50;
        그룹명,grdnm,grdnm,char,30;
        외국인,foreignratio,foreignratio,float,6.2;
        주담전화,irtel,irtel,char,30;
        자본금,capital,capital,float,12.0;
        시가총액,sigavalue,sigavalue,float,12.0;
        배당금,cashsis,cashsis,float,12.0;
        배당수익율,cashrate,cashrate,float,13.2;
        현재가,price,price,long,8;
        전일종가,jnilclose,jnilclose,long,8;
        위험고지구분1_정리매매,notice1,notice1,char,1;
        위험고지구분2_투자위험,notice2,notice2,char,1;
        위험고지구분3_단기과열,notice3,notice3,char,1;
    end
    t3320OutBlock1,기업재무정보,output;
    begin
        기업코드,gicode,gicode,char,7;
        결산년월,gsym,gsym,char,6;
        결산구분,gsgb,gsgb,char,1;
        PER,per,per,float,13.2;
        EPS,eps,eps,float,13.0;
        PBR,pbr,pbr,float,13.2;
        ROA,roa,roa,float,13.2;
        ROE,roe,roe,float,13.2;
        EBITDA,ebitda,ebitda,float,13.2;
        EVEBITDA,evebitda,evebitda,float,13.2;
        액면가,par,par,float,13.2;
        SPS,sps,sps,float,13.2;
        CPS,cps,cps,float,13.2;
        BPS,bps,bps,float,13.0;
        T.PER,t_per,t_per,float,13.2;
        T.EPS,t_eps,t_eps,float,13.0;
        PEG,peg,peg,float,13.2;
        T.PEG,t_peg,t_peg,float,13.2;
        최근분기년도,t_gsym,t_gsym,char,6;
    end
    END_DATA_MAP
END_FUNCTION_MAP

따라서, 전체 주식 종목에 대해 다음과 같이 PER, PBR 정보를 가져올 수 있습니다.

SHCodeInfo[] stocks = GetStockList();
foreach (var item in GetStockInfo(stocks))
{
    Console.WriteLine($"{item.Name}: PER == {item.per}, PBR == {item.pbr}");
}

private IEnumerable<StockInfo> GetStockInfo(SHCodeInfo[] stocks)
{
    using (XQt3320 query = new XQt3320())
    {
        foreach (var item in stocks)
        {
            query.SetFieldData(XQt3320InBlock.BlockName, XQt3320InBlock.F.gicode, 0, item.SHCode);
            int resultCode = query.Request();
            if (resultCode < 0)
            {
                Console.WriteLine($"[{resultCode}] XQt3320: request failed at {item.Name}");
                break;
            }

            XQt3320OutBlock1 outBlock = query.GetBlock1();
            if (outBlock.IsValidData == false)
            {
                Console.WriteLine($"XQt3320: invalid block at {item.Name}");
                break;
            }

            yield return new StockInfo(item.Name, outBlock);
        }
    }
}

하지만, 실제로 저렇게 해보면 얼마 동안 정보를 가져오더니 어느 순간부터는 요청이 실패합니다. 이때의 resultCode 값은 -32가 나오는데요, 이것을 XingAPI의 DevCenter 도구에서 "보기" / "에러 찾기" 메뉴로 확인해 보면 다음과 같은 식의 오류 메시지를 볼 수 있습니다.

// Request() == -34인 경우

TR의 10분당 최대 전송 가능 횟수를 초가하였습니다.
이후부터는 전송가능횟수가 5배로 제한됩니다.

이러한 제약은 DevCenter의 "TR 속성" 창을 통해서도 확인할 수 있습니다.

xingapi_tr_time_limit_1.png

이러한 제약은 각각의 API마다 다를 수 있으므로 저렇게 꼭 "TR 속성" 창을 확인해 적절한 시간 지연을 해야 합니다. (아쉽게도 이러한 시간 정보가 RES 파일에는 없어서 이것을 소스 코드 자동화에 반영할 수가 없습니다. 혹시 이 정보를 어떻게 구할 수 있는지 방법을 아시는 분은 덧글 부탁드립니다. ^^)

암튼, 그래서 이런 경우에는 10분당 200건이니까, (10 * 60초 / 200 = ) 3초마다 한 번씩 정보를 요청하는 식으로 바꿔야 합니다. 이를 위해 QueryPerTime 속성을 넣어두었으니, 다음과 같이 설정해 주시면 됩니다.

private IEnumerable<StockInfo> GetStockInfo(SHCodeInfo[] stocks)
{
    using (XQt3320 query = new XQt3320())
    {
        // QueryPerTime에는 밀리 초 단위로 지정
        query.QueryPerTime = 3 * 1000; // 3초마다 한 번씩 전송

        foreach (var item in stocks)
        {
            // ...[생략]...

            yield return new StockInfo(item.Name, outBlock);
        }
    }
}

오늘 날짜 기준으로 XQt8430.Get 메서드가 반환하는 전체 코드는 3,333개, 그중에서 ETF/ETN을 제거하면 2,726개, 다시 그중에서 보통주만을 선별하면 2,370개 정도의 종목이 나옵니다. 정확히 3초씩 가져온다고 가정했을 때 7,110초(약 118분), 전체 가져오는데 약 2시간 정도의 시간이 걸립니다.

어차피, 프로그래밍으로 하는 거니까 DB에만 적절하게 저장해 두도록 그냥 실행해 두고 잊어버리면 되겠습니다. 또한, PER과 PBR 등의 수치들이 주식 가격에 따른 기업 실적의 결과로 산출되는 것이니 매일 장 마감 후 한 번만 하면 될 것입니다.

(첨부 파일은 이 글의 예제 코드를 포함합니다.)
(XingAPI github에도 t3320 프로젝트로 올렸습니다.)



이번 글에서는 기업별로 재무 정보를 가져오기 위해 (시간제한이 걸린) Request를 보내야 하는 불편함이 있었는데요, 다행히 이런 문제점을 해결하는 API가 있습니다. ^^ 그건 다음번 글에서 설명하겠습니다.

참고로, 웹 검색을 해보면 네이버 증권 등에서 웹 페이지로 제공하는 데이터를 HTML 파싱으로 PBR, PER 등의 정보를 가져오는 방법도 볼 수 있습니다. 그런 경우 시간제한이 걸린 증권사의 API 사용보다 빠르게 이용할 수 있지만 HTML 파싱의 특징상 홈페이지 개편이 있을 때마다 틀어질 수 있다는 단점이 있습니다. 다들 장/단점이 있군요. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]

[연관 글]






[최초 등록일: ]
[최종 수정일: 5/8/2022]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
13059정성태5/14/20221150.NET Framework: 2011. C# - CLR ThreadPool의 I/O 스레드에 작업을 맡기는 방법파일 다운로드1
13058정성태5/13/20221011.NET Framework: 2010. C# - ThreadPool.SetMaxThreads 사용법
13057정성태5/12/20221663오류 유형: 812. 파이썬 - ImportError: cannot import name ...
13056정성태5/12/20221205.NET Framework: 2009. C# - async/await 그리고 스레드 (2) MyTask의 호출 흐름 [2]파일 다운로드1
13055정성태5/11/20221520.NET Framework: 2008. C# - async/await 그리고 스레드 (1) MyTask로 재현 [5]파일 다운로드1
13054정성태5/11/20221310.NET Framework: 2007. C# - 10진수 숫자를 담은 문자열을 숫자로 변환하는 방법 [11]파일 다운로드1
13053정성태5/10/2022869.NET Framework: 2006. C# - GC.KeepAlive 메서드의 역할
13052정성태5/9/2022900.NET Framework: 2005. C# - 생성한 참조 개체가 언제 GC의 정리 대상이 될까요?
13051정성태5/8/2022906.NET Framework: 2004. C# XingAPI - ACF 검색 결과로 구한 CSV 파일을 통해 퀀트 종목 찾기파일 다운로드1
13050정성태5/6/2022932.NET Framework: 2003. C# - COM 개체의 이벤트 핸들러에서 발생하는 예외에 대한 CLR의 특별 대우파일 다운로드1
13049정성태5/6/2022764오류 유형: 811. GoLand - Error: Cannot find package
13048정성태5/6/2022874오류 유형: 810. "ASUS TUF GAMING B550M-PLUS (WI-FI)" 모델에서 블루투스 장치가 인식이 안 되는 문제
13047정성태5/6/2022804오류 유형: 809. Speech Recognition could not start
13046정성태5/5/2022975.NET Framework: 2002. C# XingAPI - ACF 파일을 이용한 퀀트 종목 찾기(t1857)
13045정성태5/5/2022875.NET Framework: 2001. C# XingAPI - 주식 종목에 따른 PBR, PER, ROE 구하는 방법(t3341 예제)
13044정성태5/4/2022744오류 유형: 808. error : clang++ exited with code 127
13043정성태5/3/2022786오류 유형: 807. C# - 닷넷 응용 프로그램에서 Informix DB 사용 시 오류 메시지 정리
13042정성태5/3/2022900.NET Framework: 2000. C# - 닷넷 응용 프로그램에서 Informix DB 사용 방법파일 다운로드1
13041정성태4/28/2022826개발 환경 구성: 642. Informix 데이터베이스 docker 환경 구성
13040정성태4/27/2022802VC++: 156. 비주얼 스튜디오 - Linux C/C++ 프로젝트에서 openssl 링크하는 방법
13039정성태4/27/2022997.NET Framework: 1999. C# - Playwright를 이용한 간단한 브라우저 제어 실습
13038정성태4/26/2022874오류 유형: 806. twine 실행 시 ConfigParser.ParsingError: File contains parsing errors: /root/.pypirc
13037정성태4/25/2022946.NET Framework: 1998. Azure Functions를 사용한 간단한 실습
13036정성태4/24/20221252.NET Framework: 1997. C# - nano 시간을 가져오는 방법 [2]
13035정성태4/22/20221213Windows: 204. Windows 10부터 바뀐 QueryPerformanceFrequency, QueryPerformanceCounter
13034정성태4/21/20221020.NET Framework: 1996. C# XingAPI - 주식 종목에 따른 PBR, PER, ROE, ROA 구하는 방법(t3320, t8430 예제)파일 다운로드1
1  2  3  [4]  5  6  7  8  9  10  11  12  13  14  15  ...