Windows作業系統:本篇文章會用 Windows 11 Pro 來操作,一般建議使用版本至少要 Windows 10 以上。
Python環境設置
串接股票API前,必學的Python環境設置|股票量化交易從零開始
(欲看更多內容,請至量化通 QuantPass)
在API介紹與串接教學的文章中,分別介紹開戶流程以及使用前的 API 介紹。接著在本篇文章,我們將要進入建置適合元富 API 使用的 Python 環境。
Python 環境建置流程
步驟一:安裝 Pyenv
為了讓同一台電腦能夠安裝和切換多個 Python 版本,一般我們會需要安裝 Pyenv 來協助在 Windows 作業系統上操作。
只要透過 Pyenv,你就可以為全域或特定專案設定不同的 Python 版本。
至於 Pyenv 的安裝流程,具體如下:
- 1. 使用 pip 進行安裝:
◆ 在 PowerShell:
pip installpyenv-win --target $HOME\\.pyenv◆ 在 cmd:
pip installpyenv-win --target %USERPROFILE%\.pyenv直接在 Windows 的搜尋列搜尋 PowerShell 或是 cmd 即可開啟對應視窗。
2. 設定相關的環境變數(使用 PowerShell):
[System.Environment]::SetEnvironmentVariable('PYENV',$env:USERPROFILE+ "\.pyenv\pyenv-win\","User") [System.Environment]::SetEnvironmentVariable('PYENV_HOME',$env:USERPROFILE+ "\.pyenv\pyenv-win\","User")[System.Environment]::SetEnvironmentVariable('path', $env:USERPROFILE +"\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;"+ [System.Environment]::GetEnvironmentVariable('path',"User"),"User")3. 檢查是否安裝成功:
◆ 重新開啟你的 terminal(PowerShell 或 cmd)。
◆ 輸入「pyenv --version」指令查看 Pyenv 版本(如下圖)。
步驟二:Pyenv 常用的基本操作
- 1. Pyenv 基本的使用方式如下:
◆ 查看可安裝 Python 版本,輸入「pyenvinstall -l」指令。
◆ 安裝特定 Python 版本,輸入「pyenvinstall 3.10.5」指令。
◆ 查看當前 Python 版本,輸入「pyenvversion」指令(如下圖)。
◆ 查看可用 Python 版本,輸入「pyenv versions」指令(如下圖)。
2. Pyenv 使用注意:
關於 Pyenv 的操作,下面兩個是根據我自身經驗所分享,你們可以依照自身狀況決定是否要操作。◆ [建議]設定此專案使用的 Python 版本,輸入「pyenv local 3.10.5」指令。
◆ [不強迫使用]設定全域使用的 Python 版本,輸入「pyenv global 3.10.5」指令。請注意,輸入該指令,會讓你其他專案的版本,變成 Python 3.10.5。
元富 API 套件安裝
步驟一:安裝套件
由於我們需要先認證「下單」跟「行情」的 API,才能夠看到報價和執行下單的動作,所以需要先下載上圖中,用黃色標示的「Python」下單API 跟行情 API。
2. 將上述的檔案,下載到自己的專案資料夾。
請注意,MasterTradePy 是「下單 API」;SolPYAPI 是「行情 API」。將檔案下載並壓縮後,會跟下圖所顯示的一樣。3.下載完成後,接著再開啟
VS Code 進入此專案資料,具體步驟如下: 在資料夾內右鍵 → 顯示其他選項 → 使用 Code 開啟 4. 接著到「TERMINAL」欄位中,在確認一次版本是否為「3.10.5」。