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
chmod +x /path/to/skills/tencent-finance/tfin
ln -sf /path/to/skills/tencent-finance/tfin /usr/local/bin/tfin # Optional: global access
Commands
Price (quick check)
tfin AAPL # Quick price
tfin price AAPL # Same as above
Quote (detailed)
tfin quote MSFT
Compare
tfin compare AAPL,MSFT,GOOGL
tfin compare TSLA,NVDA
Search
tfin search "tesla"
tfin search "bitcoin"
Help
tfin help
tfin --help
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
# Quick price check
tfin AAPL
tfin TSLA
# Detailed quote
tfin quote NVDA
# Compare tech giants
tfin compare AAPL,MSFT,GOOGL,META,AMZN
# Search
tfin search "apple"
tfin search "bitcoin"
# China stocks
tfin sh000001 # 上证指数
tfin quote hk00700 # 腾讯控股
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
pip3 install requests rich
Troubleshooting
"No data found"
Verify the symbol format
Try with prefix:
usAAPLinstead ofAAPLSome 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