Python交易API使用手冊

API驗證流程

關聯網站

• 下載元富E管家

• 數位API認證

1. 系統需求

• Python 3.6以上版本

• 交易python package

2. 環境準備

32位元(x86):pip install MasterTradePy-X.X.X-py3-none-win32.whl

64位元(x64):pip install MasterTradePy-X.X.X-py3-none-win_amd64.whl

※X.X.X為版號，請依據下載內容版號調整

3. 執行Sample

參數說明：

                
					python sample.py {使用者名稱} {密碼} {是否連測試(True/False)} {是否單一帳號通過強制登入(True/False)} {是否連接競賽主機(True/False)}
                
              

根據取得結果在線上驗證回填結果,驗證成功後才可以開始使用

4. 回報狀態事件

4.1 OnReport

                
				def OnReport(self, data) -> None:
				     if type(data) is ReportOrder:
					     # 回報資料
						 print(data.order.tableName)
					 if data.order.tableName == "ORD:TwsOrd":
					     print(f'回報資料: 委託書號={data.order.ordNo}, 股票代號={data.order.symbol}, 委託股數={data.orgOrder.qty}, 成交股數={data.order.cumQty}, 訊息={data.lastMessage}, 狀態={data.order.status}')
					 elif data.order.tableName == "RPT:TwsDeal":
					     print(f'回報資料: 委託書號={data.order.ordNo}, 股票代號={data.order.symbol}, 成交價格={data.order.dealPri}, 成交股數={data.order.cumQty}, 剩餘股數={data.order.leavesQty} 訊息={data.lastMessage}, 狀態={data.order.status}')
					 elif data.order.tableName == "RPT:TwsNew":
					     print(f'回報資料: 委託書號={data.order.ordNo}, 股票代號={data.order.symbol}, 委託價格={data.orgOrder.price}, 委託股數={data.orgOrder.qty}, 訊息={data.lastMessage}, 狀態={data.order.status}')
					 else:
					     print(f'回報資料: 委託書號={data.order.ordNo}, 股票代號={data.order.symbol}, 委託價格={data.orgOrder.price}, 委託股數={data.orgOrder.qty}, 成交股數={data.order.cumQty}, 訊息={data.lastMessage}, 狀態={data.order.status}')
				
              

Output:

下單:

RPT:TwsNew

回報資料: 委託書號=Y0003, 股票代號=2330, 委託價格=533, 委託股數=2000, 訊息=新單 2000 股OK!, 狀態=101

RPT:TwsDeal

回報資料: 委託書號=Y0003, 股票代號=2330, 成交價格=532, 成交股數=2000, 剩餘股數=0 訊息=, 狀態=111

改量:

RPT:TwsChg

回報資料: 委託書號=Y0004, 股票代號=2330, 委託價格=None, 委託股數=None, 成交股數=None, 訊息=減 1000 成功,剩餘 4000 股., 狀態=101

改價:

RPT:TwsChg

回報資料: 委託書號=Y0004, 股票代號=2330, 委託價格=None, 委託股數=None, 成交股數=None, 訊息=改價 L$515 成功, 狀態=101

Order物件

委託狀態

4.2 OnReqResult

                
				def OnReqResult(self, workID: str, data) -> None:
				    if type(data) is Basic:
					   # 基本資料
					   print(f'workid={workID}, 證券基本資料: 股票代號={data.symbol}, 參考價={data.refPrice}, 漲停價={data.riseStopPrice}, 跌停價={data.fallStopPrice}')
					if type(data) is Inventory:
					   # 庫存資料
					   print(f'workid={workID}, 庫存資料={data}')
				
              

Basic 物件

Inventory 物件

4.3 OnSystemEvent

                
				def OnSystemEvent(self, data: SystemEvent) -> None:
				      print(f'OnSystemEvent{data}')
				
              

4.4 OnError

                
				 def OnError(self, data):
				      print(data)
				
              

1. 登入Login

                
					rc = api.Login(username, password, is_sim, is_force, is_event)
                
              

2. 下單

                
                  order = Order(tradingSession=TradingSession.NORMAL, 
                        side=Side.Buy, //買賣別
                        symbol=symbol, //股票代碼
                        priceType=priceType, //價格類別(L:限價, M:市價)
                        price=price, //委託價格
                        tradingUnit=TradingUnit.COMMON, 
                        qty=qty, //委託股數
                        orderType=OrderType.ROD, //委託方式(ROD, IOC, FOK)
                        tradingAccount=account, //交易帳號
                        userDef='') //客戶自訂內容
                  rcode = api.NewOrder(order)	
                
              

3. 改量

                
                 replaceOrder = OrderQtyChange(ordNo=ordNo, qty = qty, tradingAccount=account)
                 //代入委託書號、改量股數、交易帳號
                 rcode = api.ChangeOrderQty(replaceOrder)
                
              

4. 改價

                
                 replaceOrder = OrderPriceChange(ordNo=ordNo, price = price, tradingAccount=account)
				 //代入委託書號、改價價格、交易帳號
				 rcode = api.ChangeOrderPrice(replaceOrder)
                
              

5. 查詢委託回報

				
				api.QryRepAll(account)
				
			

6. 查詢成交回報

					
					api.QryRepDeal(account)
					
				

7. 查詢期初庫存

					
					api.ReqInventoryOpen(account)
					
				

8. 查詢庫存

									
									api.ReqInventoryRayinTotal(account)
									
								

9. 查詢或有券源

					
					api.QrySecInvQty_Rayin(account, symbol)
					
				

查詢資券配額

					
					api.QryProdCrQty_Rayin(account, symbol)