HKFDB 說明文檔
Python Financial Data Package
價格數據
-
get_hk_stock_ohlc
- intraday港股數據 -
get_hk_fut_ohlc
- intraday + end of day香港期貨數據 -
get_hk_deri_daily_market_report
- end of day香港衍生工具數據 -
get_hk_cbbc
- 牛熊證數據 -
(beta) get_us_stock_ohlc
- intraday美股數據
get_hk_stock_ohlc
簡介︰intraday港股數據
1分鐘、5分鐘、15分鐘、30分鐘 及 1日OHLC (Open High Low Close) 及成交數據
日期範圍︰2012年1月 至今
更新時間︰逢交易日後上午4時
所需參數
返回格式︰DataFrame
DataFrame內容格式︰
例子︰
df = client.get_hk_stock_ohlc('00700', 20220103, 20220131, '15T')
注意事項︰
1T數據量較大，如需取得一年以上1T數據，等待時間可能超過一分鐘
所有成交量(volume) 只包括正常對盤，不包括競價盤、交叉盤等特殊對盤
get_hk_fut_ohlc
簡介︰intraday + end of day香港期貨數據
1分鐘、5分鐘、15分鐘、1日 OHLC (Open High Low Close) 及成交數據
日期範圍︰2013年5月 至今
更新時間︰逢交易日後上午12時
所需參數
返回格式︰DataFrame
DataFrame內容格式︰
例子︰
df = client.get_hk_fut_ohlc('HSI', 20220715, 20220915, '1D', 1, 150000)
注意事項︰
此數據為連續期貨 (continuous futures)
rolling_day為假設轉倉日子，rolling_time為假設轉倉時間，
例如該月結算日期為2021年11月29日 (星期一)， rolling_day設定3，rolling_time設定153000
則假設轉倉日期時間為11月29日前3個交易日 (不包括星期六)，即11月24日 下午3點30分
例子︰
df = client.get_hk_fut_ohlc('HSI', 20220715, 20220915, '15T', 1, 150000, rth_only= True)
如freq設定為1D，則rolling_time無效，可輸入任何數字都不影響結果
如freq設定為1D，RTH欄不會顯示，但具體數據仍會根據rth_only而顯示，例如rth_only為True，每天的OHLC價格就會包含夜期數據，留意夜期數據實際日期會橫跨兩日，datetime和date的日期為開市日期
roll_diff為轉倉利潤 (或虧損)，假設倉位是長倉，由即月期貨轉倉到下月期貨之間的價差
get_hk_deri_daily_market_report
簡介︰交易所衍生工具每日市場報告 (daily market report)
包含OHLC、引申波幅、成交量、未平倉合約等數據
日期範圍︰2014年2月 至今
更新時間︰逢交易晚上11時
所需參數
期貨及期權參數組合一覽
期權數據
返回格式︰DataFrame
DataFrame內容格式︰
期權數據例子︰
df = client.get_hk_deri_daily_market_report('opt', 'hsio', 20220131, 20220214)
注意事項︰
期權數據量較大，建議每次最多存取半年數據，如需多於半年數據，可分批存取
期貨數據
返回格式︰DataFrame
DataFrame內容格式︰
例子︰
df = client.get_hk_deri_daily_market_report('fut', '00700' ,20210115, 20220127, 'current')
注意事項︰
此數據為連續期貨 (continuous futures)
get_hk_cbbc
簡介︰牛熊證數據
包含發行商買入賣出數據、發行數據、打靶位、兌換比率等
日期範圍︰2014年1月 至今
更新時間︰逢交易日隔晚4時
所需參數
返回格式︰DataFrame
DataFrame內容格式︰
例子︰
df = client.get_hk_cbbc('HSI' ,20220101, 20221231)
注意事項︰
請盡量分開每次取最多一年數據
(beta) get_us_stock_ohlc
簡介︰intraday美股數據
提供1分鐘resolution，時間為美國中部時間 (CST)
日期範圍︰2010年1月 至今
更新時間︰逢交易日後香港時間上午7時
所需參數
返回格式︰DataFrame
DataFrame內容格式︰
例子︰
df = client.get_us_stock_ohlc('AAPL', 20220120, 20220128)
注意事項︰
此數據仍然處於測試階段，僅供參考