Tencent Finance Stock Price

---
name: tencent-finance-stock-price
description: Query real-time stock market data using Tencent Finance API. Supports Chinese A-shares, Hong Kong stocks, and US stocks. No API key required.
---

# Tencent Finance Stock Price

Query real-time stock quotes via Tencent Finance API.

## Usage

```bash
uv run ~/.openclaw/skills/tencent-finance-stock-price/scripts/query_stock.py <stock1> [stock2] ...
```

## Supported Input Formats

### Chinese Names (Auto-mapped)
- A-Share Indices: `上证指数`, `科创50`, `创业板指`
- HK Indices: `恒生指数`, `恒生科技`
- US Indices: `标普500`, `纳指100`, `纳斯达克`

### Stock Codes
- A-Shares: `sh000001`, `sz399006`, `sh600519` (Moutai)
- HK Stocks: `hkHSI`, `hk01810` (Xiaomi)
- US Stocks: `usAAPL` (Apple), `usTSLA` (Tesla)

## Examples

```bash
# Query by Chinese name
uv run ~/.openclaw/skills/tencent-finance-stock-price/scripts/query_stock.py 上证指数 恒生科技

# Query by code
uv run ~/.openclaw/skills/tencent-finance-stock-price/scripts/query_stock.py sh000001 hkHSI usAAPL

# Query multiple stocks
uv run ~/.openclaw/skills/tencent-finance-stock-price/scripts/query_stock.py 上证指数 创业板指 恒生指数 纳指100
```

## Output Format

Returns a formatted table with:
- Name: Stock name
- Code: Stock code
- Price: Current price/points
- Change: Change amount
- Change%: Change percentage with 🟢/🔴 indicator

## Data Source

- API: `http://qt.gtimg.cn/q=<codes>`
- Encoding: GB2312
- Response format: `v_code="data~data~..."`
- Key indices: 1=name, 3=price, 31=change, 32=change%

## API Response Format

The Tencent API returns data in this format:
```
v_sh000001="1~上证指数~000001~4108.57~...~26.10~0.64~...";
```

Fields are separated by `~`:
- Index 1: Stock name
- Index 3: Current price
- Index 31: Change amount
- Index 32: Change percentage