籌碼面

在台股籌碼面，我們擁有 20 種資料集，如下:

• 個股融資融劵表 TaiwanStockMarginPurchaseShortSale
• 整體市場融資融劵表 TaiwanStockTotalMarginPurchaseShortSale
• 個股三大法人買賣表 TaiwanStockInstitutionalInvestorsBuySell
• 整體市場三大法人買賣表 TaiwanStockTotalInstitutionalInvestors
• 外資持股表 TaiwanStockShareholding
• 股權持股分級表 TaiwanStockHoldingSharesPer
• 借券成交明細 TaiwanStockSecuritiesLending
• 暫停融券賣出表(融券回補日) TaiwanStockMarginShortSaleSuspension
• 信用額度總量管制餘額表 TaiwanDailyShortSaleBalances
• 證券商資訊表 TaiwanSecuritiesTraderInfo
• 台股分點資料表(query by 股票代碼) TaiwanStockTradingDailyReport
• 台股分點資料表(query by 券商代碼) TaiwanStockTradingDailyReport
• 台股權證分點資料表(query by 股票代碼) TaiwanStockWarrantTradingDailyReport
• 台股權證分點資料表(query by 券商代碼) TaiwanStockWarrantTradingDailyReport
• 台股八大行庫買賣表 TaiwanstockGovernmentBankBuySell
• 台灣大盤融資維持率 TaiwanTotalExchangeMarginMaintenance
• 當日卷商分點統計表 TaiwanStockTradingDailyReportSecIdAgg
• 鉅額交易買賣日報表 TaiwanStockBlockTradingDailyReport
• 鉅額交易日成交資訊 TaiwanStockBlockTrade
• 借貸款項擔保品餘額表 TaiwanStockLoanCollateralBalance
• 公布處置有價證券表 TaiwanStockDispositionSecuritiesPeriod
• 現股當日沖銷券差借券費率 TaiwanStockDayTradingBorrowingFeeRate

---

個股融資融劵表 TaiwanStockMarginPurchaseShortSale

• 資料區間：2001-01-01 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePythonRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_margin_purchase_short_sale(
    stock_id="2330",
    start_date='2020-04-02',
    end_date='2020-04-12',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockMarginPurchaseShortSale",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockMarginPurchaseShortSale",
        data_id= "2330",
        start_date= "2020-01-02",
        end_date= "2020-04-12",
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_margin_purchase_short_sale(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	date	stock_id	MarginPurchaseBuy	MarginPurchaseCashRepayment	MarginPurchaseLimit	MarginPurchaseSell	MarginPurchaseTodayBalance	MarginPurchaseYesterdayBalance	Note	OffsetLoanAndShort	ShortSaleBuy	ShortSaleCashRepayment	ShortSaleLimit	ShortSaleSell	ShortSaleTodayBalance	ShortSaleYesterdayBalance
0	2020-04-06	2330	1914	8	6482595	1269	26285	25648	X	0	0	24	6482595	0	0	24
1	2020-04-07	2330	1049	13	6482595	2655	24666	26285	X	0	0	0	6482595	0	0	0
2	2020-04-08	2330	1192	3	6482595	1569	24286	24666		0	0	0	6482595	0	0	0
3	2020-04-09	2330	499	28	6482595	1362	23395	24286		209	0	0	6482595	398	398	0
4	2020-04-10	2330	1227	24	6482595	794	23804	23395		53	156	0	6482595	156	398	398

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    MarginPurchaseBuy: int64, # 融資買進
    MarginPurchaseCashRepayment: int64, # 融資現金償還
    MarginPurchaseLimit: int64, # 融資限額
    MarginPurchaseSell: int64, # 融資賣出
    MarginPurchaseTodayBalance: int64, # 融資今日餘額
    MarginPurchaseYesterdayBalance: int64, # 融資昨日餘額
    Note: str, # 註記
    OffsetLoanAndShort: int64, # 資券互抵
    ShortSaleBuy: int64, # 融券買進
    ShortSaleCashRepayment: int64, # 融券償還
    ShortSaleLimit: int64, # 融券限額
    ShortSaleSell: int64, # 融券賣出
    ShortSaleTodayBalance: int64, # 融券今日餘額
    ShortSaleYesterdayBalance: int64 # 融券昨日餘額
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_margin_purchase_short_sale(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockMarginPurchaseShortSale",
    "start_date": "2020-04-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockMarginPurchaseShortSale",
        start_date= "2020-01-02"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	MarginPurchaseBuy	MarginPurchaseCashRepayment	MarginPurchaseLimit	MarginPurchaseSell	MarginPurchaseTodayBalance	MarginPurchaseYesterdayBalance	Note	OffsetLoanAndShort	ShortSaleBuy	ShortSaleCashRepayment	ShortSaleLimit	ShortSaleSell	ShortSaleTodayBalance	ShortSaleYesterdayBalance
0	2020-04-01	0050	193	15	263750	163	3189	3174		0	65	1	263750	13	2283	2336
1	2020-04-01	0051	0	0	2375	0	5	5		0	0	0	2375	0	0	0
2	2020-04-01	0052	0	0	7500	0	128	128		0	0	0	7500	0	0	0
3	2020-04-01	0053	0	0	1622	0	1	1		0	0	0	1622	0	0	0
4	2020-04-01	0054	0	0	2531	0	0	0	X	0	0	0	2531	0	0	0

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    MarginPurchaseBuy: int64, # 融資買進
    MarginPurchaseCashRepayment: int64, # 融資現金償還
    MarginPurchaseLimit: int64, # 融資限額
    MarginPurchaseSell: int64, # 融資賣出
    MarginPurchaseTodayBalance: int64, # 融資今日餘額
    MarginPurchaseYesterdayBalance: int64, # 融資昨日餘額
    Note: str, # 註記
    OffsetLoanAndShort: int64, # 資券互抵
    ShortSaleBuy: int64, # 融券買進
    ShortSaleCashRepayment: int64, # 融券償還
    ShortSaleLimit: int64, # 融券限額
    ShortSaleSell: int64, # 融券賣出
    ShortSaleTodayBalance: int64, # 融券今日餘額
    ShortSaleYesterdayBalance: int64 # 融券昨日餘額
}

---

台灣市場整體融資融劵表 TaiwanStockTotalMarginPurchaseShortSale

• 資料區間：2001-01-01 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_margin_purchase_short_sale_total(
    start_date='2020-04-01',
    end_date='2020-04-12',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockTotalMarginPurchaseShortSale",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockTotalMarginPurchaseShortSale",
        start_date= "2020-01-02",
        end_date= "2020-04-12"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	TodayBalance	YesBalance	buy	date	name	Return	sell
0	5463820	5471770	236127	2020-04-01	MarginPurchase	10986	233091
1	91965082000	91898116000	4046643000	2020-04-01	MarginPurchaseMoney	196619000	3783058000
2	541704	556742	57266	2020-04-01	ShortSale	6151	48379
3	535401	541704	50779	2020-04-06	ShortSale	3700	48176
4	93198509000	91965082000	6440842000	2020-04-06	MarginPurchaseMoney	71638000	5135777000

{
    TodayBalance: int64, # 今日餘額
    YesBalance: int64, # 昨日餘額
    buy: int64, # 買進
    date: str, # 日期
    name: str, # 種類
    Return: int64, # 現金/券償還
    sell: int64 # 賣出
}

---

法人買賣表 TaiwanStockInstitutionalInvestorsBuySell

• 資料區間：2005-01-01 ~ now
• 資料涵蓋：上市、上櫃、興櫃公司，以 stock_id 區分（可搭配 TaiwanStockInfo 查詢市場別）
• 資料更新時間 星期一至五 20:00，實際更新時間以 API 資料為主

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_institutional_investors(
    stock_id="2330",
    start_date='2020-04-01',
    end_date='2020-04-12',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockInstitutionalInvestorsBuySell",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockInstitutionalInvestorsBuySell",
        data_id= "2330",
        start_date= "2020-04-01",
        end_date= "2020-04-12"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_institutional_investors(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	date	stock_id	buy	name	sell
0	2020-04-01	2330	31304729	Foreign_Investor	29057663
1	2020-04-01	2330	0	Foreign_Dealer_Self	0
2	2020-04-01	2330	900000	Investment_Trust	239000
3	2020-04-01	2330	79000	Dealer_self	807000
4	2020-04-01	2330	189000	Dealer_Hedging	493500

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    buy: int64, # 買進
    name: str, # 類別
    sell: int64 # 賣出
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_institutional_investors(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockInstitutionalInvestorsBuySell",
    "start_date": "2020-04-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data)

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockInstitutionalInvestorsBuySell",
        start_date= "2020-01-02"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	buy	name	sell
0	2020-04-01	0050	458249	Foreign_Investor	4492000
1	2020-04-01	0050	0	Foreign_Dealer_Self	0
2	2020-04-01	0050	54000	Investment_Trust	0
3	2020-04-01	0050	0	Dealer_self	0
4	2020-04-01	0050	2050000	Dealer_Hedging	905000

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    buy: int64, # 買進
    name: str, # 類別
    sell: int64 # 賣出
}

---

台灣市場整體法人買賣表 TaiwanStockTotalInstitutionalInvestors

• 資料區間：2004-04-01 ~ now
• 資料更新時間 星期一至五 15:00，實際更新時間以 API 資料為主

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_institutional_investors_total(
    start_date='2020-04-01',
    end_date='2020-04-12',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockTotalInstitutionalInvestors",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockTotalInstitutionalInvestors",
        start_date= "2020-01-02",
        end_date='2020-04-12'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	buy	date	name	sell
0	123150	2020-04-01	Foreign_Dealer_Self	266220
1	3681729831	2020-04-01	Dealer_Hedging	5539788946
2	33759089839	2020-04-01	Foreign_Investor	38466572585
3	3039112340	2020-04-01	Investment_Trust	853138940
4	789316840	2020-04-01	Dealer_self	912143500

{
    buy: int64, # 買進
    date: str, # 日期
    name: str, # 種類
    sell: int64 # 賣出
}

---

外資持股表 TaiwanStockShareholding

• 資料區間：2004-02-01 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_shareholding(
    stock_id="2330",
    start_date='2020-04-01',
    end_date='2020-04-12'
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockShareholding",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockShareholding",
        data_id= "2330",
        start_date= "2020-01-02",
        end_date="2020-04-12"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_shareholding(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	date	stock_id	stock_name	InternationalCode	ForeignInvestmentRemainingShares	ForeignInvestmentShares	ForeignInvestmentRemainRatio	ForeignInvestmentSharesRatio	ForeignInvestmentUpperLimitRatio	ChineseInvestmentUpperLimitRatio	NumberOfSharesIssued	RecentlyDeclareDate	note
0	2020-04-01	2330	台積電	TW0002330008	6309042842	19621337616	24.33	75.66	100	100	25930380458	2019-05-27
1	2020-04-06	2330	台積電	TW0002330008	6304552683	19625827775	24.31	75.68	100	100	25930380458	2019-05-27
2	2020-04-07	2330	台積電	TW0002330008	6283562246	19646818212	24.23	75.76	100	100	25930380458	2019-05-27
3	2020-04-08	2330	台積電	TW0002330008	6273338931	19657041527	24.19	75.8	100	100	25930380458	2019-05-27
4	2020-04-09	2330	台積電	TW0002330008	6267988722	19662391736	24.17	75.82	100	100	25930380458	2019-05-27

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    InternationalCode: str, # 國際股票邊碼
    ForeignInvestmentRemainingShares: int64, # 外資尚可投資股數
    ForeignInvestmentShares: int64, # 外資持有股數
    ForeignInvestmentRemainRatio: float64, # 外資尚可投資比例
    ForeignInvestmentSharesRatio: float64, # 外資持股比例
    ForeignInvestmentUpperLimitRatio: float64, # 外資投資上限
    ChineseInvestmentUpperLimitRatio: float64, # 陸資投資上限
    NumberOfSharesIssued: int64, # 發行股數
    RecentlyDeclareDate: str, # 最近一次異動申報日期
    note: str # 註
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_shareholding(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockShareholding",
    "start_date": "2020-04-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockShareholding",
        start_date= "2020-01-02"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	stock_name	InternationalCode	ForeignInvestmentRemainingShares	ForeignInvestmentShares	ForeignInvestmentRemainRatio	ForeignInvestmentSharesRatio	ForeignInvestmentUpperLimitRatio	ChineseInvestmentUpperLimitRatio	NumberOfSharesIssued	RecentlyDeclareDate	note
0	2020-04-01	0050	元大台灣50	TW0000050004	960256795	94743205	91.01	8.98	100	100	1055000000	2019-07-18
1	2020-04-01	0051	元大中型100	TW0000051002	9471000	29000	99.69	0.3	100	100	9500000	2019-07-18
2	2020-04-01	0052	富邦科技	TW0000052000	29957000	43000	99.85	0.14	100	100	30000000	2019-07-18
3	2020-04-01	0053	元大電子	TW0000053008	6466950	21050	99.67	0.32	100	100	6488000	2019-07-18
4	2020-04-01	0054	元大台商50	TW0000054006	9955000	169000	98.33	1.66	100	100	10124000	2019-07-18

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    InternationalCode: str, # 國際股票邊碼
    ForeignInvestmentRemainingShares: int64, # 外資尚可投資股數
    ForeignInvestmentShares: int64, # 外資持有股數
    ForeignInvestmentRemainRatio: float64, # 外資尚可投資比例
    ForeignInvestmentSharesRatio: float64, # 外資持股比例
    ForeignInvestmentUpperLimitRatio: float64, # 外資投資上限
    ChineseInvestmentUpperLimitRatio: float64, # 陸資投資上限
    NumberOfSharesIssued: int64, # 發行股數
    RecentlyDeclareDate: str, # 最近一次異動申報日期
    note: str # 註
}

---

股東持股分級表 TaiwanStockHoldingSharesPer(只限 backer、sponsor 會員使用)

• 資料區間：2010-01-29 ~ now

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_holding_shares_per(
    stock_id="2330",
    start_date='2020-04-01',
    end_date='2020-04-12'
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockHoldingSharesPer",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockHoldingSharesPer",
        data_id= "2330",
        start_date= "2020-01-02",
        end_date='2020-04-12'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_holding_shares_per(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	date	stock_id	HoldingSharesLevel	people	percent	unit
0	2020-04-01	2330	1-999	165122	0.12	33289900
1	2020-04-01	2330	1000-5000	227692	1.69	440404454
2	2020-04-01	2330	10001-15000	10408	0.49	128127693
3	2020-04-01	2330	100001-200000	1628	0.86	225202876
4	2020-04-01	2330	15001-20000	5068	0.34	89929303

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    HoldingSharesLevel: str, # 持股分級
    people: int64, # 人數
    percent: float64, # 比例
    unit: int64 # 股數
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_holding_shares_per(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockHoldingSharesPer",
    "start_date": "2020-04-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data)

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockHoldingSharesPer",
        start_date= "2020-04-01"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	HoldingSharesLevel	people	percent	unit
0	2020-04-01	0050	1-999	44173	1.02	10834763
1	2020-04-01	0050	1000-5000	96465	17.7	186791648
2	2020-04-01	0050	5001-10000	10364	7.57	79902735
3	2020-04-01	0050	10001-15000	2819	3.41	36075583
4	2020-04-01	0050	15001-20000	1557	2.69	28426726

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    HoldingSharesLevel: str, # 持股分級
    people: int64, # 人數
    percent: float64, # 比例
    unit: int64 # 股數
}

---

借券成交明細 TaiwanStockSecuritiesLending

• 資料區間：2001-05-01 ~ now
• 資料更新時間 星期一至五 15:00，實際更新時間以 API 資料為主

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_securities_lending(
    stock_id="2330",
    start_date='2020-04-01',
    end_date='2020-04-12'
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockSecuritiesLending",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
url = url,
    query = list(
        dataset="TaiwanStockSecuritiesLending",
        data_id="2330",
        start_date= "2020-01-02",
        end_date='2020-04-12'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_securities_lending(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	date	stock_id	transaction_type	volume	fee_rate	close	original_return_date	original_lending_period
0	2020-04-01	2330	議借	1330	1.36	271.5	2020-09-30	182
1	2020-04-01	2330	議借	800	0.41	271.5	2020-09-30	182
2	2020-04-01	2330	議借	850	0.41	271.5	2020-09-30	182
3	2020-04-01	2330	議借	500	0.5	271.5	2020-09-30	182
4	2020-04-01	2330	議借	160	0.36	271.5	2020-09-30	182

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    transaction_type: str, # 交易方式
    volume: int64, # 成交量
    fee_rate: float64, # 成交費率
    close: float64, # 收盤價
    original_return_date: str, # 約定還卷日期
    original_lending_period: int64 # 約定借券天數
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePythonR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_securities_lending(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockSecuritiesLending",
    "start_date": "2020-04-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data)

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockSecuritiesLending",
        start_date= "2020-01-02"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	transaction_type	volume	fee_rate	close	original_return_date	original_lending_period
0	2020-04-01	1101	議借	760	0.25	39	2020-09-30	182
1	2020-04-01	1101	議借	397	0.25	39	2020-09-30	182
2	2020-04-01	1101	競價	436	0.7	39	2020-09-30	182
3	2020-04-01	1102	議借	150	0.25	38.6	2020-09-30	182
4	2020-04-01	1102	議借	770	1.05	38.6	2020-09-30	182

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    transaction_type: str, # 交易方式
    volume: int64, # 成交量
    fee_rate: float64, # 成交費率
    close: float64, # 收盤價
    original_return_date: str, # 約定還卷日期
    original_lending_period: int64 # 約定借券天數
}

---

暫停融券賣出表(融券回補日) TaiwanStockMarginShortSaleSuspension

• 資料區間：2015-01-01 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

Python-requestRPackage-Async

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockMarginShortSaleSuspension",
    "data_id": "0050",
    "start_date": "2015-01-01",
    "end_date": "2015-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockMarginShortSaleSuspension",
        data_id="0050",
        start_date= "2015-01-01",
        end_date= "2015-04-12"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_stock_margin_short_sale_suspension(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	stock_id	date	end_date	reason
0	0050	2015-10-20	2015-10-23	分配收益
1	0050	2016-07-22	2016-07-27	分配收益
2	0050	2017-02-02	2017-02-07	分配收益
3	0050	2017-07-25	2017-07-28	分配收益
4	0050	2018-01-23	2018-01-26	分配收益

{
    stock_id: str, # 股票代碼
    date: str, # 開始日期
    end_date: str, # 結束日期
    reason: str # 停券原因
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

Python-requestR

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockMarginShortSaleSuspension",
    "start_date": "2015-10-20",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data)

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockMarginShortSaleSuspension",
        start_date= "2015-10-20"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	stock_id	date	end_date	reason
0	0050	2015-10-20	2015-10-23	分配收益
1	0056	2015-10-20	2015-10-23	分配收益

{
    stock_id: str, # 股票代碼
    date: str, # 開始日期
    end_date: str, # 結束日期
    reason: str # 停券原因
}

---

信用額度總量管制餘額表 TaiwanDailyShortSaleBalances

• 資料區間：2005-07-01 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_daily_short_sale_balances(
    stock_id="2330",
    start_date='2020-04-01',
    end_date='2020-04-12',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanDailyShortSaleBalances",
    "data_id": "2330",
    "start_date": "2020-04-01",
    "end_date": "2020-04-12",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
url = url,
    query = list(
        dataset="TaiwanDailyShortSaleBalances",
        data_id="2330",
        start_date= "2020-01-02",
        end_date='2020-04-12'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

start = datetime.datetime.now()
df = api.taiwan_daily_short_sale_balances(
    stock_id_list=['2330', '2317', '2454', '3008'],
    start_date='2024-01-01',
    end_date='2024-12-31',
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	stock_id	MarginShortSalesPreviousDayBalance	MarginShortSalesShortSales	MarginShortSalesShortCovering	MarginShortSalesStockRedemption	MarginShortSalesCurrentDayBalance	MarginShortSalesQuota	SBLShortSalesPreviousDayBalance	SBLShortSalesShortSales	SBLShortSalesReturns	SBLShortSalesAdjustments	SBLShortSalesCurrentDayBalance	SBLShortSalesQuota	SBLShortSalesShortCovering	date
0	2330	1975000	0	1573000	378000	24000	-2107339478	47947858	487000	0	0	48434858	7526895	0	2020-04-01
1	2330	24000	0	0	24000	0	-2107339478	48434858	44000	60000	0	48418858	7563083	0	2020-04-06
2	2330	0	0	0	0	0	-2107339478	48418858	62000	0	0	48480858	7635835	0	2020-04-07
3	2330	0	0	0	0	0	-2107339478	48480858	933000	7345000	0	42068858	7688249	0	2020-04-08
4	2330	0	398000	0	0	398000	-2107339478	42068858	46000	2000	0	42112858	7642682	0	2020-04-09

{
    stock_id: str, # 股票代碼
    MarginShortSalesPreviousDayBalance: int32, # 前日餘額(融券)
    MarginShortSalesShortSales: int32, # 賣出(融券)
    MarginShortSalesShortCovering: int32, # 買進(融券)
    MarginShortSalesStockRedemption: int32, # 現券(融券)
    MarginShortSalesCurrentDayBalance: int32, # 今日餘額(融券)
    MarginShortSalesQuota: int32, # 限額(融券)
    SBLShortSalesPreviousDayBalance: int32, # 前日餘額(借券賣出)
    SBLShortSalesShortSales: int32, # 賣出(借券賣出)
    SBLShortSalesReturns: int32, # 還券(借券賣出)
    SBLShortSalesAdjustments: int32, # 當日調整(借券賣出)
    SBLShortSalesCurrentDayBalance: int32, # 當日餘額(借券賣出)
    SBLShortSalesQuota: int32, # 限額(借券賣出)
    SBLShortSalesShortCovering: int32, # 庫存異動(借券賣出)
    date: str # 日期
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_daily_short_sale_balances(
    start_date='2020-04-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanDailyShortSaleBalances",
    "start_date": "2021-05-20",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data)

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
url = url,
    query = list(
        dataset="TaiwanDailyShortSaleBalances",
        start_date= "2020-01-02"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	stock_id	MarginShortSalesPreviousDayBalance	MarginShortSalesShortSales	MarginShortSalesShortCovering	MarginShortSalesStockRedemption	MarginShortSalesCurrentDayBalance	MarginShortSalesQuota	SBLShortSalesPreviousDayBalance	SBLShortSalesShortSales	SBLShortSalesReturns	SBLShortSalesAdjustments	SBLShortSalesCurrentDayBalance	SBLShortSalesQuota	SBLShortSalesShortCovering	date
0	0050	2336000	13000	65000	1000	2283000	263750000	25527000	0	0	0	25527000	2397551	0	2020-04-01
1	0051	0	0	0	0	0	2375000	1000	0	0	0	1000	4053	0	2020-04-01
2	0052	0	0	0	0	0	7500000	34000	0	0	0	34000	17168	0	2020-04-01
3	0053	0	0	0	0	0	1622000	0	0	0	0	0	3158	0	2020-04-01
4	0054	0	0	0	0	0	2531000	0	0	0	0	0	1357	0	2020-04-01

{
    stock_id: str, # 股票代碼
    MarginShortSalesPreviousDayBalance: int32, # 前日餘額(融券)
    MarginShortSalesShortSales: int32, # 賣出(融券)
    MarginShortSalesShortCovering: int32, # 買進(融券)
    MarginShortSalesStockRedemption: int32, # 現券(融券)
    MarginShortSalesCurrentDayBalance: int32, # 今日餘額(融券)
    MarginShortSalesQuota: int32, # 限額(融券)
    SBLShortSalesPreviousDayBalance: int32, # 前日餘額(借券賣出)
    SBLShortSalesShortSales: int32, # 賣出(借券賣出)
    SBLShortSalesReturns: int32, # 還券(借券賣出)
    SBLShortSalesAdjustments: int32, # 當日調整(借券賣出)
    SBLShortSalesCurrentDayBalance: int32, # 當日餘額(借券賣出)
    SBLShortSalesQuota: int32, # 限額(借券賣出)
    SBLShortSalesShortCovering: int32, # 庫存異動(借券賣出)
    date: str # 日期
}

---

證券商資訊表 TaiwanSecuritiesTraderInfo

• 提供證券商相關資訊，用於台股分點資料表(TaiwanStockTradingDailyReport )，使用卷商代碼，查詢特定卷商所有股票進出。

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_securities_trader_info()

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanSecuritiesTraderInfo",
}
resp = requests.get(url, headers=headers, params=parameter)
data = resp.json()
data = pd.DataFrame(data["data"])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset = "TaiwanSecuritiesTraderInfo"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	securities_trader_id	securities_trader	date	address	phone
0	1020	合庫	2011-12-02	台北市大安區忠孝東路四段325號2樓(部分)、經紀部複委託科地址：台北市松山區長安東路二段225號5樓	02-27528000
1	1021	合庫- 台中	2011-12-02	台中市西區民權路91號6樓	04-22255141
2	1022	合庫-台南	2011-12-02	台南市北區成功路48號3樓	06-2260148
3	1023	合庫-高雄	2011-12-02	高雄市大勇路97號5樓	07-5319755
4	1024	合庫-嘉義	2011-12-02	嘉義市國華街279號2樓	05-2220016

{
    securities_trader_id: str, # 券商代碼
    securities_trader: str, # 券商名稱
    date: str, # 開業日
    address: str, # 地址
    phone: str # 電話
}

---

台股分點資料表(query by 股票代碼) TaiwanStockTradingDailyReport (只限 sponsor 會員使用)

• 提供台股，上市、上櫃、興櫃，的分點資訊！
• 資料區間：2021-06-30 ~ now
• 由於資料量過大，單次請求只提供一天資料
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主
• 部分資料缺失，缺失日期為：2022-10-31~2022-11-03, 2023-01-11~2023-01-17
• 開啟 Async 功能，可大幅縮短資料更新時間，colab 實測 2175 檔股票，只需 4 分 20 秒即可完成下載。

Example

PackagePackage-AsyncPython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_trading_daily_report(
    stock_id="2330",
    date='2022-06-16',
)
print(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

token = ""

data_loader = DataLoader()
data_loader.login_by_token(token)

date = "2025-12-08"
start = datetime.datetime.now()
df = data_loader.taiwan_stock_trading_daily_report(
    date=date,
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)
# 0:04:20

import requests
import pandas as pd

url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report'
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "data_id": "2330",
    "date": "2022-06-16",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
token = "" # 參考登入，獲取金鑰
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report'
response = httr::GET(
    url = url,
    query = list(
        data_id="2330",
        start_date= "2022-06-16",
        token = token # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	securities_trader	price	buy	sell	securities_trader_id	stock_id	date
0	合庫	508	4000	2000	1020	2330	2022-06-16
1	合庫	509	3480	0	1020	2330	2022-06-16
2	合庫	510	2310	50	1020	2330	2022-06-16
3	合庫	511	1169	0	1020	2330	2022-06-16
4	合庫	512	1300	10000	1020	2330	2022-06-16

{
    securities_trader: str, # 券商名稱
    price: float64, # 成交價
    buy: int32, # 買進股數
    sell: int32, # 賣出股數
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str # 日期
}

---

台股分點資料表(query by 券商代碼) TaiwanStockTradingDailyReport (只限 sponsor 會員使用)

• 提供台股，上市、上櫃、興櫃，的分點資訊！
• 資料區間：2021-06-30 ~ now
• 由於資料量過大，單次請求只提供一天資料
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主
• 部分資料缺失，缺失日期為：2022-10-31~2022-11-03, 2023-01-11~2023-01-17

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_trading_daily_report(
    securities_trader_id="1102",
    date='2022-06-16',
)
print(df)

import requests
import pandas as pd

token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report'
parameter = {
    "securities_trader_id": "1020",
    "date": "2022-06-16",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
token = "" # 參考登入，獲取金鑰
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report'
response = httr::GET(
    url = url,
    query = list(
        securities_trader_id="1020",
        start_date= "2022-06-16",
        token = token # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	securities_trader	price	buy	sell	securities_trader_id	stock_id	date
0	合庫	122.25	19000	0	1020	0050	2022-06-16
1	合庫	122.3	80000	0	1020	0050	2022-06-16
2	合庫	122.35	10000	0	1020	0050	2022-06-16
3	合庫	122.5	1300	0	1020	0050	2022-06-16
4	合庫	122.55	20000	0	1020	0050	2022-06-16
...	...	...	...	...	...	...	...
3211	合庫	107	1000	50000	1020	9958	2022-06-16
3212	合庫	107.5	0	32000	1020	9958	2022-06-16
3213	合庫	108	0	2000	1020	9958	2022-06-16
3214	合庫	108.5	150	0	1020	9958	2022-06-16
3215	合庫	16.05	1000	0	1020	9962	2022-06-16

{
    securities_trader: str, # 券商名稱
    price: float64, # 成交價
    buy: int32, # 買進股數
    sell: int32, # 賣出股數
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str # 日期
}

一次拿特定日期，所有資料 (只限 sponsorpro 會員使用)

(由於資料量過大，單次請求只提供一天資料)

• 資料區間：2021-06-30 ~ now
• 輸入 dataset、date 參數，會回傳 date 當天所有股票的分點資料
• 透過 signed URL 下載整日 parquet，免逐檔查詢，適合需要全市場分點的批次分析
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主
• 部分資料缺失，缺失日期為：2022-10-31~2022-11-03, 2023-01-11~2023-01-17

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_trading_daily_report(
    date='2022-06-16',
    use_object=True,
)

import io
import requests
import pandas as pd

url = "https://api.finmindtrade.com/api/v4/storage_objects"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockTradingDailyReport",
    "date": "2022-06-16",
}
resp = requests.get(url, headers=headers, params=parameter)
data = pd.read_parquet(io.BytesIO(resp.content))
print(data.head())

library(httr)
library(data.table)
library(dplyr)
library(arrow)

url = 'https://api.finmindtrade.com/api/v4/storage_objects'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockTradingDailyReport",
        date= "2022-06-16"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
con = content(response, "raw")
data <- read_parquet(con)
close(con)
head(data)

Output

DataFrameSchema

	securities_trader	price	buy	sell	securities_trader_id	stock_id	date
0	合庫	508	4000	2000	1020	2330	2022-06-16
1	合庫	509	3480	0	1020	2330	2022-06-16
2	合庫	510	2310	50	1020	2330	2022-06-16
3	合庫	511	1169	0	1020	2330	2022-06-16
4	合庫	512	1300	10000	1020	2330	2022-06-16

{
    securities_trader: str, # 券商名稱
    price: float64, # 成交價
    buy: int32, # 買進股數
    sell: int32, # 賣出股數
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str # 日期
}

---

台股權證分點資料表(query by 股票代碼) TaiwanStockWarrantTradingDailyReport (只限 sponsor 會員使用)

• 資料區間：2023-06-21 ~ now
• 由於資料量過大，單次請求只提供一天資料
• 資料更新時間 星期一至五 01:00，實際更新時間以 API 資料為主

Example

PackagePython-requestRPackage-Async

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_warrant_trading_daily_report(
    stock_id="084655",
    date='2023-06-21',
)
print(df)

import requests
import pandas as pd

token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_warrant_trading_daily_report'
parameter = {
    "data_id": "084655",
    "date": "2023-06-21",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_warrant_trading_daily_report'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        data_id="084655",
        start_date= "2023-06-21",
        token = token # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

from FinMind.data import DataLoader
from loguru import logger
import datetime

api = DataLoader()
api.login_by_token(api_token='token')

date = '2025-12-08'
start = datetime.datetime.now()
df = api.taiwan_stock_warrant_trading_daily_report(
    date=date,
    use_async=True,
)
cost = datetime.datetime.now() - start
logger.info(cost)

Output

DataFrameSchema

	securities_trader	price	buy	sell	securities_trader_id	stock_id	date
0	元富	2.48	0	4000	5920	084655	2023-06-21
1	凱基	2.48	4000	0	9200	084655	2023-06-21

{
    securities_trader: str, # 券商名稱
    price: float64, # 成交價
    buy: int32, # 買進股數
    sell: int32, # 賣出股數
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str # 日期
}

---

台股權證分點資料表(query by 券商代碼) TaiwanStockWarrantTradingDailyReport (只限 sponsor 會員使用)

• 資料區間：2023-06-21 ~ now
• 由於資料量過大，單次請求只提供一天資料)
• 資料更新時間 星期一至五 23:00，實際更新時間以 API 資料為主

Example

Python-requestR

import requests
import pandas as pd

url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_warrant_trading_daily_report'
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "securities_trader_id": "5920",
    "date": "2023-06-21",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_warrant_trading_daily_report'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        securities_trader_id="5920",
        start_date= "2023-06-21",
        token = token # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	securities_trader	price	buy	sell	securities_trader_id	stock_id	date
0	元富	0.97	50000	0	5920	07741U	2023-06-21
1	元富	0.98	50000	0	5920	07741U	2023-06-21
2	元富	1.52	100000	0	5920	07742U	2023-06-21
3	元富	1.56	49000	0	5920	07742U	2023-06-21

{
    securities_trader: str, # 券商名稱
    price: float64, # 成交價
    buy: int32, # 買進股數
    sell: int32, # 賣出股數
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str # 日期
}

---

台股八大行庫買賣表 TaiwanStockGovernmentBankBuySell (只限 sponsor 會員使用)

• 資料區間：2021-06-30 ~ now
• 由於資料量過大，單次請求只提供一天資料
• 資料更新時間 星期一至五 23:30，實際更新時間以 API 資料為主

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_government_bank_buy_sell(
    start_date='2023-01-17',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockGovernmentBankBuySell",
    "start_date": "2023-01-17",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockGovernmentBankBuySell",
        start_date= "2023-01-17"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	buy_amount	sell_amount	buy	sell	bank_name
0	2023-01-17	0050	43992298.6	53309904.25	372595	451744	兆豐
1	2023-01-17	5202	288.0	303.50	20	20	第一
2	2023-01-17	5202	0.0	59.45	0	4	華南
3	2023-01-17	5203	82800.0	0.00	1000	0	兆豐
4	2023-01-17	5203	249000.0	583600.00	3000	7000	臺銀

{
    date: str, # 日期
    stock_id: str, # 股票代碼
    buy_amount: float64, # 買進金額
    sell_amount: float64, # 買出金額
    buy: int64, # 買進股數
    sell: int64, # 賣出股數
    bank_name: str # 銀行名稱
}

台灣大盤融資維持率 TaiwanTotalExchangeMarginMaintenance (只限 backer、sponsor 會員使用)

• 資料區間：2001-01-05 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_total_exchange_margin_maintenance(
    start_date='2024-04-01',
    end_date='2024-05-01'
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanTotalExchangeMarginMaintenance",
    "start_date": "2020-04-01",
    "end_date": "2020-05-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanTotalExchangeMarginMaintenance",
        start_date= "2024-04-01",
        end_date='2024-05-01'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	TotalExchangeMarginMaintenance
0	2024-04-01	166.007
1	2024-04-02	167.079
2	2024-04-03	167.085
3	2024-04-08	167.119
4	2024-04-09	167.095

{
    date: str, # 日期
    TotalExchangeMarginMaintenance: float64 # 大盤融資維持率
}

當日卷商分點統計表 TaiwanStockTradingDailyReportSecIdAgg (只限 sponsor 會員使用)

• 提供台股，上市、上櫃、興櫃，的分點資訊！
• 資料區間：2021-06-30 ~ now
• 資料更新時間 星期一至五 21:00，實際更新時間以 API 資料為主

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_trading_daily_report_secid_agg(
    stock_id="2330",
    securities_trader_id="1020",
    start_date= "2024-07-01",
    end_date="2024-07-15",
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report_secid_agg"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "data_id": "2330",
    "securities_trader_id": "1020",
    "start_date": "2024-07-01",
    "end_date": '2024-07-15',
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/taiwan_stock_trading_daily_report_secid_agg'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        data_id="2330",
        securities_trader_id="1020",
        start_date= "2024-07-01",
        end_date='2024-07-15'
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	securities_trader	securities_trader_id	stock_id	date	buy_volume	sell_volume	buy_price	sell_price
0	合庫	1020	2330	2024-07-01	12157	12460	968.08	973.84
0	合庫	1020	2330	2024-07-02	12735	21885	964.54	964.63
0	合庫	1020	2330	2024-07-03	10535	29381	973.16	974.69
0	合庫	1020	2330	2024-07-04	28107	59459	1001.99	1000.88
0	合庫	1020	2330	2024-07-05	10435	11075	1004.18	1004.5

{
    securities_trader: str, # 券商名稱
    securities_trader_id: str, # 券商代碼
    stock_id: str, # 股票代碼
    date: str, # 日期
    buy_volume: int64, # 買進總股數
    sell_volume: int64, # 賣出總股數
    buy_price: float, # 買進均價
    sell_price: float, # 賣出均價
}

鉅額交易買賣日報表 TaiwanStockBlockTradingDailyReport (只限 sponsor 會員使用)

• 資料區間：2026-04-28 ~ now
• 只需輸入日期，不需股票代碼

Example

PythonR

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
parameter = {
    "dataset": "TaiwanStockBlockTradingDailyReport",
    "start_date": "2026-04-28",
    "token": token,
}
resp = requests.get(url, params=parameter)
data = resp.json()
data = pd.DataFrame(data["data"])
print(data.head())

library(httr)
library(data.table)
url = "https://api.finmindtrade.com/api/v4/data"
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockBlockTradingDailyReport",
        start_date="2026-04-28",
        token=""
    )
)
data = content(response)
df = do.call('rbind', lapply(data$data, as.data.frame))
head(df)

Output

Schema

{
    securities_trader: str, # 券商
    price: float, # 價格
    buy: int, # 買進股數
    sell: int, # 賣出股數
    trade_type: str, # 交易種類 (配對/轉換等)
    securities_trader_id: str, # 券商代號
    stock_id: str, # 股票代號
    date: str, # 日期
}

鉅額交易日成交資訊 TaiwanStockBlockTrade (只限 sponsor 會員使用)

• 資料區間：2005-04-04 ~ now
• 涵蓋上市櫃股票鉅額交易（逐筆）

Example

PackagePythonR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_block_trade(
    stock_id="2330",
    start_date="2026-04-01",
    end_date="2026-04-30",
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockBlockTrade",
    "data_id": "2330",
    "start_date": "2026-04-01",
    "end_date": "2026-04-30",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data["data"])
print(data.head())

library(httr)
library(data.table)
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockBlockTrade",
        data_id="2330",
        start_date="2026-04-01",
        end_date="2026-04-30",
        token=token
    )
)
data = content(response)
df = do.call("rbind", lapply(data$data, as.data.frame))
head(df)

Output

DataFrameSchema

	date	stock_id	trade_type	price	volume	trading_money
0	2026-04-01	2330	配對交易	1871.29	25000	46782250
1	2026-04-01	2330	配對交易	1871.28	25000	46782000
2	2026-04-01	2330	配對交易	1865.28	15000	27979200
3	2026-04-01	2330	配對交易	1855	1078000	1999690000
4	2026-04-01	2330	配對交易	1849.42	137104	253562880

{
    date: str, # 日期
    stock_id: str, # 股票代號
    trade_type: str, # 交易別 (配對交易等)
    price: float, # 成交價
    volume: int, # 成交股數
    trading_money: int, # 成交金額
}

借貸款項擔保品餘額表 TaiwanStockLoanCollateralBalance (只限 sponsor 會員使用)

• 資料區間：2006-10-02 ~ now
• 資料更新時間 星期一至五 盤後，實際更新時間以 API 資料為主
• 包含上市(櫃)股票之融資、證券商證券業務借貸款項、證券商不限用途款項借貸、證金擔保放款、證金交割融資的擔保品餘額（仟股）

Example

PackagePythonR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_loan_collateral_balance(
    stock_id="2330",
    start_date="2026-04-01",
    end_date="2026-04-30",
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockLoanCollateralBalance",
    "data_id": "2330",
    "start_date": "2026-04-01",
    "end_date": "2026-04-30",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data["data"])
print(data.head())

library(httr)
library(data.table)
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockLoanCollateralBalance",
        data_id="2330",
        start_date="2026-04-01",
        end_date="2026-04-30",
        token=token
    )
)
data = content(response)
df = do.call("rbind", lapply(data$data, as.data.frame))
head(df)

Output

DataFrameSchema

	date	stock_id	market	MarginPreviousDayBalance	MarginBuy	MarginSell	MarginCashRedemption	MarginCurrentDayBalance	MarginNextDayQuota	SecuritiesFirmLoanPreviousDayBalance	SecuritiesFirmLoanBuy	SecuritiesFirmLoanSell	SecuritiesFirmLoanCashRedemption	SecuritiesFirmLoanReplacement	SecuritiesFirmLoanCurrentDayBalance	SecuritiesFirmLoanNextDayQuota	UnrestrictedLoanPreviousDayBalance	UnrestrictedLoanBuy	UnrestrictedLoanSell	UnrestrictedLoanCashRedemption	UnrestrictedLoanReplacement	UnrestrictedLoanCurrentDayBalance	UnrestrictedLoanNextDayQuota	SecuritiesFinanceSecuredLoanPreviousDayBalance	SecuritiesFinanceSecuredLoanBuy	SecuritiesFinanceSecuredLoanSell	SecuritiesFinanceSecuredLoanCashRedemption	SecuritiesFinanceSecuredLoanReplacement	SecuritiesFinanceSecuredLoanCurrentDayBalance	SecuritiesFinanceSecuredLoanNextDayQuota	SettlementMarginPreviousDayBalance	SettlementMarginBuy	SettlementMarginSell	SettlementMarginCashRedemption	SettlementMarginReplacement	SettlementMarginCurrentDayBalance	SettlementMarginNextDayQuota
0	2026-04-01	2330	集中市場	26608	1268	1485	38	26353	6483131	21	0	0	0	0	21	1296626	119953	851	142	46	215	120401	2593252	16700	111	11	30	6	16764	0	0	0	0	0	0	0	1296626
1	2026-04-02	2330	集中市場	26353	1312	873	194	26598	6483131	21	0	0	0	0	21	1296626	120401	621	139	70	416	120397	2593252	16764	134	6	19	18	16855	0	0	0	0	0	0	0	1296626
2	2026-04-07	2330	集中市場	26598	391	970	19	26000	6483131	21	0	0	0	0	21	1296626	120397	539	54	36	236	120610	2593252	16855	160	2	67	29	16917	0	0	0	0	0	0	0	1296626
3	2026-04-08	2330	集中市場	26000	2882	2057	28	26797	6483131	21	65	0	0	0	86	1296626	120616	776	75	134	222	120961	2593252	16917	88	21	28	9	16947	0	0	0	0	0	0	0	1296626
4	2026-04-09	2330	集中市場	26604	998	953	13	26636	6483131	86	0	65	0	0	21	1296626	120961	481	19	83	198	121142	2593252	16947	126	1	27	13	17032	0	0	0	0	0	0	0	1296626

{
    date: str, # 日期
    stock_id: str, # 股票代號
    market: str, # 市場別 (集中市場/櫃檯買賣中心)
    MarginPreviousDayBalance: int, # 融資-前日餘額
    MarginBuy: int, # 融資-買進
    MarginSell: int, # 融資-賣出
    MarginCashRedemption: int, # 融資-現償
    MarginCurrentDayBalance: int, # 融資-今日餘額
    MarginNextDayQuota: int, # 融資-次一營業日限額
    SecuritiesFirmLoanPreviousDayBalance: int, # 證券商證券業務借貸款項-前日餘額
    SecuritiesFirmLoanBuy: int, # 證券商證券業務借貸款項-買進
    SecuritiesFirmLoanSell: int, # 證券商證券業務借貸款項-賣出
    SecuritiesFirmLoanCashRedemption: int, # 證券商證券業務借貸款項-現償
    SecuritiesFirmLoanReplacement: int, # 證券商證券業務借貸款項-更換
    SecuritiesFirmLoanCurrentDayBalance: int, # 證券商證券業務借貸款項-今日餘額
    SecuritiesFirmLoanNextDayQuota: int, # 證券商證券業務借貸款項-次一營業日限額
    UnrestrictedLoanPreviousDayBalance: int, # 證券商不限用途款項借貸-前日餘額
    UnrestrictedLoanBuy: int, # 證券商不限用途款項借貸-買進
    UnrestrictedLoanSell: int, # 證券商不限用途款項借貸-賣出
    UnrestrictedLoanCashRedemption: int, # 證券商不限用途款項借貸-現償
    UnrestrictedLoanReplacement: int, # 證券商不限用途款項借貸-更換
    UnrestrictedLoanCurrentDayBalance: int, # 證券商不限用途款項借貸-今日餘額
    UnrestrictedLoanNextDayQuota: int, # 證券商不限用途款項借貸-次一營業日限額
    SecuritiesFinanceSecuredLoanPreviousDayBalance: int, # 證金擔保放款-前日餘額
    SecuritiesFinanceSecuredLoanBuy: int, # 證金擔保放款-買進
    SecuritiesFinanceSecuredLoanSell: int, # 證金擔保放款-賣出
    SecuritiesFinanceSecuredLoanCashRedemption: int, # 證金擔保放款-現償
    SecuritiesFinanceSecuredLoanReplacement: int, # 證金擔保放款-更換
    SecuritiesFinanceSecuredLoanCurrentDayBalance: int, # 證金擔保放款-今日餘額
    SecuritiesFinanceSecuredLoanNextDayQuota: int, # 證金擔保放款-次一營業日限額
    SettlementMarginPreviousDayBalance: int, # 證金交割融資-前日餘額
    SettlementMarginBuy: int, # 證金交割融資-買進
    SettlementMarginSell: int, # 證金交割融資-賣出
    SettlementMarginCashRedemption: int, # 證金交割融資-現償
    SettlementMarginReplacement: int, # 證金交割融資-更換
    SettlementMarginCurrentDayBalance: int, # 證金交割融資-今日餘額
    SettlementMarginNextDayQuota: int, # 證金交割融資-次一營業日限額
}

公布處置有價證券表 TaiwanStockDispositionSecuritiesPeriod (只限 backer、sponsor 會員使用)

• 資料區間：2001-01-01 ~ now
• 資料包含上市、上櫃、興櫃
• 資料更新時間 星期一至六 20:00~23:00，實際更新時間以 API 資料為主

Example

PackagePythonR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_disposition_securities_period(
    stock_id="6477",
    start_date='2025-01-01',
    end_date='2025-02-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockDispositionSecuritiesPeriod",
    "data_id": "6477",
    "start_date": "2025-01-01",
    "end_date": "2025-02-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockDispositionSecuritiesPeriod",
        data_id= "6477",
        start_date= "2025-01-01",
        end_date= "2025-02-01"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table

Output

DataFrameSchema

	date	stock_id	stock_name	disposition_cnt	condition	measure	period_start	period_end
0	2025-01-09	6477	安集	1	連續三次及當日沖銷標準	第一次處置	2025-01-10	2025-02-05

{
    date: str, # 公布日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    disposition_cnt: int32, # 累計次數
    condition: str, # 處置條件
    measure: str, # 處置內容
    period_start: str, # 處置開始日期
    period_end: str, # 處置結束日期
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_disposition_securities_period(
    start_date='2025-01-09',
    end_date: "2025-01-09",
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockDispositionSecuritiesPeriod",
    "start_date": "2025-01-09",
    "end_date": "2025-01-09",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockDispositionSecuritiesPeriod",
        start_date= "2025-01-09",
        end_date: "2025-01-09",
        token = "" # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	stock_name	disposition_cnt	condition	measure	period_start	period_end
0	2025-01-09	6477	安集	1	連續三次及當日沖銷標準	第一次處置	2025-01-10	2025-02-05
1	2025-01-09	9103	美德醫療-DR	1	最近十個營業日已有六次	第二次處置	2025-01-10	2025-02-03

{
    date: str, # 公布日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    disposition_cnt: int32, # 累計次數
    condition: str, # 處置條件
    measure: str, # 處置內容
    period_start: str, # 處置開始日期
    period_end: str, # 處置結束日期
}

---

現股當日沖銷券差借券費率 TaiwanStockDayTradingBorrowingFeeRate (只限 backer、sponsor 會員使用)

• 資料區間：2015-06-01 ~ now
• 資料更新時間 星期一至五 19:00~22:00，實際更新時間以 API 資料為主

Example

PackagePythonR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_day_trading_borrowing_fee_rate(
    stock_id="2330",
    start_date='2024-12-01',
    end_date='2025-01-01',
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockDayTradingBorrowingFeeRate",
    "data_id": "2330",
    "start_date": "2024-12-01",
    "end_date": "2025-01-01",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockDayTradingBorrowingFeeRate",
        data_id= "2330",
        start_date= "2024-12-01",
        end_date= "2025-01-01"
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table

Output

DataFrameSchema

	date	stock_id	stock_name	InvestorBorrowedShares	InvestorBorrowingFeeRate
0	2024-12-02	6477	安集	15000	7

{
    date: str, # 公布日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    InvestorBorrowedShares: int32, # 借券股數
    InvestorBorrowingFeeRate: float64, # 借券費率
}

一次拿特定日期，所有資料(只限 backer、sponsor 會員使用)

Example

PackagePython-requestR

from FinMind.data import DataLoader

api = DataLoader()
# api.login_by_token(api_token='token')
df = api.taiwan_stock_disposition_securities_period(
    start_date='2024-12-02',
    end_date: "2024-12-02",
)

import requests
import pandas as pd
url = "https://api.finmindtrade.com/api/v4/data"
token = "" # 參考登入，獲取金鑰
headers = {"Authorization": f"Bearer {token}"}
parameter = {
    "dataset": "TaiwanStockDayTradingBorrowingFeeRate",
    "start_date": "2024-12-02",
    "end_date": "2024-12-02",
}
data = requests.get(url, headers=headers, params=parameter)
data = data.json()
data = pd.DataFrame(data['data'])
print(data.head())

library(httr)
library(data.table)
library(dplyr)
url = 'https://api.finmindtrade.com/api/v4/data'
token = "" # 參考登入，獲取金鑰
response = httr::GET(
    url = url,
    query = list(
        dataset="TaiwanStockDayTradingBorrowingFeeRate",
        start_date= "2024-12-02",
        end_date: "2024-12-02",
        token = "" # 參考登入，獲取金鑰
    ),
    add_headers(Authorization = paste("Bearer", token))
)
data = content(response)
df = data$data %>%
do.call('rbind',.) %>%
data.table
head(df)

Output

DataFrameSchema

	date	stock_id	stock_name	InvestorBorrowedShares	InvestorBorrowingFeeRate
0	2024-12-02	00631L	元大台灣50正2	5000	1
1	2024-12-02	1438	三地開發	1	3
2	2024-12-02	2312	金寶	1000	2
3	2024-12-02	2324	仁寶	1000	0.1
4	2024-12-02	2330	台積電	15000	7

{
    date: str, # 公布日期
    stock_id: str, # 股票代碼
    stock_name: str, # 股票名稱
    InvestorBorrowedShares: int32, # 借券股數
    InvestorBorrowingFeeRate: float64, # 借券費率
}

---