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: usAAPL instead of AAPL
• 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