Merge pull request #52 from FinMind/49-add-taiwanstocktradingdailyrep…

…ortsecidagg-document add: TaiwanStockTradingDailyReportSecIdAgg in datalist page
FinMind · Aug 25, 2024 · 45a36f9 · 45a36f9
2 parents 09802f1 + 9b65089
commit 45a36f9
Show file tree

Hide file tree

Showing 2 changed files with 168 additions and 3 deletions.
diff --git a/docs/tutor/TaiwanMarket/Chip.md b/docs/tutor/TaiwanMarket/Chip.md
@@ -1,4 +1,4 @@
-在台股籌碼面，我們擁有 14 種資料集，如下:
+在台股籌碼面，我們擁有 15 種資料集，如下:
 
 
 - [個股融資融劵表 TaiwanStockMarginPurchaseShortSale](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockmarginpurchaseshortsale)
@@ -17,6 +17,7 @@
 - [台股權證分點資料表(query by 券商代碼) TaiwanStockWarrantTradingDailyReport](https://finmind.github.io/tutor/TaiwanMarket/Chip/#query-by-taiwanstockwarranttradingdailyreport-sponsor_1)
 - [台股八大行庫賣賣表 TaiwanstockGovernmentBankBuySell](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockgovernmentbankbuysell-sponsor)
 - [台灣大盤融資維持率 TaiwanTotalExchangeMarginMaintenance](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwantotalexchangemarginmaintenance-backersponsor)
+- [當日卷商分點統計表 TaiwanStockTradingDailyReportSecIdAgg](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstocktradingdailyreportsecidagg-sponsor)
 
 
 ----------------------------------
@@ -1772,4 +1773,166 @@
             date: str,
             TotalExchangeMarginMaintenance: float64
         }
-        ```
+        ```
+
+#### 當日卷商分點統計表 TaiwanStockTradingDailyReportSecIdAgg (只限 [sponsor](https://finmindtrade.com/analysis/#/Sponsor/sponsor) 會員使用)
+
+- 提供台股，上市、上櫃、興櫃，的分點資訊！
+- 資料區間：2021-06-30 ~ now
+- 資料更新時間 **星期一至五 21:00**，實際更新時間以 API 資料為主
+
+!!! example
+    === "Package"
+        ```python
+        from FinMind.data import DataLoader
+
+        api = DataLoader()
+        # api.login_by_token(api_token='token')
+        # api.login(user_id='user_id',password='password')
+        df = api.taiwan_stock_trading_daily_report_secid_agg(
+            stock_id="2330",
+            start_date='2024-01-31',
+            end_date='2024-05-01'
+        )
+        ```
+    === "Python-request"
+        ```python
+        import requests
+        import pandas as pd
+        url = "https://api.finmindtrade.com/api/v4/data"
+        parameter = {
+            "dataset": "TaiwanStockTradingDailyReportSecIdAgg",
+            "stock_id": "2330",
+            "start_date": "2024-01-31",
+            "end_date": "2024-05-01",
+            "token": "", # 參考登入，獲取金鑰
+        }
+        data = requests.get(url, params=parameter)
+        data = data.json()
+        data = pd.DataFrame(data['data'])
+        print(data.head())
+
+        ```
+    === "R"
+        ```R
+        library(httr)
+        library(data.table)
+        library(dplyr)
+        url = 'https://api.finmindtrade.com/api/v4/data'
+        response = httr::GET(
+        url = url,
+        query = list(
+            dataset="TaiwanStockTradingDailyReportSecIdAgg",
+            stock_id="2330",
+            start_date= "2024-01-31",
+            end_date='2024-05-01'
+            token = "" # 參考登入，獲取金鑰
+        )
+        )
+        data = content(response)
+        df = data$data %>%
+        do.call('rbind',.) %>%
+        data.table
+        head(df)
+
+        ```
+
+!!! output
+    === "DataFrame"
+        |    | securities_trader | securities_trader_id |   stock_id |      date     |   buy_volume |  sell_volume | buy_price  | sell_price |
+        |---:|:------------------|---------------------:|-----------:|---------------:|------------:|-------------:|------------|:-----------|
+        |  0 | 合庫桃園           |        102E          |     2330   |   2024-01-31  |    17764     |    4104     |    630.2   |   630.78    |
+        |  0 | 高橋龍潭           |        5321          |     2330   |   2024-01-31  |    17555     |    1000     |    630.74  |   628       |
+        |  0 | 高橋              |         5320         |     2330   |   2024-01-31  |    33281     |    15222    |    630.56  |   634.05    |
+        |  0 | 兆豐三重           |        7008          |     2330   |   2024-01-31  |    15416     |    3421     |    629.24  |   632.41    |
+        |  0 | 新百王             |        6210          |     2330   |   2024-01-31  |    75169     |    57050    |    629.56  |    628.9    |
+    === "Schema"
+        ```
+        {
+            securities_trader: str,
+            securities_trader_id: str,
+            stock_id: str,
+            date: str,
+            buy_volume: int64,
+            sell_volume: int64,
+            buy_price: float,
+            sell_price: float,
+        }
+        ```
+
+#### 一次拿特定日期，所有資料(只限 [sponsor](https://finmindtrade.com/analysis/#/Sponsor/sponsor) 會員使用)
+
+!!! example
+    === "Package"
+        ```python
+        from FinMind.data import DataLoader
+
+        api = DataLoader()
+        # api.login_by_token(api_token='token')
+        # api.login(user_id='user_id',password='password')
+        df = api.taiwan_stock_trading_daily_report_secid_agg(
+            start_date='2024-01-31',
+        )
+        ```
+    === "Python-request"
+        ```python
+        import requests
+        import pandas as pd
+        url = "https://api.finmindtrade.com/api/v4/data"
+        parameter = {
+            "dataset": "TaiwanStockTradingDailyReportSecIdAgg",
+            "start_date": "2024-01-31",
+            "token": "", # 參考登入，獲取金鑰
+        }
+        data = requests.get(url, params=parameter)
+        data = data.json()
+        data = pd.DataFrame(data['data'])
+        print(data)
+
+        ```
+    === "R"
+        ```R
+        library(httr)
+        library(data.table)
+        library(dplyr)
+        url = 'https://api.finmindtrade.com/api/v4/data'
+        response = httr::GET(
+        url = url,
+        query = list(
+            dataset="TaiwanStockTradingDailyReportSecIdAgg",
+            start_date= "2024-01-31",
+            token = "" # 參考登入，獲取金鑰
+        )
+        )
+        data = content(response)
+        df = data$data %>%
+        do.call('rbind',.) %>%
+        data.table
+        head(df)
+
+        ```
+
+!!! output
+    === "DataFrame"
+        |    | securities_trader | securities_trader_id |   stock_id |      date     |   buy_volume |  sell_volume | buy_price  | sell_price |
+        |---:|:------------------|---------------------:|-----------:|---------------:|------------:|-------------:|------------|:-----------|
+        |  0 | 合庫桃園           |        102E          |     2330   |   2024-01-31  |    17764     |    4104     |    630.2   |   630.78    |
+        |  0 | 高橋龍潭           |        5321          |     2330   |   2024-01-31  |    17555     |    1000     |    630.74  |   628       |
+        |  0 | 高橋              |         5320         |     2330   |   2024-01-31  |    33281     |    15222    |    630.56  |   634.05    |
+        |  0 | 兆豐三重           |        7008          |     2330   |   2024-01-31  |    15416     |    3421     |    629.24  |   632.41    |
+        |  0 | 新百王             |        6210          |     2330   |   2024-01-31  |    75169     |    57050    |    629.56  |    628.9    |
+    === "Schema"
+        ```
+        {
+            securities_trader: str,
+            securities_trader_id: str,
+            stock_id: str,
+            date: str,
+            buy_volume: int64,
+            sell_volume: int64,
+            buy_price: float,
+            sell_price: float,
+        }
+        ```
+
+----------------------------------
diff --git a/docs/tutor/TaiwanMarket/DataList.md b/docs/tutor/TaiwanMarket/DataList.md
@@ -1,4 +1,4 @@
-在台灣金融市場，我們擁有 55 種資料集，如下:
+在台灣金融市場，我們擁有 56 種資料集，如下:
 
 #### 技術面 Technical
 
@@ -35,6 +35,8 @@
 - [台股權證分點資料表(query by 券商代碼) TaiwanStockWarrantTradingDailyReport](https://finmind.github.io/tutor/TaiwanMarket/Chip/#query-by-taiwanstockwarranttradingdailyreport-sponsor_1)
 - [台股八大行庫買賣表 TaiwanstockGovernmentBankBuySell](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstockgovernmentbankbuysell-sponsor)
 - [台灣大盤融資維持率 TaiwanTotalExchangeMarginMaintenance](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwantotalexchangemarginmaintenance-backersponsor)
+- [當日卷商分點統計表 TaiwanStockTradingDailyReportSecIdAgg](https://finmind.github.io/tutor/TaiwanMarket/Chip/#taiwanstocktradingdailyreportsecidagg-sponsor)
+
 
 #### 基本面 Fundamental