開始使用

快速上手

本頁內容4

這一頁帶你從零跑出第一個回測：安裝 → 下載資料 → 寫條件 → 回測，大約 5 分鐘。每段程式都能直接複製執行。

選一個地方執行

第一次用建議選 Google Colab：打開瀏覽器就能寫，不用在電腦上安裝 Python。

到 Google Colab 開一個新的筆記本，在第一格執行：

!pip install finlab

需要 Python 3.10 以上。在終端機執行：

pip install finlab

遇到套件版本衝突時，可以改用 Docker，或另開一個虛擬環境（python -m venv）再安裝。

映像檔已裝好 FinLab 與 JupyterLab：

docker pull finlab/jupyter-finlab
docker run -p 8888:8888 finlab/jupyter-finlab

依終端機顯示的網址打開 JupyterLab。

data.get() 用「資料表:欄位」的名稱下載資料。第一次執行會打開瀏覽器請你登入 FinLab，免費註冊即可。

from finlab import data

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

from finlab import data

data.set_market('us')
close = data.get('price:adj_close')
close.tail()

回傳的是一張表：每一列是一個交易日，每一欄是一檔股票（上表只列出其中幾檔）。FinLab 的所有資料都長這樣，財報、月營收、法人買賣超也是。

免費帳號的台股資料到 2023 年底，VIP 每天更新到最新，上面的表是 VIP 帳號的結果。

用 Pandas 的語法比較整張表。下面這行的意思是「收盤價創 300 個交易日新高」：

position = close >= close.rolling(300).max()

結果是同樣形狀的表，每一格是 True 或 False，True 代表那一天要持有那一檔股票。比較運算一次算完整張表，下圖用「收盤價高於 60 日均線」說明：

close 收盤價

close.average(60) 60 日均線

position 要持有的股票

每一格是一檔股票在一天的值。比較運算一次算完整張表，日期與股票會自動對齊；True 就是那天要持有的股票。數字為示意。

把條件交給 backtest.sim()。resample='M' 表示每月底檢查一次條件，在下一個交易日換股：

from finlab import backtest

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

report.display() 會畫出完整的回測報告，下面就是這段程式跑出來的結果，可以直接在上面操作：

回測報告・可互動開新視窗

報告最上面是報酬曲線和幾個最常看的數字：

想在程式裡拿到這些數字，用 report.get_stats()；想看每一筆交易，用 report.get_trades()。

不確定資料表叫什麼？到資料目錄搜尋欄位，或在 AI 編程助手（Claude Code、Cursor 等）安裝 FinLab Skill，直接問「營收相關的資料有哪些？」。

這一頁有幫到你嗎？