服務條款

受限於台灣金融法規，新用戶首次使用需簽署相關文件並在測試模式完成測試報告才能進行正式環境的使用。

簽署文件

  請參見簽署中心並在簽署前仔細閱讀文件。

相關測試

  確保您完全理解如何使用，需在測試模式完成測試報告，內容包含以下功能:

• 登入測試

登入

import shioaji as sj
api = sj.Shioaji(simulation=True)
api.login(
    person_id="PERSON_ID", #個人專屬帳號 
    passwd="PASSWORD", 
)

• 下單測試 (版本>= 0.3.6.dev7)

  下現貨的單為對現貨帳號進行測試報告，期貨亦然。

現貨下單

# contract - edit it
contract = api.Contracts.Stocks.TSE["2890"]

# order - edit it
order = api.Order(
    action=sj.constant.Action.Buy,
    price=20, 
    quantity=1, 
    price_type=sj.constant.StockPriceType.LMT,
    order_type=sj.constant.TFTOrderType.ROD,
    account=api.stock_account
)

# place order
trade = api.place_order(contract, order, timeout=0)

期貨下單

# near-month TXF - edit it
contract = min(
    [
        x for x in api.Contracts.Futures.TXF 
        if x.code[-2:] not in ["R1", "R2"]
    ],
    key=lambda x: x.delivery_date
)

# order - edit it
order = api.Order(
    action=sj.constant.Action.Buy,
    price=15000, 
    quantity=1, 
    price_type=sj.constant.StockPriceType.LMT,
    order_type=sj.constant.FuturesOrderType.ROD,  
    octype=sj.constant.FuturesOCType.Auto,
    account=api.futopt_account
)

# place order
trade = api.place_order(contract, order, timeout=0)

Attention

因應公司資訊安全規定，測試報告服務為星期一至五 08:00 ~ 20:00

• 18:00 ~ 20:00: 只允許台灣IP
• 08:00 ~ 18:00: 沒有限制

憑證

  下單前必須申請並啟用憑證

申請憑證

1. 至理財網下載 eleader
   

2. 登入 eleader
   

3. 從上方帳戶資料選取(3303)帳號資料設定
   

4. 點選"步驟說明"
   

5. 憑證操作步驟說明
   

啟用憑證

• 若是使用測試帳號無需啟用憑證
• 如果您使用macOS，可能會遇到版本上的問題。我們建議您使用 docker 去運行shioaji。

In

result = api.activate_ca(
    ca_path="/c/your/ca/path/Sinopac.pfx",
    ca_passwd="YOUR_CA_PASSWORD",
    person_id="Person of this Ca",
)

print(result)
# True

憑證路徑

在 Windows 系統中，如果文件路徑使用 \ 來分隔文件，您需要將它替換為 /。