跳轉到

快速上手

安裝

在任意平台上，皆可安裝 FinLab Package，我們支援 Windows、MacOS、Linux，並且甚至是 Pyodide！ 以新手來說，推薦的使用方式是直接在 Google Colab，來使用。 Google Colab 可以線上產生一個執行 Python 的環境，使用者不需額外在本機安裝任何程式，即可開始使用。

打開選股策略頁面
https://ai.finlab.tw/strategies
並點選「建立策略」即可開始使用。

# 打開 Colab: https://colab.research.google.com/ 新增筆記本
# 在 Colab 中任意 Cell 中執行

!pip install finlab > log.txt

# 即可

# 在 anacnoda prompt 中執行

pip install finlab

可能存在相容性問題

用「pip install finlab」方法安裝，可能會造成 Package 不相容的問題，假如您希望得到更穩定的版本，請參考「Docker」安裝。

1. 安裝 Docker

請按照下列步驟安裝 Docker：

  • 前往 Docker 官方網站：https://www.docker.com/products/docker-desktop。
  • 在下載頁面中，按一下「Download Docker Desktop」按鈕。
  • 完成下載後，執行安裝程式並按照提示進行安裝。

2. 下載 FinLab 的 Jupyter 映像檔

在安裝 Docker 完成後，請按照以下步驟從 Docker Hub 下載 FinLab 的 Jupyter 映像檔：

開啟終端機或命令提示字元。

輸入以下命令以下載 FinLab 的 Jupyter 映像檔：

docker pull finlab/jupyter-finlab
此命令將會從 Docker Hub 下載映像檔，請耐心等待下載完成。

3. 執行映像檔並連接到 8888:8888 的 IP 位址

下載完成後，您可以使用以下命令執行映像檔：

docker run -p 8888:8888 finlab/jupyter-finlab
此命令將會啟動一個容器並將容器內部的 8888 埠口映射到您的本機 8888 埠口。請耐心等待容器啟動完成，終端機中將會顯示一個 URL，例如：

http://127.0.0.1:8888/?token=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
請複製該 URL，稍後您將使用它來連接到 JupyterLab。

4. 使用 JupyterLab 和 FinLab 套件

現在您已經成功啟動了 JupyterLab，請按照以下步驟進一步使用 JupyterLab 和 FinLab 套件：

在瀏覽器中打開剛剛複製的 URL。這將會顯示 JupyterLab 的介面。 在 JupyterLab 的介面中，您可以創建新的 Jupyter Notebook 。 在 Notebook 中，您可以使用 FinLab 提供的功能和套件。FinLab 是一個針對金融數據分析和策略回測的 Python 套件，詳細的使用方法請參考 FinLab 的官方文件。

下載資料

輸入以下程式碼，即可下載資料。可以查詢有哪些歷史資料可以下載。

from finlab import data

data.get('price:收盤價')
date 0015 0050 0051 0052 0053
2007-04-23 9.54 57.85 32.83 38.4 nan
2007-04-24 9.54 58.1 32.99 38.65 nan
2007-04-25 9.52 57.6 32.8 38.59 nan
2007-04-26 9.59 57.7 32.8 38.6 nan
2007-04-27 9.55 57.5 32.72 38.4 nan

撰寫策略

可以用非常簡單的 Pandas 語法來撰寫策略邏輯，以創新高的策略來說，可以用以下的寫法：

from finlab import data

close = data.get('price:收盤價')

# 創三百個交易日新高
position = close >= close.rolling(300).max()
position
date 0015 0050 0051 0052 0053
2007-04-23 00:00:00 False False False False False
2007-04-24 00:00:00 False False False False False
2007-04-25 00:00:00 False False False False False
2007-04-26 00:00:00 False False False True False
2007-04-27 00:00:00 False False False False False

這邊的 position 是一個 False/True 的查詢表，當數值為 True ，代表該股票在當天有創新高，而數字 False 則代表沒有創新高。由於創新高的股票很少，上面的範例中，只有少數股票的數值會是 True。

假設我們希望每個月底，搜尋上表中數值為 True 的股票並且買入持有一個月，可以用以下的語法：

回測績效

from finlab import backtest

report = backtest.sim(position, resample='M')
report.display()

image