Shioaji Python交易API：永豐金證券台灣股票期貨選擇權自動化下單與行情串流 | SkillsMD⚠️重要前提
安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →
Shioaji Python交易API：永豐金證券台灣股票期貨選擇權自動化下單與行情串流
shioaji by sinotrade/shioaji
npx skills add https://github.com/sinotrade/shioaji --skill shioaji广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
路由指引
根據使用者意圖決定載入哪個參考檔案，大部分情境只需載入 1-2 個檔案。
快速入門
安裝
# pip
pip install shioaji
# uv (推薦)
uv add shioaji
# with speed optimization
uv add shioaji --extra speed
# Docker
docker run -it sinotrade/shioaji:latest
登入與憑證啟用
import shioaji as sj
api = sj.Shioaji()
# 使用 API Key 登入
accounts = api.login(
api_key="YOUR_API_KEY",
secret_key="YOUR_SECRET_KEY"
)
# 啟用憑證 (下單必須)
api.activate_ca(
ca_path="/path/to/Sinopac.pfx",
ca_passwd="YOUR_CA_PASSWORD",
)
模擬模式
import shioaji as sj
api = sj.Shioaji(simulation=True)
api.login(api_key="YOUR_KEY", secret_key="YOUR_SECRET")
- 報價：訂閱、取消訂閱、逐筆成交、K線、快照
- 委託：下單、改單、刪單、更新狀態、列出成交
- 帳務：列出持倉、列出損益
- 資料：券源查詢、資券查詢、掃描器
簡單下單範例
# 取得合約
contract = api.Contracts.Stocks["2330"] # 台積電
# 建立訂單
order = api.Order(
price=580,
quantity=1,
action=sj.constant.Action.Buy,
price_type=sj.constant.StockPriceType.LMT,
order_type=sj.constant.OrderType.ROD,
account=api.stock_account,
)
# 下單
trade = api.place_order(contract, order)
常用常數
買賣方向
sj.constant.Action.Buy # 買進
sj.constant.Action.Sell # 賣出
股票價格類型
sj.constant.StockPriceType.LMT # 限價
sj.constant.StockPriceType.MKT # 市價
sj.constant.StockPriceType.MKP # 範圍市價
期貨價格類型
sj.constant.FuturesPriceType.LMT # 限價
sj.constant.FuturesPriceType.MKT # 市價
sj.constant.FuturesPriceType.MKP # 範圍市價
委託條件
sj.constant.OrderType.ROD # 當日有效
sj.constant.OrderType.IOC # 立即成交否則取消
sj.constant.OrderType.FOK # 全部成交否則取消
股票交易單位
sj.constant.StockOrderLot.Common # 整股 (1000 shares)
sj.constant.StockOrderLot.Odd # 盤後零股
sj.constant.StockOrderLot.IntradayOdd # 盤中零股
sj.constant.StockOrderLot.Fixing # 定盤
信用交易條件
sj.constant.StockOrderCond.Cash # 現股
sj.constant.StockOrderCond.MarginTrading # 融資
sj.constant.StockOrderCond.ShortSelling # 融券
報價類型
sj.constant.QuoteType.Tick # 逐筆成交
sj.constant.QuoteType.BidAsk # 五檔報價
帳戶物件
# 股票帳戶
api.stock_account
# 期貨帳戶
api.futopt_account
# 列出所有帳戶
api.list_accounts()
流量限制
| 類別 | 限制 |
|---|
| 每日流量 | 500MB - 10GB (依交易量) |
| 行情查詢 | 50 requests / 5 sec |
| 帳務查詢 | 25 requests / 5 sec |
| 連線數 | 5 per person ID |
| 每日登入 | 1000 times |
常用模式
訂閱行情
# 訂閱逐筆成交
api.quote.subscribe(
api.Contracts.Stocks["2330"],
quote_type=sj.constant.QuoteType.Tick
)
# 訂閱五檔
api.quote.subscribe(
api.Contracts.Stocks["2330"],
quote_type=sj.constant.QuoteType.BidAsk
)
# 設定回調
@api.quote.on_quote
def quote_callback(topic, quote):
print(f"Topic: {topic}, Quote: {quote}")
查詢持倉
# 股票持倉
positions = api.list_positions(api.stock_account)
# 期貨持倉
positions = api.list_positions(api.futopt_account)
刪單
改單
# 改價
api.update_order(trade=trade, price=590)
# 減量 (只能減少)
api.update_order(trade=trade, qty=1)
錯誤處理
try:
trade = api.place_order(contract, order)
except Exception as e:
print(f"Order failed: {e}")
# 檢查訂單狀態
api.update_status(api.stock_account)
for trade in api.list_trades():
print(trade.status)
登出
飞书视频会议CLI工具：lark-vc技能详解，高效搜索与管理会议记录与纪要
47,500 周安装
