From acb8874e2ade6c35ad9b96eb4a6e95827fe17f8e Mon Sep 17 00:00:00 2001 From: linsamtw Date: Tue, 2 Jun 2026 21:34:25 +0800 Subject: [PATCH] =?UTF-8?q?knowledge:=20=E8=A3=9C=20storage=5Fobjects=20?= =?UTF-8?q?=E6=95=B4=E6=97=A5=E4=B8=8B=E8=BC=89=20+=20=E4=BF=AE=E6=AD=A3?= =?UTF-8?q?=20TaiwanOptionTick=20=E5=90=8D=E7=A8=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - datasets.md（GPT/MCP single source of truth）為 5 個 dataset 補 Bulk download (Sponsor Pro) 說明：TaiwanStockPriceTick / TaiwanStockKBar / TaiwanFuturesTick / TaiwanOptionTick / TaiwanStockTradingDailyReport，含 /v4/storage_objects endpoint + SDK use_object=True；註明整日下載限 Sponsor Pro（與逐檔查詢 tier 不同） - 三個新資料集（KBar/FuturesTick/OptionTick）註明逐交易日提供、無歷史回補 - 修正 bug：TaiwanOptionTIck（大寫 I）→ TaiwanOptionTick，並移除誤導性「T 大寫 I 大寫」說明。已用 live API 驗證 TaiwanOptionTick 回 200、TaiwanOptionTIck 回 422 - chatgpt/{instructions.txt,knowledge_bundle.md} 為 build_instructions.py 產出物 （gitignored），release 時重新產生即帶入上述變更 --- knowledge/datasets.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/knowledge/datasets.md b/knowledge/datasets.md index 8bbf2d1..2a1c175 100644 --- a/knowledge/datasets.md +++ b/knowledge/datasets.md @@ -68,6 +68,7 @@ ChatGPT Custom GPT 與 MCP server 共用此文件作為 single source of truth - **Optional:** （無） - **Key columns:** date, stock_id, deal_price, volume, Time, TickType - **描述:** 歷史逐筆成交（單日，含時間戳與委買委賣方向） +- **Bulk download (Sponsor Pro):** `GET /api/v4/storage_objects?dataset=TaiwanStockPriceTick&date=YYYY-MM-DD` 一次取整日全市場 parquet（signed URL，免逐檔查詢）；SDK `taiwan_stock_tick(date='YYYY-MM-DD', use_object=True)`。此整日下載限 **Sponsor Pro**（與上方逐檔查詢的 Backer tier 不同） ### TaiwanStockPER - **Endpoint:** `/api/v4/data` @@ -124,6 +125,7 @@ ChatGPT Custom GPT 與 MCP server 共用此文件作為 single source of truth - **Optional:** （無） - **Key columns:** date, minute, stock_id, open, high, low, close, volume - **描述:** 分鐘 K 線（單日，1 分鐘粒度） +- **Bulk download (Sponsor Pro):** `GET /api/v4/storage_objects?dataset=TaiwanStockKBar&date=YYYY-MM-DD` 一次取整日全市場 parquet（signed URL，免逐檔查詢）；SDK `taiwan_stock_kbar(date='YYYY-MM-DD', use_object=True)`。逐交易日提供、無歷史回補。此整日下載限 **Sponsor Pro** ### TaiwanStockWeekPrice - **Endpoint:** `/api/v4/data` @@ -262,6 +264,7 @@ ChatGPT Custom GPT 與 MCP server 共用此文件作為 single source of truth - **Optional:** （無） - **Key columns:** securities_trader, price, buy, sell, securities_trader_id, stock_id, date - **描述:** 分點進出（單日，按券商分點列出買賣） +- **Bulk download (Sponsor Pro):** `GET /api/v4/storage_objects?dataset=TaiwanStockTradingDailyReport&date=YYYY-MM-DD` 一次取整日全市場分點 parquet（signed URL，免逐檔查詢）；SDK `taiwan_stock_trading_daily_report(date='YYYY-MM-DD', use_object=True)`。此整日下載限 **Sponsor Pro** ### TaiwanStockWarrantTradingDailyReport - **Endpoint:** `/api/v4/taiwan_stock_warrant_trading_daily_report`（dedicated） @@ -434,14 +437,16 @@ ChatGPT Custom GPT 與 MCP server 共用此文件作為 single source of truth - **Optional:** （無） - **Key columns:** contract_date, date, futures_id, price, volume - **描述:** 期貨逐筆交易明細 +- **Bulk download (Sponsor Pro):** `GET /api/v4/storage_objects?dataset=TaiwanFuturesTick&date=YYYY-MM-DD` 一次取整日全市場 parquet（signed URL，免逐檔查詢）；SDK `taiwan_futures_tick(date='YYYY-MM-DD', use_object=True)`。逐交易日提供、無歷史回補。此整日下載限 **Sponsor Pro**（與上方逐檔查詢的 Backer tier 不同） -### TaiwanOptionTIck +### TaiwanOptionTick - **Endpoint:** `/api/v4/data` - **Tier:** Backer -- **Required:** `dataset=TaiwanOptionTIck`, `data_id` (選擇權代號), `start_date` (single day) +- **Required:** `dataset=TaiwanOptionTick`, `data_id` (選擇權代號), `start_date` (single day) - **Optional:** （無） - **Key columns:** ExercisePrice, PutCall, contract_date, date, option_id, price, volume -- **描述:** 選擇權逐筆交易明細（注意 dataset 名稱 TIck，T 大寫 I 大寫） +- **描述:** 選擇權逐筆交易明細 +- **Bulk download (Sponsor Pro):** `GET /api/v4/storage_objects?dataset=TaiwanOptionTick&date=YYYY-MM-DD` 一次取整日全市場 parquet（signed URL，免逐檔查詢）；SDK `taiwan_option_tick(date='YYYY-MM-DD', use_object=True)`。逐交易日提供、無歷史回補。此整日下載限 **Sponsor Pro**（與上方逐檔查詢的 Backer tier 不同） ### TaiwanFuturesInstitutionalInvestors - **Endpoint:** `/api/v4/data`