Tencent Finance CLI
A Python CLI for fetching stock data from Tencent Finance API.
Features
- - ✅ No API key required - 无需申请 API Key
- ✅ Works in mainland China - 针对中国大陆网络环境优化，直接访问腾讯财经 API
- ✅ Fast & Stable - 比 Yahoo Finance API 更稳定，不受限流影响
- ✅ Multi-market support - 支持美股、A股、港股
Installation
CODEBLOCK0
Commands
Price (quick check)
CODEBLOCK1
Quote (detailed)
CODEBLOCK2
Compare
CODEBLOCK3
Search
CODEBLOCK4
Help
CODEBLOCK5
Symbol Format
- - US stocks: AAPL, MSFT, GOOGL, TSLA, NVDA
- China A-Shares: sh000001 (上证指数), sz399001 (深证成指), sh600519 (茅台)
- Hong Kong: hk00700 (腾讯), hk09988 (阿里), hk03690 (美团)
- Crypto: BTC-USD, ETH-USD
Examples
CODEBLOCK6
Data Source
This tool uses Tencent Finance API (腾讯财经 API).
Why Tencent API?
- - 在中国大陆网络环境下可直接访问，无需代理
- 比 Yahoo Finance API 更稳定，不受限流影响
- 数据覆盖美股、A股、港股等多个市场
Data includes:
- - Current price (实时价格)
- Price change (absolute & percentage) (涨跌额/涨跌幅)
- Open, High, Low prices (开盘/最高/最低价)
- Previous close (昨收)
- Volume (成交量)
- Market cap (市值)
- P/E ratio (市盈率)
- P/B ratio (市净率)
Supported Markets
| Market | Example | Status |
|---|
| US Stocks | AAPL, TSLA, NVDA | ✅ Supported |
| China A-Shares |
sh000001, sz399001 | ✅ Supported |
| Hong Kong | hk00700, hk09988 | ✅ Supported |
| Crypto | BTC-USD, ETH-USD | ✅ Supported |
| India NSE/BSE | RELIANCE.NS, TCS.BO | ❌ Not supported |
Comparison with Yahoo Finance
| Feature | Yahoo Finance (yfinance) | Tencent Finance (tfin) |
|---|
| Mainland China Access | Often blocked/restricted | ✅ Direct access |
| Rate Limiting |
Frequent | ✅ Stable |
| US Stocks | ✅ Supported | ✅ Supported |
| China A-Shares | Limited | ✅ Full support |
| Hong Kong Stocks | Supported | ✅ Supported |
| Indian Stocks | ✅ Supported | ❌ Not supported |
| Options/Dividends | Supported | ❌ Not supported |
Requirements
- - Python 3.7+
- requests
- rich
CODEBLOCK7
Troubleshooting
"No data found"
- - Verify the symbol format
- Try with prefix:
usAAPL instead of INLINECODE1 - Some international markets may not be supported
Connection errors
- - Check internet connection
- Tencent API is optimized for mainland China and generally very stable
License
MIT License
Author
Created by Menrfa
Tencent Finance CLI
一个用于从腾讯财经API获取股票数据的Python命令行工具。
特性
- - ✅ 无需API Key - 无需申请API密钥
- ✅ 中国大陆可用 - 针对中国大陆网络环境优化，直接访问腾讯财经API
- ✅ 快速稳定 - 比Yahoo Finance API更稳定，不受限流影响
- ✅ 多市场支持 - 支持美股、A股、港股
安装
bash
chmod +x /path/to/skills/tencent-finance/tfin
ln -sf /path/to/skills/tencent-finance/tfin /usr/local/bin/tfin # 可选：全局访问
命令
价格（快速查询）
bash
tfin AAPL # 快速查询价格
tfin price AAPL # 同上
报价（详细信息）
bash
tfin quote MSFT
比较
bash
tfin compare AAPL,MSFT,GOOGL
tfin compare TSLA,NVDA
搜索
bash
tfin search tesla
tfin search bitcoin
帮助
bash
tfin help
tfin --help
代码格式
- - 美股： AAPL, MSFT, GOOGL, TSLA, NVDA
- A股： sh000001（上证指数）, sz399001（深证成指）, sh600519（茅台）
- 港股： hk00700（腾讯）, hk09988（阿里）, hk03690（美团）
- 加密货币： BTC-USD, ETH-USD
示例
bash
快速查询价格
tfin AAPL
tfin TSLA
详细报价
tfin quote NVDA
比较科技巨头
tfin compare AAPL,MSFT,GOOGL,META,AMZN
搜索
tfin search apple
tfin search bitcoin
中国股票
tfin sh000001 # 上证指数
tfin quote hk00700 # 腾讯控股
数据来源
本工具使用腾讯财经API。
为什么选择腾讯API？
- - 在中国大陆网络环境下可直接访问，无需代理
- 比Yahoo Finance API更稳定，不受限流影响
- 数据覆盖美股、A股、港股等多个市场
数据包括：
- - 实时价格
- 涨跌额/涨跌幅
- 开盘/最高/最低价
- 昨收
- 成交量
- 市值
- 市盈率
- 市净率
支持的市场
| 市场 | 示例 | 状态 |
|---|
| 美股 | AAPL, TSLA, NVDA | ✅ 支持 |
| A股 |
sh000001, sz399001 | ✅ 支持 |
| 港股 | hk00700, hk09988 | ✅ 支持 |
| 加密货币 | BTC-USD, ETH-USD | ✅ 支持 |
| 印度NSE/BSE | RELIANCE.NS, TCS.BO | ❌ 不支持 |
与Yahoo Finance对比
| 特性 | Yahoo Finance (yfinance) | Tencent Finance (tfin) |
|---|
| 中国大陆访问 | 经常被屏蔽/限制 | ✅ 直接访问 |
| 限流 |
频繁 | ✅ 稳定 |
| 美股 | ✅ 支持 | ✅ 支持 |
| A股 | 有限 | ✅ 全面支持 |
| 港股 | 支持 | ✅ 支持 |
| 印度股票 | ✅ 支持 | ❌ 不支持 |
| 期权/股息 | 支持 | ❌ 不支持 |
环境要求
- - Python 3.7+
- requests
- rich
bash
pip3 install requests rich
故障排除
未找到数据
- - 检查代码格式
- 尝试添加前缀：使用usAAPL代替AAPL
- 部分国际市场可能不支持
连接错误
- - 检查网络连接
- 腾讯API针对中国大陆优化，通常非常稳定
许可证
MIT许可证
作者
由Menrfa创建
