Data.get 取得表格資料

所屬章節：Data 表格查詢以 2026-08-20 實際執行結果為準

Overview

查詢指定資料表，回傳 pandas.DataFrame。

api.Data.get(table, *args)

參數	型態	說明
`table`	`str`	表名，從 `get_table()` 取得
`*args`		該表的必填參數（股票代號、日期、分鐘數…），順序照 `get_table()` 標示

Manual Sample Input/Output

Example 1：上市櫃/ETF 清單（無參數）

input

df = api.Data.get('上市櫃/ETF清單(含當沖限制)')
df.head()

output

DataFrame shape: (2728, 8)
columns: ['股票代號', '股票名稱', '日期', '市場', 'ETF', '可先買後賣當沖標的', '可先賣後買當沖標的', '當日禁止當沖標的']

     股票代號      股票名稱         日期 市場 ETF 可先買後賣當沖標的 可先賣後買當沖標的 當日禁止當沖標的
0  00400A  主動國泰動能高息 2026-08-20  1   1         Y         Y
1  00401A  主動摩根台灣鑫收 2026-08-20  1   1         Y         Y
2  00402A  主動安聯美國科技 2026-08-20  1   1         Y         Y
3  00403A  主動統一升級50 2026-08-20  1   1         Y         Y
4  00404A  主動聯博動能50 2026-08-20  1   1         Y         Y

市場 與 ETF 是代碼欄（1 代表該分類），不是中文標籤。

Example 2：還原日K（單股多期）

input

df = api.Data.get('還原日K價量資料(個股、ETF、大盤)-單檔股票多個區間', '2330')
df.tail(3)

output

DataFrame shape: (1000, 14)
columns: ['日期', '股票代號', '股票名稱', '開盤價', '最高價', '最低價', '收盤價', '成交量',
          '漲跌', '漲跌幅(%)', '市值(百萬元)', '次日開盤參考價', '成交金額(百萬)', '現股當沖量(千股)']

            日期  股票代號 股票名稱   開盤價   最高價   最低價   收盤價         成交量  漲跌  漲跌幅(%)   市值(百萬元)  次日開盤參考價
997 2026-08-17  2330  台積電  2410  2420  2390  2400  13482.4560   5   0.2100  62237688     2400
998 2026-08-18  2330  台積電  2415  2415  2375  2380  19997.2130 -20  -0.8300  61719041     2380
999 2026-08-19  2330  台積電  2340  2355  2335  2350  23618.6120 -30  -1.2600  60941070     2350

固定回傳最近 1000 筆交易日。

Example 3：個股季財報

input

df = api.Data.get('個股季財報資訊-單檔股票多個區間', '2330')
df.shape, df.columns[:12].tolist()

output

(46, 135)

['年季', '資產(千)', '負債(千)', '股東權益(千)', '流動資產(千)', '流動負債(千)',
 '合約負債–流動(千)', '合約負債–非流動(千)', '合約負債(千)', '公告累計EPS(元)',
 '公告EPS(元)', '公告EPS成長率(%)']

46 季（2015-Q1 起）× 135 欄。年季 欄格式為 '2015-Q1'。

金額類欄位單位在欄名裡（(千)、(百萬)），比率類是 (%)。

Example 4：分K

input

df = api.Data.get('取得歷史分K(含加權/櫃買指數)', '2330', 30)
df.tail(3)

output

DataFrame shape: (999, 11)
columns: ['日期', 'hhmm', '開盤價', '最高價', '最低價', '收盤價', '成交量',
          '日成交金額(千)', '日成交量', '日平均價', 'datetime']

            日期  hhmm   開盤價   最高價   最低價   收盤價  成交量  日成交金額(千)  日成交量      日平均價            datetime
996 2026-08-20  1030  2360  2365  2355  2360  897  11743195  4972 2361.8700 2026-08-20 10:30:00
997 2026-08-20  1100  2355  2360  2350  2355  818  13669960  5790 2360.9600 2026-08-20 11:00:00
998 2026-08-20  1130  2360  2360  2355  2360   93  13889035  5883 2360.8800 2026-08-20 11:30:00

分K 有當日盤中資料（與 api.MSMP 只到前一交易日不同）。

Example 5：兩種錯誤訊息

缺必填參數——訊息會直接給正確用法：

input

api.Data.get('個股季財報資訊-單檔股票多個區間')

output

ValueError: 參數輸入錯誤，正確用法：Data.get('個股季財報資訊-單檔股票多個區間', '2330')

表名不存在：

input

api.Data.get('不存在的表')

output

ValueError: 找不到 table: 不存在的表

80 張表按用途分組

get_table() 一次吐 80 個表名很難掃。這裡按用途分組，合計剛好 80 張，一張都沒漏。參數欄照 get_table() 的原始標記。

清單與狀態（無參數）（10 張）

表名	參數
`台股產業對照表`	（無）
`全額交割股`	（無）
`處置股票`	（無）
`分盤交易`	（無）
`禁現沖標的`	（無）
`今日暫停交易`	（無）
`注意股票`	（無）
`上市櫃/ETF清單(含當沖限制)`	（無）
`股市行事曆-多檔股票最新時間`	（無）
`即將下市及過去五年下市股票-多檔股票最新時間`	（無）

盤中大盤概況（5 張）

表名	參數
`漲跌家數(盤中)`	（無）
`漲跌列表(盤中)`	（無）
`漲跌家數分鐘歷史(盤中)`	（無）
`粗產業多(盤中)`	（無）
`粗產業空(盤中)`	（無）

全市場排行／快照（多檔最新）（12 張）

表名	參數
`ROE/ROA-多檔股票最新時間`	（無）
`EPS/本益比/殖利率-多檔股票最新時間`	（無）
`日K價量資料(個股、ETF)-多檔股票最新時間`	（無）
`籌碼買賣資料(個股、ETF)-多檔股票最新時間`	（無）
`三大法人買賣超-多檔股票最新時間`	（無）
`即時周轉率排行`	（無）
`收盤20日周轉率`	（無）
`券資比-多檔股票最新時間`	（無）
`前15大主力券商買賣超佔比-多檔股票最新時間`	（無）
`成交金額及股本-多檔股票指定時間`	"date"(yyyyMMdd)
`月營收創歷史新高新低`	"symbol"
`大盤-法人買賣資料-多檔股票最新時間`	（無）

單檔多期：K線與技術指標（7 張）

表名	參數
`日K/技術指標/價量資料-單檔股票多個區間`	"symbol"
`週K/技術指標/價量/籌碼資料-單檔股票多個區間`	"symbol"
`月K/技術指標/價量/籌碼資料-單檔股票多個區間`	"symbol"
`還原日K價量資料(個股、ETF、大盤)-單檔股票多個區間`	"symbol"
`還原週K價量資料(個股、ETF、大盤)-單檔股票多個區間`	"symbol"
`還原月K價量資料(個股、ETF、大盤)-單檔股票多個區間`	"symbol"
`股價報酬(日)Beta值-單檔股票多個區間`	"symbol"

單檔多期：財報與基本面（9 張）

表名	參數
`季毛利率/季營益率/ROE-單檔股票多個區間`	"symbol"
`季稅後淨利/季稅後EPS-單檔股票多個區間`	"symbol"
`個股季財報資訊-單檔股票多個區間`	"symbol"
`個股股利資訊(年)-單檔股票多個區間`	"symbol"
`個股資本支出-單檔股票多個區間`	"symbol"
`個股營收資訊-單檔股票多個區間`	"symbol"
`個股股利資訊(季、含填息天數)-單檔股票多個區間`	"symbol"
`市值/淨利/淨值(個股、ETF、大盤)-單檔股票多個區間`	"symbol"
`近四季財報加總-單檔股票多個區間`	"symbol"

單檔多期：籌碼（11 張）

表名	參數
`個股籌碼分佈-單檔股票多個區間`	"symbol"
`籌碼資料(個股、ETF、大盤)-單檔股票多個區間`	"symbol"
`大/小股東持股變化-單檔股票多個區間`	"symbol"
`查詢八大行庫買賣超-單檔股票多個區間`	"symbol"
`股市行事曆-單檔股票多個區間`	"symbol"
`個股資餘資券相抵-單檔股票多個區間`	"symbol"
`籌碼集中渙散/主力買賣超-單檔股票多個區間`	"symbol"
`個股券商買賣超Top10-單檔股票多個區間`	"symbol"
`取得歷史1分K(指定起訖日)`	"symbol" ,"startDate"(yyyyMMdd) ,"endDate"(yyyyMMdd)
`大盤-法人買賣資料-單檔股票多個區間`	"args"(查閲"大盤-法人買賣資料-多檔股票最新時間"中的"代號")
`查詢TOP15主力分點買賣超加總資料(指定起訖日)`	"symbol" ,"startDate"(yyyyMMdd) ,"endDate"(yyyyMMdd)

券商分點（3 張）

表名	參數
`查詢近100日該分點資料`	`symbol`、`brokerId`
`查詢分點最新TOP10買賣超資料`	`brokerId`
`查詢分點近N日Top15買賣超資料`	`brokerId`、`N`（½/¾/5/10/20/60/80/100/120/180/240）

分K與逐筆明細（15 張）

表名	參數
`取得即時分K(最後交易日)`	"symbol" ,minutes(⅓/5/15/30/60)
`取得歷史分K(指定日期前)`	"symbol" ,"date"(yyyyMMdd) ,minutes(⅓/5/15/30/60)
`取得即時分K-含興櫃`	"symbol"
`取得歷史3分K(指定當日)`	"symbol" ,"date"(yyyyMMdd)
`取得歷史5分K(指定當日)`	"symbol" ,"date"(yyyyMMdd)
`取得歷史分K(含加權/櫃買指數)`	"symbol" ,minutes(⅓/5/15/30/60)
`分價量`	"symbol"
`取得指定日期前幾天的分價量歷史資料`	"symbol" ,"date"(yyyyMMdd) ,days
`取得歷史1分K(指定日期前5天)`	"symbol" ,"endDate"(yyyyMMdd)
`批次取得個股盤中內外盤-含興櫃與權證`	List[symbol、symbol、symbol....]
`取得個股盤中內外盤-含興櫃`	"symbol"
`取得今日即時成交明細(含五檔報價)`	"symbol"
`取得今日即時成交明細(貼標大戶/散戶)`	"symbol"
`取得零股成交明細`	"symbol"
`取得最新一筆成交明細(含五檔報價)`	"symbol"

批次盤中（3 張）

表名	參數
`批次取得個股盤中行情`	List[symbol、symbol、symbol....]
`批次取得個股盤中行情-含興櫃(tick含試搓)`	List[symbol、symbol、symbol....]
`批次取得盤中預估量`	List[symbol、symbol、symbol....]

單值查詢（給一個代號拿一組結果，5 張）

表名	參數
`公司基本資料`	"symbol"
`ETF持股清單`	"symbol"(etf)
`個股上個交易日成交均張(成交量/成交筆數)`	"symbol"
`產業個股清單`	"sector"( "台股產業對照表"中的"指數彙編分類")
`查詢近100日買賣張數加總_高至低排序`	`symbol`

brokerId 的格式是 '代號分點名'（例如 '1234 某券商某分點'）。合法值從 查詢近100日買賣張數加總_高至低排序 取——它回的是這檔股票近 100 日有交易的分點清單（分點代號 / 分點名稱 兩欄，實測 878 筆），把兩欄組起來即可。

get_table() 自己印的提示會帶一個券商分點當範例，那段文字是伺服器回傳的，不在套件裡。

挑表的三個判斷

「多檔最新」vs「單檔多期」是最重要的分野：表名結尾 -多檔股票最新時間 是全市場一個時間點（拿來做排行、篩選）， -單檔股票多個區間 是一檔股票的時間序列（拿來看趨勢、算指標）。

要全市場的時間序列就別用 api.Data，用 api.MSMP 的矩陣（日期 × 股票代號），一次拿到全部。見 msmp.md。

歷史長度看頻率：日頻一律 1000 筆（約 4.1 年），週／月／季／年頻回溯 11~16 年。見 data-history.md。

注意

api.Data 需要有效 token。登入時若印出 [系統訊息] Token無效，api.Data 不會掛上。
每次 get() 都是一次網路請求，會印一行 INFO - Fetching table: ...。要對全市場做橫向運算請改用 api.MSMP，那是本地快取的矩陣。