Kiwoom Openapi W Devguide Ver 1.0

You might also like

Download as pdf or txt
Download as pdf or txt
You are on page 1of 28

OpenAPI-W

1
1.
1.1
1.2

2.
2.1
2.2
3. WKOA Studio
3.1 WKOA Studio
3.2 WKOA Studio
3.3 WKOA Studio

4.
4.1
4.2
4.3

5. Open API-W
5.1 Open API-W
5.2 Open API-W
5.3 Open API-W
5.4 Open API-W

6.
6.1 (Method)
6.2 (Event)

7.

8. FID
8.1
8.2
8.3
8.4
8.5

9.
9.1
9.2

2
1.

1.1


>>Open API> Open API>
> Open API

. Open API-W
OCX , OCX
. ( .)

Open API-W OCX



.

1.2
- Open API OCX .
- VB, , , MFC .
- TR OCX API
.

2.

2.1
Open API .()
, .
- CommConnect(long iAutoUpgrade) ,
(0) (1)
- , ( 1->2->3->4->5)
WKOA > ID/PW/PW , >
>
WKOA API >

- , ( 1->4->5)
WKOA > ID/PW/PW , >
WKOA >

3
WKOA > ID/PW/PW
- (Open API OCX )
, .
- .
- ( )
<1> : O, : O

<2> : O, : X

4
<3> : O, : X

<4>
( .) ()

<5> : O, : O ( / .)

5
2.2
- , ID
PW .

3. WKOA Studio

3.1 WKOA Studio


WKOA Studio TR
, .

-
- WKOA Studio
- TR Input
- FID
- TR
-

3.2 WKOA Studio



>> Open API-W> Open API-W>
> Open API-W

6

- WKOA Studio >(F)>Open API , .
- WKOA Studio .( )

3.2 WKOA Studio


/// .


- TR
-TR Input

-W -

- TR -

-TR IO
- FID - TR Input
- Input


-TR
-
- TR
-

7
TR
- TR TR (C++ ) .

- INPUT .

8
- TR .

- .

9
- TR .

- VC++, C#, VB .

10
- .

4.

4.1
- : [SYSTEM DRIVE:]/Program Root/


DLL KFOpenAPI.ocx OpenAPI
KFOpManager.dll OpenAPI
KFOpCommApi.dll
KFOpComms.exe TCP/IP

4.2
- : [SYSTEM DRIVE:]/Program Root/Data


KFOpTrInfo.dat

4.3

11
- : [SYSTEM DRIVE:]/Program Root/System


KFOpComms.ini

5. Open API-W

5.1 Open API-W


- Open API-W ActiveX Control (OCX) OLE
.
OCX .


KFOpenAPI.OCX
OCX OLE Control Extension DLL
Microsoft Windows XP SP3
Microsoft Visual C++ 2010
1.0.0.0

5.2 Open API-W


- Open API-W (Interface ID : GUID)
(Unique) , .
- Open API-W
.

Control D1ACAB7D-A3AF-49E4-9004-C9E98344E17A
Dispatch 85B07632-4F84-4CEF-991D-C79DE781363D /
Even 952B31F8-06FD-4D5A-A021-5FF57F5030AE
Module 1F8A15ED-A979-488F-9694-1EDA98188FFC

5.3 Open API-W


- Open API-W (Interface Method)
.
ID
1 LONG CommConnect .
2 LONG CommRqData .
3 void SetInputValue .
4 BSTR GetCommData .

12
5 void CommTerminate .
6 LONG GetRepeatCnt
.
7 void DisconnectRealData .
8 BSTR GetCommRealData .
9 BSTR GetChejanData .
10 LONG SendOrder Tran .
11 BSTR GetLoginInfo .
12 BSTR GetGlobalFutureItemlist .
13 BSTR GetGlobalOptionItemlist .
14 BSTR GetGlobalFutureCodelist .
15 BSTR GetGlobalOptionCodelist .
16 LONG GetConnectState .
17 BSTR GetAPIModulePath OpenAPI
.
18 BSTR GetCommonFunc
.
19 BSTR GetConvertPrice
.
20 BSTR GetGlobalFutCodeInfoByType
(/) .
21 BSTR GetGlobalFutCodeInfoByCode
.
22 BSTR GetGlobalFutureItemlistByType
(/) .
23 BSTR GetGlobalFutureCodeByItemMonth /
.
24 BSTR GetGlobalOptionCodeByMonth ///
.
25 BSTR GetGlobalOptionMonthByItem
.
26 BSTR GetGlobalOptionActPriceByItem
.
27 BSTR GetGlobalFutureItemTypelist .
28 BSTR GetCommFullData .

5.4 Open API-W


- Open API-W .

13
ID
1 void OnReceiveTrData Tran
2 void OnReceiveMsg
3 void OnReceiveRealData
4 void OnReceiveChejanData /
5 void OnEventConnect

6.

- Open API-W ActiveX ((property) (method)


. .
- ID .

6.1 (Method)
1) CommConnect
LONG CommConnect(LONG nAutoUpgrade)
.
0 , 1
* OCX ,
, (ocx) Close
, (ocx) Close
.
0 - ,
OnEventConnect
.
(ocx) ,
, (ocx)
.

2) CommRqData
LONG CommRqData (BSTR sRQName, BSTR sTrCode, BSTR sPrevNext, BSTR
sScreenNo )
Tran .
BSTR sRQName
BSTR sTrCode
long nPrevNext
BSTR sScreenNo
OP_ERR_SISE_OVERFLOW

14
OP_ERR_RQ_STRUCT_FAIL
OP_ERR_RQ_STRING_FAIL
OP_ERR_NONE
sRQName
sTrCode - Tran
nPrevNext Next ()
sScreenNo - 4 (1~9999 : )
Ex) openApi.CommRqData( RQ_1, OPT00001, , 0101);

3) SetInputValue
void SetInputValue(BSTR sID, BSTR sValue)
Tran .
sID
sValue

Tran
Ex) openApi.SetInputValue(, 6AH16);
openApi.SetInputValue(, 5015123401);

4) GetCommData
BSTR GetCommData(BSTR strTrCode, BSTR strRecordName, long nIndex, BSTR
strItemName)
.
strTrCode Tran
strRecordName
nIndex
strItemName

Ex) - openApi.GetCommData(OPT00001, , 0,
);

5) CommTerminate
void CommTerminate()
OpenAPI .


GetConnectState .

15
6) GetRepeatCnt
LONG GetRepeatCnt(BSTR sTrCode, BSTR sRecordName)
.
sTrCode Tran
sRecordName

Ex) openApi.GetRepeatCnt(OPT00001, );

7) DisconnectRealData
void DisconnectRealData(BSTR sScnNo)
.
sScnNo [4]

.
Ex) openApi.DisconnectRealData(0101);

8) GetCommRealData
BSTR GetCommRealData(BSTR strRealType, long nFid)
.
strRealType
nFid

Ex) - openApi.GetCommRealData(, 10);

9) GetChejanData
BSTR GetChjanData(long nFid)
.
nFid

Ex) openApi.GetChejanData(910); //

10) SendOrder
LONG SendOrder( BSTR sRQName,
BSTR sScreenNo,
BSTR sAccNo,
LONG nOrderType,
BSTR sCode,
LONG nQty,

16
BSTR sPrice,
BSTR sStop,
BSTR sHogaGb,
BSTR sOrgOrderNo
)
.
sRQName -
sScreenNo - [4] (1~9999 : )
sAccNo - [10]
nOrderType - (1:, 2:, 3:, 4:,
5:, 6:)
sCode -
nQty
sPrice
sStop - Stop
sHogaGb -
sOrgOrderNo
<7. >
sHogaGb 1:, 2:, 3:STOP, 4:STOP LIMIT
ex)
- openApi.SendOrder(RQ_1, 0101, 5015123410, 2, 6AH16, 10,
0.7900, 2, );
- openApi.SendOrder(RQ_1, 0101, 5015123410, 2, 6AH16, 10,
0, 1, );
- openApi.SendOrder(RQ_1,0101, 5015123410, 6, 6AH16, 10,
0.7800, 0, 200060);
- openApi.SendOrder(RQ_1, 0101, 5015123410, 4, 6AH16, 10,
0, 0, 200061);

11) GetLoginInfo
BSTR GetLoginInfo(BSTR sTag)
.
BSTR sTag : TAG ()
TAG
BSTR sTag
ACCOUNT_CNT .
"ACCNO" . ;.
USER_ID - ID .

17
USER_NAME .
KEY_BSECGB . 0:, 1:
FIREW_SECGB . 0:, 1:, 2:
Ex) openApi.GetLoginInfo(ACCOUNT_CNT);

12) GetGlobalFutureItemlist
BSTR GetGlobalFutureItemlist()
.

, ;.
(6A, 6B, 6C, ES..)

13) GetGlobalOptionItemlist
BSTR GetGlobalOptionItemlist ()
.

, ;.
(6A, 6B, 6C, ES..)

14) GetGlobalFutureCodelist
BSTR GetGlobalFutureCodelist (BSTR sItem)
.

, ;.

15) GetGlobalOptionCodelist
BSTR GetGlobalOptionCodelist (BSTR sItem)
.

, ;.

16) GetConnectState
LONG GetConnectState ()
.

18
0:, 1:

17) GetAPIModulePath.
BSTR GetAPIModulePath ()
OpenAPI .


18) GetCommonFunc
BSTR GetCommonFunc (BSTR sFuncName, BSTR sParam)
.
,
.

19) GetConvertPrice
BSTR GetConvertPrice (BSTR sCode, BSTR sPrice, LONG nType)
.
, , (0 : ->10, 1 : 10->)
.

20) GetGlobalFutOpCodeInfoByType
BSTR GetGlobalFutCodeInfoByType(LONG nGubun, BSTR sType)
.
nGubun : 0(), 1()
sType : IDX(), CUR(), INT(), MLT(), ENG(), CMD()
.( )
.

21) GetGlobalFutOpCodeInfoByCode
BSTR GetGlobalFutCodeInfoByCode(BSTR sCode)
.
sCode :
.( )

19
22) GetGlobalFutureItemlistByType
BSTR GetGlobalFutureItemlistByType (BSTR sType)
.
sType : IDX(), CUR(), INT(), MLT(), ENG(), CMD()
.

23) GetGlobalFutureCodeByItemMonth
BSTR GetGlobalFutureCodeByItemMonth (BSTR sItem, BSTR sMonth)
/ .
sItem: (6A, ES..), sMonth: 201606
.

24) GetGlobalOptionCodeByMonth
BSTR GetGlobalOptionCodeByMonth (BSTR sItem, BSTR sCPGubun, BSTR
sActPrice, BSTR sMonth)
/// .
sItem: (6A, ES..), sCPGubun: C()/P(), sActPrice: 0.760,
sMonth: 201606
.

25) GetGlobalOptionMonthByItem
BSTR GetGlobalOptionMonthByItem (BSTR sItem)
.
sItem: (6A, ES..)
.

26) GetGlobalOptionActPriceByItem
BSTR GetGlobalOptionActPriceByItem (BSTR sItem)
.
sItem: (6A, ES..)
.

27) GetGlobalFutureItemTypelist

20
BSTR GetGlobalFutureItemTypelist ()
.

.
IDX;CUR;INT;MLT;ENG;CMD;

28) GetCommFullData
BSTR GetCommFullData (BSTR strTrCode, BSTR strRecordName, LONG nGubun )
.
strTrCode Tran
strRecordName
nGubun 0 : (+), 1 : , 2 :
.
WKOAStudio TR .( )
/ ,
.

6.2 (Event)
1) OnReceiveTrData.
void OnReceiveTrData(BSTR sScrNo, BSTR sRQName, BSTR sTrCode, BSTR
sRecordName, BSTR sPreNext)
.
sScrNo
sRQName
sTrCode Tran
sRecordName Record
sPreNext

sRQName CommRqData sRQName .
sTrCode CommRqData sTrCode .

2) OnReceiveRealData
void OnReceiveRealData(BSTR sJongmokCode, BSTR sRealType, BSTR sRealData)
.
sJongmokCode
sRealType
sRealData
21


3) OnReceiveMsg
void OnReceiveMsg(BSTR sScrNo BSTR sRQName, BSTR sTrCode, BSTR sMsg)
.
sScrNo
sRQName
sTrCode Tran
sMsg

sScrNo CommRqData sScrNo .
sRQName CommRqData sRQName .
sTrCode CommRqData sTrCode .

4) OnReceiveChejanData
void OnReceiveChejanData(BSTR sGubun, LONG nItemCnt, BSTR sFidList)
.
sGubun
nItemCnt -
sFidList sSplmMsg - 1.0.0.1 .

sGubun 0:, 1:, 3:
sFidList ; .

5) OnEventConnect
void OnEventConnect(LONG nErrCode)

LONG nErrCode :

nErrCode 0 ,

7.

OP_ERR_NONE 0 ""
OP_ERR_NO_LOGIN -1 ""
OP_ERR_LOGIN -100 (

22
OP_ERR_CONNECT -101 " "
OP_ERR_VERSION -102 " .
OP_ERR_TRCODE -103 "TrCode .
OP_ERR_NO_REGOPENAPI -104 OpenAPI
OP_ERR_SISE_OVERFLOW -200
OP_ERR_ORDER_OVERFLOW -201
OP_ERR_RQ_WRONG_INPUT -202 (/)
OP_ERR_ORD_WRONG_INPUT -300
OP_ERR_ORD_WRONG_ACCPWD -301 .
OP_ERR_ORD_WRONG_ACCNO -302 .
OP_ERR_ORD_WRONG_QTY200 -303 - 200
OP_ERR_ORD_WRONG_QTY400 -304 - 400 .

8. FID

8.1
FID
20
10 ()
140
11
12
27
28
15
13
16
17
18
25
26
30
22
761

8.2

23
FID
21
27
28
41 1
61 1
81 1
101 1
51 1
71 1
91 1
111 1
42 2
62 2
82 2
102 2
52 2
72 2
92 2
112 2
43 3
63 3
83 3
103 3
53 3
73 3
93 3
113 3
44 4
64 4
84 4
104 4
54 4
74 4
94 4
114 4
45 5

24
65 5
85 5
105 5
55 5
75 5
95 5
115 5
121
122
123
125
126
127
137
128
600 1
601 2
602 3
603 4
604 5
610 1
611 2
612 3
613 4
614 5

8.3
FID
9201 (/r)
9203 ( /t)
9001
907
905
904
302
906
900

25
901
13333
13330
13332
902
913
919
8046
947 FCM
8043
908

8.4
FID
9201 (/r)
9203 ( /t)
9001
907
905
8046
947 FCM
904
302
906
900
901
13330
13333
13332
909
911
910
13331
13329
13326
913
902

26
935
13327
13328
8018
8043
8009
930
13334 ()
908

8.5
FID
9201 (/r)
8054 (1:1 , 2:2) ( \t)
8055 YYYYMMDDHHMMSSMS
8053
8043

9.

9.1

stk_code 12
arti_code 6 (6A, ES, .)
arti_hnm 40
arti_tp 3 (IDX, CUR, .)
crnc_code 3 (USD, JPY, )
tick_unit 15 TICK
tick_value 15 TICK
deal_unit 15
deal_mtal 15
1~9, A~Z ,
ntt_code 1
.
ntt_calc_unit 15
frgn_exch_code 10
expr_dt 8
fprc 10

27
gubun 1
atv_code 1
9.2

stk_code 12
arti_code 6 (6A, ES, .)
arti_hnm 40
arti_tp 3 (IDX, CUR, .)
crnc_code 3 (USD, JPY, )
tick_unit 15 TICK
tick_value 15 TICK
deal_unit 15
deal_mtal 15
1~9, A~Z ,
ntt_code 1
.
ntt_calc_unit 15
frgn_exch_code 10
expr_dt 8
underlying_code 12
atmg 1 ATM
hsga 13
cpgubn 1
fprc 10 frpc
tick_calc_unnm 15 tick check price
over_tick_unmn 15 over tick price
vtt_code 4 vtt code
yymm 5 yymmd
op_type 1 type('A','E')

28

You might also like