證券¶
下單前，請先登入並激活憑證。
激活憑證¶
api.activate_ca(
ca_path=r"D:\TWCA\YOUR_PERSON_ID.pfx",
ca_passwd="YOUR_CA_PASSWORD",
person_id="YOUR_PERSON_ID",
)
簽章憑證 生效日：
20241107104927
簽章憑證 到期日：
20241121235959
激活憑證的寫法見 登入 範例中的 ca_activate。
委託單¶
price (float or int): 價格
quantity (int): 委託數量。整股為張數，零股為股數
action (pk.constant.Action): {Buy: 買, Sell: 賣}
price_type (pk.constant.StockPriceType): {LMT: 限價, MKT: 市價, FLT: 平盤, LMU: 漲停, LMD: 跌停}
order_type (pk.constant.OrderType): {ROD, IOC, FOK}
order_lot (pk.constant.StockOrderLot): {Common: 整股, Fixing: 定盤, Odd: 盤後零股, IntradayOdd: 盤中零股, BlockTrade: 鉅額}
order_cond (pk.constant.StockOrderCond): 預設 Cash（現股）
daytrade_short (bool): 預設 False
account (Account): 下單帳號。未帶入時，證券單使用 api.stock_account
custom_field (str): 備註
price (float or int): 價格
quantity (int): 委託數量
action (Action): {Buy: 買, Sell: 賣}
price_type (StockPriceType): {LMT: 限價, MKT: 市價, MKP: 範圍市價}
order_type (OrderType): 委託類別 {ROD, IOC, FOK}
order_cond (StockOrderCond): {Cash:現股, MarginTrading:融資, ShortSelling:融券}(目前只支持Cash)
order_lot (StockOrderLot): {Common:整股, Fixing:定盤, Odd:盤後零股, IntradayOdd:盤中零股}
daytrade_short (DayTradeShort): 現沖 {Yes, No}
account (:obj:Account): 下單帳號
custom_field (string): 備註
ca (binary): the ca of this order
下單¶
下單時請提供商品檔與委託單。
contract = api.Contracts.Stocks["0056"]
order = api.Order(
quantity=2,
price=36.8,
action=pk.constant.Action.Buy,
price_type=pk.constant.StockPriceType.LMT,
order_type=pk.constant.OrderType.ROD,
order_lot=pk.constant.StockOrderLot.Common,
custom_field="test",
account=api.stock_account,
)
print(order)
trade = api.place_order(contract, order)
print(trade)
print(order)：
action=<Action.Buy: 'Buy'> price=36.8 quantity=2 account=StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID') custom_field='test' price_type=<StockPriceType.LMT: 'LMT'> order_type=<OrderType.ROD: 'ROD'> order_lot=<StockOrderLot.Common: 'Common'>
print(trade)：
contract=Stock(exchange=<Exchange.TSE: 'TSE'>, code='0056', symbol='TSE0056', name='元大高股息', category='0', limit_up=44.44, limit_down=36.36, update_date='20240719') order=Order(action=<Action.Buy: 'Buy'>, price=36.8, quantity=2, account=StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'), custom_field='test', price_type=<StockPriceType.LMT: 'LMT'>, order_type=<OrderType.ROD: 'ROD'>, order_lot=<StockOrderLot.Common: 'Common'>, id='trade_test_01', seqno='_', ordno='_', seq=100200, entid='CA115') status=OrderStatus(id='trade_test_01', status=<Status.Submitted: 'Submitted'>, status_code='00', msg='已處理 YOUR_ACCOUNT_ID 的 0056，價格為 36.8，數量為 2（整張）', order_datetime=datetime.datetime(2024, 11, 14, 3, 40, 47, 885784), order_quantity=2, act=<Act.O: '新單'>)
下單後主控台還會收到委託回報，見 委託回報。
var contract = pocketx.Contracts.Stocks["TSE"]["0050"];
var order = new StockOrder()
{
price = <price>,
quantity = <qty>,
action = Action.Buy,
price_type = StockPriceType.LMT,
order_type = OrderType.ROD,
order_lot = orderLot,
daytrade_short = DayTradeShort.No,
custom_field = "Test",
};
var trade = pocketx.PlaceOrder(contract, order);
{
"contract":{
"security_type":"STK",
"code":"0050",
"symbol":"TSE0050",
"exchange":"TSE",
"limit_up":70.8,
"limit_down":58.0,
"reference":0.0,
"margin_trading_balance":0,
"short_selling_balance":0,
"update_date":"2025/10/31",
"category":"00",
"day_trade":"2",
"name":"元大台灣50",
"target_code":""
},
"order":{
"action":"Buy",
"price":60.0,
"quantity":3,
"price_type":"LMT",
"order_type":"ROD",
"order_lot":"Common",
"order_cond":"Cash",
"daytrade_short":0,
"id":"",
"seqno":"484614",
"ordno":"CL561",
"account":"<your-account_msg>",
"custom_field":"Test",
"ca":"..."
},
"status":{
"id":"",
"status":"Submitted",
"status_code":"00",
"order_datetime":"20251031100509",
"msg":"已處理 9802243 的 0050，價格為 60.0，數量為 3 (整張)",
"modified_ts":0.0,
"modified_price":0.0,
"order_quantity":3000,
"cancel_quantity":0,
"act":0,
"deals":null
}
}
改價¶
零股不得改價。
trade = api.update_order(trade=trade, price=36.9)
print(trade)
contract=Stock(exchange=<Exchange.TSE: 'TSE'>, code='0056', symbol='TSE0056', name='元大高股息', category='0', limit_up=44.44, limit_down=36.36, update_date='20240719') order=Order(action=<Action.Buy: 'Buy'>, price=36.8, quantity=2, account=StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'), custom_field='test', price_type=<StockPriceType.LMT: 'LMT'>, order_type=<OrderType.ROD: 'ROD'>, order_lot=<StockOrderLot.Common: 'Common'>) status=OrderStatus(id='update_test_01', status=<Status.Submitted: 'Submitted'>, status_code='00', msg='已更新 YOUR_ACCOUNT_ID 的 0056，價格為 36.9（整股）', order_datetime=datetime.datetime(2024, 11, 14, 3, 42, 55, 88975), modified_price=36.9, order_quantity=2, act=<Act.R: '改價'>)
var updatedTrade = pocketx.UpdateOrder(trade, price: 51.0, quantity: 0);
{
"contract":{
"security_type":"STK",
"code":"0050",
"symbol":"TSE0050",
"exchange":"TSE",
"limit_up":70.8,
"limit_down":58.0,
"reference":0.0,
"margin_trading_balance":0,
"short_selling_balance":0,
"update_date":"2025/10/31",
"category":"00",
"day_trade":"2",
"name":"元大台灣50",
"target_code":""
},
"order":{
"action":"Buy",
"price":60.0,
"quantity":3,
"price_type":"LMT",
"order_type":"ROD",
"order_lot":"Common",
"order_cond":"Cash",
"daytrade_short":"",
"id":"",
"seqno":"484614",
"ordno":"CL561",
"account":"<your-account-info>",
"custom_field":"Test",
"ca":"..."
},
"status":{
"id":"",
"status":"Submitted",
"status_code":"00",
"order_datetime":"20251031100509",
"msg":"已處理 9802243 的 0050，價格為 60.0，數量為 3 (整張)",
"modified_ts":0.0,
"modified_price":0.0,
"order_quantity":3000,
"cancel_quantity":0,
"act":0,
"deals":null
}
}
改量¶
改量只能減少原委託單的委託數量。
trade = api.update_order(trade=trade, qty=1)
print(trade)
contract=Stock(exchange=<Exchange.TSE: 'TSE'>, code='0056', symbol='TSE0056', name='元大高股息', category='0', limit_up=44.44, limit_down=36.36, update_date='20240719') order=Order(action=<Action.Buy: 'Buy'>, price=36.8, quantity=2, account=StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'), custom_field='test', price_type=<StockPriceType.LMT: 'LMT'>, order_type=<OrderType.ROD: 'ROD'>, order_lot=<StockOrderLot.Common: 'Common'>) status=OrderStatus(id='update_test_01', status=<Status.Submitted: 'Submitted'>, status_code='00', msg='已更新 YOUR_ACCOUNT_ID 的 0056，數量為 1（整股）', order_datetime=datetime.datetime(2024, 11, 14, 3, 51, 6, 821466), order_quantity=2, cancel_quantity=1, act=<Act.M: '改量'>)
var updatedTrade2 = pocketx.UpdateOrder(trade, price: 0, quantity: 2);
刪單¶
trade = api.cancel_order(trade=trade)
print(trade)
contract=Stock(exchange=<Exchange.TSE: 'TSE'>, code='0056', symbol='TSE0056', name='元大高股息', category='0', limit_up=44.44, limit_down=36.36, update_date='20240719') order=Order(action=<Action.Buy: 'Buy'>, price=36.8, quantity=2, account=StockAccount(person_id='YOUR_PERSON_ID', broker_id='6620', account_id='YOUR_ACCOUNT_ID', signed=True, username='USERNAME', nanoid='YOUR_NANOID'), custom_field='test', price_type=<StockPriceType.LMT: 'LMT'>, order_type=<OrderType.ROD: 'ROD'>, order_lot=<StockOrderLot.Common: 'Common'>) status=OrderStatus(id='update_test_01', status=<Status.Cancelled: 'Cancelled'>, status_code='00', msg='已取消 YOUR_ACCOUNT_ID 的 0056，數量為 0（整股）', order_datetime=datetime.datetime(2024, 11, 14, 3, 53, 46, 212219), order_quantity=2, cancel_quantity=1, act=<Act.C: '刪單'>)
var updatedTrade2 = pocketx.UpdateOrder(trade, price: 0, quantity: 2);