Data 模組總覽
所屬章節：Data 表格查詢 以 2026-08-20 實際執行結果為準
Overview
api.Data（台股）與 api.USData（美股）是表格式查詢：一次要一張表，回傳
pandas.DataFrame，欄位是中文名稱。三個方法：
| 方法 | 用途 |
|---|---|
get_table() |
印出所有可用表名與其必填參數 |
get(table, *args) |
取一張表 |
get_snapshots(symbols) |
取即時報價快照（僅美股 api.USData；台股 api.Data 沒有） |
與 api.MSMP 的分工：
api.Data |
api.MSMP |
|
|---|---|---|
| 形狀 | 一般表格（一列一筆記錄） | 矩陣：日期（index）× 股票代號（columns） |
| 欄位 | 中文（收盤價、成交量） |
一個欄位就是一張矩陣 |
| 適合 | 查單一標的的明細、財報、分K | 全市場橫向運算、選股、回測 |
| 需要 token | 是 | 否（本地快取） |
積木（api.Block）底層用的是 api.MSMP，不是 api.Data。
Manual Sample Input/Output
Example 1：方法清單
input
[n for n in dir(api.Data) if not n.startswith('_')] # 台股
[n for n in dir(api.USData) if not n.startswith('_')] # 美股
output
['get', 'get_table'] # 台股 api.Data
['get', 'get_snapshots', 'get_table'] # 美股 api.USData（多 get_snapshots）
台股 api.Data 與美股 api.USData 幾乎相同，差別是 get_snapshots 只有美股有。