Eason's 記事本

>Python UV 管理器：從安裝到使用

2025-05-12T10:38:00.023+08:00

Python UV 管理器：從安裝到使用

UV 是一款強大的 Python 包管理工具，能夠替代 pip、pip-tools、pipx、poetry、pyenv、twine、virtualenv 等工具，提供高效的 Python 版本管理、依賴管理及虛擬環境管理，這裡簡單描述以利日後查找。

1. UV 的特點

一體化工具鏈：安裝 UV 即可取代多個獨立工具，減少版本衝突與配置負擔。
極致性能：基於 Rust 開發，安裝與解析速度遠超傳統 pip。
一致性與可重複性：透過 uv.lock 文件，確保不同環境的依賴一致性。
輕量虛擬環境管理：內建 venv 功能，無需依賴外部工具。
完善的 Python 版本管理：類似 pyenv，但更適合項目隔離，不影響系統環境。

2. UV 的安裝

UV 提供多種安裝方式，適用於不同平台：

方式 1：使用官方安裝腳本

適用於 Linux 和 macOS：

curl -LsSf https://astral.sh/uv/install.sh | sh

適用於 Windows：


powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方式 2：使用 pip 安裝

如果已安裝 Python，則可使用 pip 安裝：

pip install uv

方式 3：其他安裝方式

UV 也支持 Homebrew、WinGet、Scoop、Docker 或 GitHub Releases 安裝。例如：

brew install uv

3. UV 的基本使用

安裝完成後，可以使用 UV 來管理 Python 項目：

初始化新項目

uv init myproject
cd myproject

UV 會自動建立 .gitignore、.python-version、pyproject.toml 等文件，並初始化 Git 倉庫。

添加package

uv add numpy

這將自動：

創建虛擬環境並安裝 numpy
將 numpy 添加至 pyproject.toml
生成 uv.lock 文件，確保依賴一致性

運行 Python 腳本

uv run python script.py

或指定 Python 版本：

uv run --python 3.11 script.py

同步依賴

uv sync

這將確保所有依賴與 uv.lock 文件保持一致。

4. 參考文獻

用 pythonnet 重塑群益 SKOrderLib，提升功能完整性

2025-04-16T23:47:00.010+08:00

以前都使用 comtypes 來包裹群益 SKCOM API。然而，幾次API更新後，在處理 SKOrderLib 時，發現愈來愈多使用 comtypes 包裝後功能不完善，一些事件無法正常運作。因此，我嘗試使用 pythonnet 來包裝 SKCOM API (請參考這篇)，結果 SKOrderLib 的功能得以順利運作。以下是我比較 comtypes 和 pythonnet，最佳化 SKOrderLib 的實際經驗，用jupyter notebook來運行可以得到最好效果。

comtypes 範例

很多功能呼叫後都沒有回應，向是 GetRealBalaceReport, GetMarginPurchaseAmountLimit 等，重複呼叫 GetRealBalaceReport，甚至只會顯示 SK_ERROR_QUERY_IN_PROCESSING, 不論是間隔多久，都不會再回傳正確資料。

pythonnet範例

範例期貨權益

2024-09-13T17:52:00.006+08:00

取得期貨權益並存入excel中

使用 jupyterlab 範例，

使用 python script 範例

修改 jupyterlab notebooks 起始位置

2023-03-23T11:40:00.004+08:00

久久用一次，但常忘記，所以紀錄一下

打開 cmd prompt，並執行 jupyter notebook --generate-config
會產生一個 jupyter_notebook_config.py 檔案。也會告知你存放的路徑，類似 D:\python\WPy64-31090\python-3.10.9.amd64\etc\jupyter\jupyter_notebook_config.py
用文字編輯器開啟它
尋找檔案內這行 #c.NotebookApp.notebook_dir = ''
移除井字號, 將單引號內輸入你想要的目錄位置，
例如: c.NotebookApp.notebook_dir = "D:/python/notebooks/"
重新啟動 jupyter lab 後，起始位置就會改成您指定的目錄

參考:

https://shanyitan.medium.com/how-to-change-the-working-directory-of-jupyter-and-jupyter-lab-on-windows-environment-bbe5a5a99f05

使用 pythonnet 呼叫群益api

2023-02-20T16:46:00.011+08:00

多年前曾用想要用pythonnet，來載入群益的api ，但最後失敗了。這篇純粹是出自個人好奇，還是想了解是否能用 pythonnet 來載入 dll，最近找到可以使用的步驟了，在windows下 python 可以呼叫群益api，讓熟悉 C# 的開發者，又想用 python 的人多一種選擇。

目前使用這個方法的好處:

在 juypterlab 下，可以顯示各個 function 參數有哪些，減少一直翻手冊的時間。
callback 部屬比較直覺快速，但也因此比較冗長。
熟悉 C# 的人，可以加入 C# 相關的 reference, namespace 當作 python 的模組來使用。
其他券商的 dll 檔，也有機會用這套方法來呼叫?

壞處:

目前遇到狀況是 callback 出現錯誤時，python沒有任何錯誤通知，除錯比較麻煩。

我的安裝環境:

windows 10,
我使用的是python 3.10.5
visual studio 2022 (只是為了使用它的 tlbimp.exe)

前置工作

1. 用 tlbimp.exe 將 SKCOM.dll 轉成 Type library

要先將群益的SKCOM.dll 轉成 Type library，我有安裝 visual studio 2022，利用它附帶的 comandline prompt terminal ，下指令 tlbimp.exe 將 SKCOM.dll 轉成 typelib 形式，最終產生 SKCOMLib.dll 的檔案。之後就可以輕鬆用 pythonnet 的 clr 模組取用。

2. 安裝 pythonnet

Python.NET 模組可以讓 python 使用者無縫整合 .NET Common Language Runtime (CLR)。它讓 Python 可以跟 CLR 互動, 甚至也可以反過來將 Python 包進 .NET 裡.

在你的 python 環境下用 pip 安裝 pythonnet 即可。詳細操作請看 pythonnet 官網

pip install pythonnet

使用 pythonnet 的 clr 模組呼叫 SKCOMAPI

Jupyter Notebook範例

範例.py

群益海期 tick 報價範例

2022-11-14T17:44:00.005+08:00

群益海期 ticks 報價範例，本範例直接在 OnNotifyTicksNineDigitLONG, OnNotifyHistoryTicksNineDigitLONG 裡做一些資料處理，當海期報價資料量很大的時候，處理速度變很慢，kline 轉換也有點慢，日後都還需要改進，朋友呀，如果有什麼更快的方法請教教我。

Notebook 範例版 jupyter notebook

範例.py

群益 skcom api 海期報價、下單及回報範例

2022-05-09T17:05:00.008+08:00

群益海期報價跟下單跟api手冊上寫的有點出入，手冊也沒有明確表示下單的流程，經過一番試誤，可以報價也可以下單了。實在是太少碰海期相關的 api，每次想用的時候都重新經歷一次錯誤，因此寫下來留個紀錄好參考。真的很少用，可能有不少地雷，因此僅供參考，也歡迎大家分享曾經遇過的問題。

幾個容易有錯誤的地方

1. 海期商品與交易所的報價代號跟下單代號有些是不同的，請用 GetOverseaProductDetail 來查詢正確代號。

2. 報價代碼寫法是 "交易所代碼1,商品代碼1#交易所代碼2,商品代碼2"，不同商品間以#字號隔開

3. 海期商品連線報價主機後，只會回應 3001，之後即可查詢報價

3. 海期委託單物件填寫商品代碼跟 GetOverseaProductDetail 查詢的稍有出入，需要加工處理。例如微型小道瓊下單代碼為 MYM_202206，填入委託單物件時事拆成兩個參數，要分別填入商品代碼及年月, 如 bstrStockNo = "MYM" 及 bstrYearMonth = "202206"

4. 要能下單要有幾項前置作業， SKOrderLib_Initialize >> ReadCertByID >> GetUserAccount >> SKOrderLib_LoadOSCommodity

5. "期貨API下單同意書"要記得簽，才能進行海期報價，我都用手機掌中財神 app，下方有個同意書專區，把裡面能簽的都簽了。

6. 有網友詢問如何使用 GetOverSeaFutureOpenInterestGW，手冊寫經由 OnOverSeaFutureOpenInterestGW 回報，測試後發現並沒有反應。深查後發現手冊坑人，原來是經由 OnOFOpenInterestGWReport 來做回報，也一併加入本範例供參考。

Notebook 範例版 jupyter notebook

py 範例版，僅在 spyder IDE 下測試過

最近留言區被機器人進駐，有問題請到FB版上提問

2022-03-07T12:40:00.002+08:00

最近留言區被機器人進駐，會重複發一些垃圾留言，先暫停留言功能，有問題請到FB版上提問

FB連結

Add Virtual Environment to Jupyter Notebook

2021-11-02T12:11:00.001+08:00

確認有安裝 ipykernel 後，terminal 下移動到新建的虛擬環境資料夾下，例如 my_env_name 執行下列指令:

python -m ipykernel install --user --name=<my_env_name>

ref: Create Virtual Environment using “virtualenv” and add it to Jupyter Notebook | by B. Chen | Towards Data Science

群益API SKReplyLib 回報 OnNewData 範例

2021-10-06T16:12:00.002+08:00

現在沒有模擬單帳號可以測試了，因此我用群益下單軟體，下了個很遠不會成交的單子當作委託測試單。

另外最近 jupyter lab 開發不知道為什麼當我使用 %matplotlib auto 的 magic function時，會使整個notebook 當機，因此用 asyncio 自製了一個簡易的 event loop 來定時 pump event

ref:

jupyter跑 asyncio 的用法

Running asyncio — Mastering JupyterLab (nocomplexity.com)

範例

結果

在 linux 下使用wine python 串接群益 SKCOM API

2020-06-24T00:14:00.006+08:00

群益api 是使用 windows 的 COM 技術，在 linux 下要靠 wine 來模擬 windows 的環境。wine 要使用 32 bit 的相容性比較好，因此本篇 linux 系統 , python, skcom.dll 皆是使用 32 bit版。

操作概念是在 linux 下裝 wine 註冊 SKCOM.dll, 用 wine 安裝 windows 版本的 python, 再用這個windows 版的 python 安裝 comtypes, pywin32 等套件來使用 skcom。整個環境會是在 wine 底下執行的，操作起來還是有點隔閡，不是很順暢，我也還在摸索

linux 我使用 lubuntu 18.04 alternative-i386 這個桌面版本, 執行Wine時建議是要在有XWindow的環境下執行，安裝一些 windows 程式，會需要 GUI 的操作

linux wine 的安裝跟使用是參考這兩篇, 研究的超仔細，大推!!

wine, winetrick 安裝

wine 使用 SKCOM api

安裝 wine, winetricks

建議使用32位元的作業系統來安裝Wine，因為Wine目前64位元的支援很差，它主要是以執行32位元的Windows程式為主！
建議是透過compile Wine原始碼的方式來安裝Wine，也是為了避免32位元的函式庫裝得不夠完整！
winetricks 可以幫助安裝 VC++ runtime 2010 ，註冊 SKCOM.dll 時需要用到
剛裝好的 lubuntu 環境，把 apt 更新至最新，並裝下列開發套件，編譯 Wine 需要用到

$ sudo apt update; apt upgrade

$ sudo apt install openssh-client openssh-server vim software-properties-common gcc g++ vim subversion automake autoconf perl patch build-essential libtool doxygen bison flex zlib1g-dev gperf tofrodos wget curl screen git samba vsftpd bash-completion ftp colordiff libkrb5-dev rar unrar unzip vnstat libssl-dev

補足所需的套件

$ time apt install gnome-devel libx11-dev flex bison qt5-qmake libjpeg-dev libxslt1-dev libglu1-mesa-dev freeglut3-dev prelink libasound2-dev libfreetype6-dev libpng-dev libxml2-dev libxrender-dev libgl1-mesa-dev libgphoto2-dev libmpg123-dev libtiff-dev libpulse-dev liblcms2-dev libcapi20-dev libldap-dev libopenal-dev libv4l-dev libsane-dev libcups2-dev libgsm1-dev libosmesa6-dev libgnutls28-dev libpcap0.8-dev oss4-dev libcdk5-dev libgstreamer-plugins-base1.0-dev libarrayfire-opencl-dev

$ time apt install libsdl2-dev libvulkan-dev

清除一下apt-get抓下來的殘餘檔

$ apt clean

用root帳號登入
先把Wine的git repository上的code拉下來！

$ mkdir -pv /root/packages ; cd /root/packages

$ time git clone https://github.com/wine-mirror/wine

檢查套件是否足夠

$ cd ./wine

$ ./configure

#訊息大概剩下下面這樣，就差不多了。

configure: MinGW compiler not found, cross-compiling PE files won't be supported.

configure: libhal development files not found, no legacy dynamic device support.

configure: libFAudio development files not found, XAudio2 won't be supported.

configure: vkd3d development files not found (or too old), Direct3D 12 won't be supported.

接下來編譯並且安裝！編譯會花大約40-60分鐘

$ time make

$ time make install

接下來安裝winetricks！直接從github wget下來就可以用了！

$ mkdir -pv /opt/bin ; cd /opt/bin

$ wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks

$ chmod +x ./winetricks

$ ./winetricks -V

#檢查版本，出現下列訊息就沒問題了

20190615-next - sha256sum: 47304e177f259d6f9c05af01ab42c06531fd8a9716e2751d2fadcd664130feea

Wine 使用 SKCOM api

設定Wine的windows環境，在 XWindow環境下。第一次使用須初始化一個windows 環境，打開Terminal，執行以下指令以設定Wine的環境！我的環境是建立在 ~./home/使用者/.wine 下，.wine 就是windows 虛擬的系統，底下有個 drive_c 資料夾，等於 C:\ 槽

$ wineboot

群益API的SKCOM.dll檔需要 VC++ 2010可轉散發套件, 可透過winetricks來安裝 vcrun2010

$ winetricks vcrun2010　

下載群益API，將API 資料夾 CapitalAPI_2.13.22 下的x86 資料夾搬到 ~/.wine/drive_c/skcom/x86 這等於是存在 windows 的 C:\\skcom\\x86, 之後使用python 呼叫會方便一點
cd 到　~/.wine/drive_c/skcom/x86資料夾下，執行以下指令以註冊群益API：

$ regsvr32 ./SKCOM.dll

drive_c 下路徑的內容，skcom, python, strategy 是我自己創建的，資料夾名稱不要有空格，減少麻煩

wine下的 python環境

用wine 來安裝 windows版的 python
到 python 官網，我選了 Python3.8.3 的 Windows x86 executable installer　這個版本下載
我有嘗試使用miniconda，但 conda 或 pip 位置不在預設路徑上，我搞不定，導致python套件裝不起來

#使用 wine安裝windows版的python

#會有GUI跳出，可將python裝在 C:\\python 路徑下

$ wine python-3.8.3.exe

#安裝 comtypes 及 pywin32　套件，其他python套件也可以如此安裝

$ wine pip install comtypes pywine32

wine的windows版的 python 環境建置完成，可以開始 CODING!!

$ wine python

將寫好的 Script.py 交由 window python 執行, 要加wine 不然會呼叫到 linux系統下的 python, 兩個系統還是不相容的

$ wine python Script.py

附上 Script.py 的內容

import pythoncom, time, os
from comtypes.client import GetModule, GetEvents, CreateObject
from datetime import datetime

#第一次使用需要將 SKCOM 包成python 的package
#SKCOM.dll 在linux 下，我是放在 ~./home/yi/.wine/driv_c/skcom/x86/SKCOM.dll
#但在 wine 下，是放在下列路徑， drive_c 就是windows的C槽
GetModule(r'C:\\skcom\x86\SKCOM.dll')
#GetModule會在comtypes.gen 下產生 SKCOMLib package, 之後就用下面方式引用
import comtypes.gen.SKCOMLib as sk

#建立COM物件
if 'skC' not in globals(): skC=CreateObject(sk.SKCenterLib, interface=sk.ISKCenterLib)
if 'skQ' not in globals(): skQ=CreateObject(sk.SKQuoteLib, interface=sk.ISKQuoteLib)
if 'skR' not in globals(): skR=CreateObject(sk.SKReplyLib, interface=sk.ISKReplyLib)

#輸入身分證與密碼
ID=''
PW=''
#股票代號
strStock="TX00" 

print(str(datetime.now())[0:-4], 'ID & PW entered')

#建立事件類別
class skQ_events:                                
    def OnConnection(self, nKind, nCode):
        print(datetime.now(), 'OnConnection', nKind, nCode)
        if nKind == 3003:
            #nKind==3003 表連線報價主機就緒
            print("quoate server connected..., nkind= ", nKind)
            ncode=skQ.SKQuoteLib_RequestStocks(1, strStock)
            if ncode==0:
                print(strStock, 'requested')    
    
    def OnNotifyQuote(self, sMarket, sIndex):
        ts=sk.SKSTOCK()
        skQ.SKQuoteLib_GetStockByIndex(sMarket, sIndex, ts)
        print(ts.bstrStockName, ts.bstrStockNo,  ts.nClose/10**ts.sDecimal)
    
class skR_events:
    def OnReplyMessage(self, bstrUserID, bstrMessage, sConfirmCode=0xFFFF):
        print('OnReplyMessage', bstrMessage)
        return sConfirmCode
                            
#Event sink, 事件實體  
EventQ=skQ_events()
EventR=skR_events()

#make connection to event sink
ConnectionQ = GetEvents(skQ, EventQ)

ConnectionR = GetEvents(skR, EventR)

if __name__=='__main__':
    #登入
    nCode=skC.SKCenterLib_Login(ID, PW)
    print("Login,", skC.SKCenterLib_GetReturnCodeMessage(nCode))
    #連線報價主機
    print(f"{datetime.now()}, EnterMonitor,", skC.SKCenterLib_GetReturnCodeMessage(skQ.SKQuoteLib_EnterMonitor()))
    # Event loop, 持續檢查有沒有event產生
    pythoncom.PumpMessages()

輸出結果，大概類似下圖，夾雜很多 fixme的警告，但不影響使用

群益API 2.13.22 登入海期報價主機錯誤

2020-04-27T23:36:00.002+08:00

最近群益API更新，有好多小bug, 搞得好頭大...

用python呼叫群益API 2.13.22 登入海期報價主機發生錯誤, 會出現

OSError: exception: access violation writing 0x000000000000009C

經多方詢問後, 應該是api bug, 下個版本應該就會修正. 目前非官方的解法，創建 skcom 元件的時候，將海期及海選元件同時建立即可。目前測試可以 正常SKOSQuoate_Entermonitor(), 其他的還沒試過，給大家試試看吧。也不知道其他語言會有這個問題嗎？

skOSQ = CreateObject(sk.SKOSQuoteLib, interface=sk.ISKOSQuoteLib)
# 只要多下面這列就可以正常使用了
skOOQ = CreateObject(sk.SKOOQuoteLib, interface=sk.ISKOOQuoteLib)

群益api 選擇擇權代碼規則

2019-10-13T21:09:00.005+08:00

群益API 選擇權代碼規則

感謝 FB 網友提供

Call option : A~L代表1~12月

Put option : M~X代表1~12月。

群益的編碼邏輯都是 TX+@+strike+$+到期年分。

@: 可以是O代表一般月結算的選擇權，若以是數字則代表為 1~4 的週選。

$ : 是選擇權到期的月份，所以call跟put是不同的。

ex.

TXO10700L2 台指選, 履約價 10700, 12 月, 2022年的 call

TXO10700X2 台指選, 履約價 10700, 12 月, 2022年的 put

TXO14800A3 台指選, 履約價 14800, 1 月, 2023年的 call

TXO14800M3 台指選, 履約價 14800, 1 月, 2023年的 put

TX213000L2 台指週選 W2, 履約價 13000, 12 月, 2022年的 call

TX213000X2 台指週選 W2, 履約價 13000, 12 月, 2022年的 put

Ref:

【Python程式交易DIY 10】群益選擇權編碼原則, 開始寫最容易寫的釣魚單了.. 2022 01 12 11 07 33 - YouTube

群益API python 下單範例

2019-07-27T00:34:00.001+08:00

今天來示範下單, 請務必搞懂每個參數後在下單喔
我自己不放心所以去申請了模擬平台帳號，在來試試看下單的功能，不過模擬帳號目前沒有提供夜盤的功能，就加減用吧!! 之前介紹模擬平台的文章，大家參考一下囉
模擬平台有練功跟競賽兩種帳號，我沒有研究，隨便拿一個來用

from comtypes.client import GetModule, CreateObject, GetEvents
GetModule('C:\\skcom\\CapitalApi_2.13.17\\x64\\SKCOM.dll')
import comtypes.gen.SKCOMLib as sk
from datetime import datetime
import getpass

#建立物件，避免重複 createObject
#登錄物件
if 'skC' not in globals(): skC=CreateObject(sk.SKCenterLib, interface=sk.ISKCenterLib)
#下單物件
if 'skO' not in globals(): skO=CreateObject(sk.SKOrderLib , interface=sk.ISKOrderLib)   
#回報物件
if 'skR' not in globals(): skR=CreateObject(sk.SKReplyLib , interface=sk.ISKReplyLib)   

#輸入身分證與密碼

ID=''
PW=''
print(datetime.now(), 'ID & PW')

#建立事件類別             
class skO_events:
    def __init__(self):
        self.TFAcc=[]
        
    def OnAccount(self, bstrLogInID, bstrAccountData):
        strI=bstrAccountData.split(',')
        #找出期貨帳號
        if len(strI) > 3 :
            if strI[0] == 'TF' :
                self.TFAcc = strI[1]+strI[3]
            
class skR_events:        
    def OnReplyMessage(self, bstrUserID, bstrMessage, sConfirmCode=0xFFFF):
        '''API 2.13.17 一定要返回 sConfirmCode=0xFFFF'''
        print('skR_OnReplyMessage', bstrMessage)
        return sConfirmCode
    
    def OnData(self, bstrUserID, bstrData):

         #成交回報
        self.bstrOnData.append(datetime.now().strftime('%H:%M:%S,') + bstrData)
        strI = bstrData.split(",")
        print("skR_OnData", strI)
                        
    def OnNewData(self, bstrUserID , bstrData):
        print('skR_OnNewData', bstrData)

#Event sink, 事件實體
EventO=skO_events()
EventR=skR_events()

#make connection to event sink
ConnO = GetEvents(skO, EventO) 
ConnR = GetEvents(skR, EventR) 

print(datetime.now(), 'Making event objects')

%matplotlib auto
#登入模擬帳號
nCode=skC.SKCenterLib_ResetServer ("morder1.capital.com.tw")
print('set server to morder1.capital.com.tw', skC.SKCenterLib_GetReturnCodeMessage(nCode))

#login
nCode=skC.SKCenterLib_Login(ID,PW)
print('Login', skC.SKCenterLib_GetReturnCodeMessage(nCode))

#初始 Order 物件
nCode=skO.SKOrderLib_Initialize()
print("Initialize ", skC.SKCenterLib_GetReturnCodeMessage(nCode))

#初始 Cert by ID 物件，模擬平台不需要這個，會出現錯誤
nCode=skO.ReadCertByID(ID)
print("ReadCertByID ", skC.SKCenterLib_GetReturnCodeMessage(nCode))

#Get User TF Account
nCode=skO.GetUserAccount()
print("GetUserAccount ", skC.SKCenterLib_GetReturnCodeMessage(nCode), EventO.TFAcc)

#設定期貨單參數，請自行調整囉，注意參數的資料型別，例如 bstr開頭的是要輸入文字型態

#以下請再jupyter 裡用另外一個cell 跑

fo=sk.FUTUREORDER()
fo.bstrFullAccount=EventO.TFAcc      #TF 帳號
fo.bstrStockNo='MTX00'
fo.sBuySell=0                         #0 buy, 1 sell
fo.bstrPrice='10700'               #委託價格，「M」表示市價，{移動停損、MIT皆無須價格}
fo.nQty=1                              #交易口數
fo.sDayTrade=0                     #當沖0:否 1:是，可當沖商品請參考交易所規定。 
fo.sNewClose=2                     #新平倉，0:新倉 1:平倉 2:自動{新期貨、選擇權使用}
fo.sTradeType=1                    #0:ROD  1:IOC  2:FOK
fo.sReserved=0                     #盤別，0:盤中(T盤及T+1盤)；1:T盤預約{新期貨、停損單使用}

#下單
nCode=skO.SendFutureOrder(ID, False, fo)
print(nCode)

SKQuoteLib_RequestFutureTradeInfo 出現 LP_c_short error

2019-07-10T18:36:00.000+08:00

今日測試 SKQuoteLib_RequestFutureTradeInfo(0, 'TX00')，出現如下 error

---------------------------------------------------------------------------
ArgumentError                             Traceback (most recent call last)
 in ()
      1 import ctypes
----> 2 skQ.SKQuoteLib_RequestFutureTradeInfo(50, 'TX12')

ArgumentError: argument 1: : expected LP_c_short instance instead of int

看起來參數的型態不對，LP_c_short << 這個看起來很像 ctypes 會遇到的東西，所以我用 ctypes 試試看，轉換型別一下

import ctypes

skQ.SKQuoteLib_RequestFutureTradeInfo(ctypes.c_short(0), 'TX00')

恩  成功了!!!

tick data 轉換成 k Bar

2019-07-05T14:46:00.004+08:00

轉換tick資料成 k bar，做個記錄
有筆 tick csv 資料如下
TX00Ticks.csv
Name,nPtr,nDate,nTimehms,nTimemillismicros,nBid,nAsk,nClose,nQty
TX00,119,20190624,150000,17000,10621.0,10623.0,10622.0,36
TX00,120,20190624,150000,38000,10621.0,10622.0,10621.0,2
TX00,121,20190624,150000,167000,10620.0,10622.0,10622.0,1
TX00,122,20190624,150000,199000,10620.0,10621.0,10620.0,1
TX00,123,20190624,150000,205000,10620.0,10621.0,10620.0,1
TX00,124,20190624,150000,304000,10620.0,10621.0,10620.0,1
TX00,125,20190624,150000,321000,10620.0,10621.0,10621.0,2

pandas
要對一排一排的 row 做處理的話，apply 要設定 axis=1

ref: pandas apply 的使用
http://jonathansoma.com/lede/foundations/classes/pandas%20columns%20and%20functions/apply-a-function-to-every-row-in-a-pandas-dataframe/

#斬大寫得更簡單!! https://ithelp.ithome.com.tw/articles/10223693

import pandas as pd
from datetime import datetime

tick=pd.read_csv('TX00Ticks.csv')

#將三個column 的時間 轉成文字合併後，再用 datetime 轉成 datetime格式
def toDatetime(row):    
    t=str(row['nDate']) + ' ' + str(row['nTimehms']).zfill(6) + ' ' + str(row['nTimemillismicros'])
    return datetime.strptime(t, '%Y%m%d %H%M%S %f')

tick.index=tick.apply(toDatetime, axis=1)

tx1k=pd.DataFrame()
# 開 高 低 收 量
# T 是分鐘, 5分K就用 5T
tx1k['Open']=tick['nClose'].resample('T', label='right').first()
tx1k['High']=tick['nClose'].resample('T', label='right').max()
tx1k['Low']=tick['nClose'].resample('T', label='right').min()
tx1k['Close']=tick['nClose'].resample('T', label='right').last()
tx1k['Volume']=tick['nQty'].resample('T', label='right').sum()

群益API 更新至 2.13.17, Login 時錯誤訊息 "SK_WARNING_REGISTER_REPLYLIB_ONREPLYMESSAGE_FIRST"

2019-07-03T09:55:00.001+08:00

群益API 更新至 2.13.17，這版本 Login 時會要求要先看過公告的訊息
否則會出現錯誤訊息 "SK_WARNING_REGISTER_REPLYLIB_ONREPLYMESSAGE_FIRST".

API文件寫說:
SKCenterLib初使化檢查是否接收SKReplyLib_OnReplyMessage公告訊息並回傳指定值VARIANT_TRUE，方可登入。

SKReplyLib_OnReplyMessage 文件又寫說，當 sConfirmCode 回傳 VARIANT_TRUE (0xFFFF)，表示你看過公告了。官方沒附範例還真難理解要怎麼實做，一陣摸索後，寫了一個目前可以運作的版本。這更新真是擾民啊，可能要設計個介面讓人讀取公告後按確認，才能進行登入吧，我把它寫死了，固定回傳 0xFFFF ，也就是 VARIANT_TRUE

from comtypes.client import GetModule, CreateObject, GetEvents
GetModule(r'C:\SKCOM\CapitalAPI_2.13.17\x64\SKCOM.dll')
import comtypes.gen.SKCOMLib as sk
#建立COM物件
if 'skC' not in globals(): skC=CreateObject(sk.SKCenterLib, interface=sk.ISKCenterLib)
if 'skQ' not in globals(): skQ=CreateObject(sk.SKQuoteLib, interface=sk.ISKQuoteLib)
if 'skR' not in globals(): skR=CreateObject(sk.SKReplyLib, interface=sk.ISKReplyLib)
#Configuration
ID=''
PW=''
#建立事件類別
class skQ_events:
    def OnConnection(self, nKind, nCode):
        if nCode == 0 :
            if nKind == 3001 :  print("連線中, nkind= ", nKind)
            elif nKind == 3003: print("連線成功, nkind= ", nKind)
class skR_events:
    def OnReplyMessage(self, bstrUserID, bstrMessage, sConfirmCode=0xFFFF):
        #根據API 手冊，login 前會先檢查這個 callback, 
        #要返回 VARIANT_TRUE 給 server,  表示看過公告了，我預設返回值是 0xFFFF
        print('OnReplyMessage', bstrUserID, bstrMessage)
        return sConfirmCode       
#Event sink, 事件實體  
EventQ=skQ_events()
EventR=skR_events()
#make connection to event sink
ConnQ = GetEvents(skQ, EventQ)
ConnR = GetEvents(skR, EventR)
print("Login,", skC.SKCenterLib_GetReturnCodeMessage(skC.SKCenterLib_Login(ID, PW)))

GetFutureRight example

2019-06-14T17:53:00.000+08:00

示範一下 GetFutureRight 最簡版本

import time, pythoncom, sys
import comtypes.client as cc
#import skcom package
import comtypes.gen.SKCOMLib as sk
#Create com objects
skC = cc.CreateObject(sk.SKCenterLib, interface=sk.ISKCenterLib)
skO = cc.CreateObject(sk.SKOrderLib,interface=sk.ISKOrderLib)
#Order event handlers
class skO_events:
    def __init__(self):
        #TXAccount
        self.TXAcc=''
    def OnFutureRights(self, bstrData):
        print(bstrData)        
    def OnAccount(self, LogInID, AccountData):
        if AccountData.split(',')[0]=='TF':
            self.TXAcc= AccountData.split(',')[1]+ AccountData.split(',')[3]
            print('TXAcc', ID, self.TXAcc)

#implant event instances
EventO=skO_events()
#connect event to com object
EventO_conn=cc.GetEvents(skO,EventO)

#輸入身分證與密碼
ID=''
PW=''

#Login
nCode=skC.SKCenterLib_Login(ID,PW)
print('Login', skC.SKCenterLib_GetReturnCodeMessage(nCode))
#初始 Order 物件
nCode=skO.SKOrderLib_Initialize()
print("Initialize ", skC.SKCenterLib_GetReturnCodeMessage(nCode))
#Get User TF Account
nCode=skO.GetUserAccount()
print("GetUserAccount ", skC.SKCenterLib_GetReturnCodeMessage(nCode))
#GetFutureRights, 不能呼叫太頻繁，不然會出現 SK_ERROR_QUERY_IN_PROCESSING
nCode=skO.GetFutureRights(ID, EventO.TXAcc ,1)
print("GetFutureRights ", skC.SKCenterLib_GetReturnCodeMessage(nCode))

#每秒推一次 event, 推5秒
for i in range(5):
    pythoncom.PumpWaitingMessages()
    time.sleep(1)
#exit
sys.exit(0)

python copy file and rename

2019-03-11T15:15:00.001+08:00

#copy file (src) and move to the destination (dst)
from shutil import copyfile
copyfile(src, dst)

ref:
https://stackoverflow.com/questions/123198/how-do-i-copy-a-file-in-python

matplotlib label 上/下標，設置方法

2019-01-24T09:03:00.000+08:00

下標 (subscripts) 用底線 '_' ，上標(superscripts) 用 '^' 符號，前後用 '$' 包起來

例如這樣

#下標效果
plt.xlabel('RR$_{n}$ (ms)', fontsize=20)

#上標效果
plt.ylabel('RR$^{n+1}$ (ms)', fontsize=20)

結果

ref:
http://blog.sina.com.cn/s/blog_4a7b9abb0102x27h.html
其他特殊符號
https://matplotlib.org/users/mathtext.html

matplotlib 2.2.0 以上版本，finance 分離出來了

2019-01-20T17:31:00.002+08:00

最近想要使用 matplotlib 的 finance 包，突然發現找不到了，原來是從 matplotlib 2.2.0以上版本，就被分離出來了，需要另外獨自安裝

cmd line 下

pip install mpl_finance

就可以安裝囉

ref: 畫 candlestick chart
https://openwritings.net/pg/python/python-draw-candlestick-chart-using-mplfinance-fetching-data-csv-file

測試 SKOrderLib 的 GetBalanceQuery, GetMarginPurchaseAmountLimit 功能

2018-09-19T09:27:00.003+08:00

一點範例測試 GetBalanceQuery, GetMarginPurchaseAmountLimit 功能

from comtypes.client import GetModule, GetEvents, CreateObject
GetModule('C:\\SKCOM\\CapitalAPI_2.13.13\\x64\\SKCOM.dll')
import comtypes.gen.SKCOMLib as sk
skC = CreateObject(sk.SKCenterLib, interface=sk.ISKCenterLib)
skO = CreateObject(sk.SKOrderLib, interface=sk.ISKOrderLib)
    
#使用jupyter notebook magic function,這句可以讓 Event Pump 出來
%matplotlib auto

ID=''
PW=''

#建立事件類別
class skO_events:
    def __init__(self):
        #初始化，可以設定一些變數供使用
        self.Acc=''
        self.Balance=[]
    def OnBalanceQuery(self, bstrData):
        #將Balance 回傳資訊存在 event instance 的 Balance 屬性中
        self.Balance.append(bstrData)
        print('OnBalanceQuery', bstrData)
    def OnMarginPurchaseAmountLimit(self, bstrData):
        print('OnMargin', bstrData)
    def OnAccount(self, LogInID, AccountData):
        if AccountData.split(',')[0]=='TS':
            self.Acc=AccountData.split(',')[2] + AccountData.split(',')[3]
        print(LogInID, AccountData)

EventO=skO_events()
EventO_handler=GetEvents(skO, EventO)       

#Login
skC.SKCenterLib_Login(ID,PW)
#Order object initialize
skO.SKORderLib_Initialize()

skO.GetUserAccount()

skO.GetBalanceQuery(ID, EventO.Acc, '')
#查看 Balance
print(EventO.Balance)
skO.GetMarginPurchaseAmountLimit(ID, '', '')

python 接群益api callback / event 沒反應，常見問題

2018-09-18T13:52:00.002+08:00

沒有順序之分，想到過去有哪些經驗就寫什麼

1. python 跟 API 的位元版本要一樣，python 是64 bit，API 就裝 x64，網友指出 64位元版好像問題比較多，可以試試 32位元版本

2. 缺少 event loop, 在 IDE 或 GUI 介面下一般都會自帶有 eventloop 功能，比較不用煩惱。如果用 jupyter notebook 開發，可用 magic function: %matplotlib auto, 也會幫你準備一個 eventloop。

如果在 terminal 下開發，需要用 pythoncom.PumpWaitingMessages() / PumpMessages() 之類的方法讓 callback出來。如:

while Ture:
pythoncom.PumpWaitingMessages()

或是直接用 pythoncom.PumpMessages() 等同上面的 while loop

最近發現，使用 juypter notebook 的 magic function '%matplotlob auto' 來推動 eventloop，可能要注意 '%matplotlob auto' 放置的位置，太早使用，可能 eventloop 沒有反應，可以嘗試調整 '%matplotlob auto' 出現的位置。

3. Event class 的定義有錯誤，像是 class 定義 def 的名稱都要參照 API 文件裡事件的名稱
例如: SKQuotelib 的事件

class skQ_events:
def OnConnect(self, nKind, nCode):
print('nKind, nCode=', nKind, nCode)
def OnNotifyServerTime(self, sHour, sMinute, sSecond, nTotal):
print(sHour, sMinute, sSecond)

記得 def 裡第一個參數是 self，這個一開始寫常忘記

4. 如果是更新API 後有問題，可以考慮清空 comtypes.gen下的資料
請參考 https://easontseng.blogspot.com/2018/05/api-python-comtypes.html

我常用 OnNotifyServerTime 這個 callback 來看 eventloop 正不正常，連上群益報價主機後，每隔5秒主機會發送一個時間，可以藉此觀察 eventloop 有沒有問題。

以上是我的經驗，如果你有遇到其它情況，也歡迎在下面留言分享

等不到Onconnection 回報 3003

2018-07-25T16:48:00.000+08:00

最近發現登錄報價後常常等不到 Onconnection 回報 3003，困擾了很久，後來才發現這個問題原來我很久之前就記錄過了，不過一時忘記了，特此紀錄一下，下次比較好找問題。

原來如果我先呼叫 SKReplyLib_ConnectByID後，馬上乎叫 SKQuoteLib_EnterMonitor的話就會出現上述問題。安全做法是先EnterMonitor，再執行 SKReplyLib_ConnectByID，問題就可迎刃而解。細部原理我沒有深究，就先這樣吧!!

上完hahow 課程 "用 Python 理財：打造小資族選股策略" 心得

2018-07-25T16:36:00.002+08:00

最近剛聽完 hahow 的線上課程 "用 Python 理財：打造小資族選股策略"，覺得實在是蠻超值的。很完整的課程，個人覺得很適合剛開始接觸python，想要用python 進行理財的人入門，由淺入深，手動打造完整選股策略，條理清晰，很好懂。不過很多資訊都是點到為止，給你一點提示，想要更精進則需要自己再花更多時間去研究，找資料。如果沒有半點程式基礎的人，則需要另外花點時間熟悉python，熟悉程式語言的邏輯。

哇我買到早鳥票真是太超值了，已經回復原價了!!