核心用法
tfin 是一个基于腾讯财经 API 的命令行工具，专为获取实时股票数据设计。支持三种核心操作模式：
- 快速价格查询：
tfin AAPL或tfin price AAPL，即时返回当前价格与涨跌信息 - 详细行情：
tfin quote MSFT，输出包含开盘价、最高价、最低价、成交量、市值、市盈率等完整数据 - 多股对比：
tfin compare AAPL,MSFT,GOOGL，横向比较多只股票的关键指标
此外内置搜索功能 tfin search "关键词" 辅助查找股票代码。
市场覆盖与代码格式
| 市场 | 代码示例 | 说明 |
|------|---------|------|
| 美股 | AAPL, TSLA, NVDA | 直接输入代码 |
| A股 | sh000001, sz399001 | 前缀 sh（上海）/sz（深圳）+ 代码 |
| 港股 | hk00700, hk09988 | 前缀 hk + 代码 |
| 加密货币 | BTC-USD, ETH-USD | 标准交易对格式 |
显著优点
1. 中国大陆网络零障碍：相比 Yahoo Finance API 经常在大陆被屏蔽或限速，腾讯 API 可直接访问，稳定性显著优于国际数据源
2. 零配置成本：无需注册账号、申请 API Key，即装即用，降低使用门槛
3. 多市场一体化：单一工具同时覆盖美股、A股、港股，适合跨市场投资者
4. 轻量快速：依赖仅 requests 和 rich 两个库，启动快，响应及时
潜在缺点与局限性
- 市场覆盖缺口：不支持印度股市（NSE/BSE）、日本、欧洲等主要国际市场
- 功能边界明确：不提供期权链、股息历史、财务深度数据等专业功能，定位为轻量行情工具而非投研平台
- 数据权威性：依赖腾讯财经数据源，非交易所直连，极端行情下可能存在秒级延迟
- 无历史数据：专注实时行情，不支持 K 线、历史价格回溯等分析需求
适合人群
- 在中国大陆境内需要稳定获取海外股市行情的开发者与投资者
- 需要快速跨市场比对多只股票的技术分析师
- 希望搭建自动化监控脚本（如价格提醒、持仓追踪）的量化爱好者
- 对数据实时性要求中等、无需专业级金融终端的普通个人投资者
常规风险提示
- 数据延迟风险：免费 API 可能存在 15 秒至数分钟延迟，不宜用于高频交易决策
- 服务稳定性依赖：腾讯财经接口属于非官方公开 API，存在随时变更或限制调用的可能
- 合规使用边界：获取的数据仅限个人参考，商业用途需确认是否符合腾讯服务条款
- 投资决策独立性：工具仅提供原始行情数据，不含任何分析建议，使用者需独立判断