用途:面向港股市场的自包含金融数据工具包,提供实时行情与定量计算,所有数据源免费且无需API密钥。
主要能力:脚本位于 scripts/ 目录,从技能根目录运行。hk_stock_data.py 获取个股基本信息、实时价格与历史数据、财务指标与估值、股息历史;southbound_flow.py 获取每日南向资金流向、持仓明细、行业资金流向、净买入卖出TOP榜;hk_financials.py 获取损益表、资产负债表、现金流量表、财务比率;fx_data.py 获取港币即期、远期、历史汇率与波动率;hk_macro.py 获取GDP、CPI、失业率、利率;hk_etf.py 获取ETF列表、持仓、资金流向与表现。
使用方式:先执行 pip install -r requirements.txt 安装依赖。示例:python scripts/hk_stock_data.py 00700 --price;python scripts/southbound_flow.py --daily;python scripts/hk_financials.py 00700 --income;python scripts/fx_data.py HKD --spot;python scripts/hk_macro.py --gdp;python scripts/hk_etf.py --list。也可在代码中导入函数,如 from scripts.hk_stock_data import get_stock_info。输出为JSON格式,含symbol、price、market_cap等字段。可选设置 HTTP_PROXY、HTTPS_PROXY、HK_DATA_CACHE 环境变量及缓存配置。
适用场景:需要港股实时行情、财务、资金流向、汇率与宏观数据支撑投资分析时。
限制:实时数据可能有轻微延迟;港股交易时间为9:30-12:00、13:00-16:00;价格以港币(HKD)为单位;股票代码为5位数字;部分数据源可能有访问限制,建议交叉验证重要数据并避免频繁请求。