| name | stock-price |
| description | Check real-time quotes for A-shares, Hong Kong stocks, ETFs, and indices (latest price, percentage change, trading volume, etc.). Uses the Tencent Quotes API (qt.gtimg.cn); no login or API key required. Triggers when a user says "check stock prices," "real-time quotes," "ETF prices," "stock quotes," or "what is the market index?"
|
| version | 1.0.0 |
Real-Time Stock, ETF, and Index Quotes
Data Sources (by Priority)
| Priority | Data Source | Features |
|---|
| Preferred | Tencent Quotes API (qt.gtimg.cn) | Fastest; get all data with a single curl command, no login required |
| Alternative | Sina Finance (gu.sina.cn) | Homepage displays market indices and the top 6 popular industries |
| Alternative | East Money (data.eastmoney.com/bkzj/hy.html) | Sector capital flows; desktop user agent required |
Tencent Quotes API (Preferred)
Request Format
curl -s "qt.gtimg.cn/q=<list of codes, comma-separated>"
Stock Code Format
| Market | Format | Example |
|---|
| Shanghai A-shares | sh + 6-digit code | sh600519 (Kweichow Moutai) |
| Shenzhen A-shares | sz + 6-digit code | sz000001 (Ping An Bank) |
| Hong Kong stocks | hk + 5-digit code | hk00700 (Tencent Holdings) |
| SSE Composite Index | sh000001 | SSE Composite Index |
| ChiNext Index | sz399006 | ChiNext Index |
Return Format
Returned text is separated by ~:
v_="1~
Key field indexes (separated by ~, starting from 0):
- 1: Name
- 3: Latest price
- 32: Percentage change (%)
- 6: Trading volume (lots)
- 7: Trading value (yuan)
Example
curl -s "qt.gtimg.cn/q=sh000001,sz399006,sh588170,hk00700"
Python parsing example:
fields = line.split('="')[1].rstrip('";').split('~')
name = fields[1]
price = fields[3]
change_pct = fields[32]
Sina Finance (Alternative)
navigate: https://gu.sina.cn
get_readable: Extract market indices, popular industries, and the number of stocks up and down
Reporting Format
SSE Composite Index: 4068.57 (-0.73%)
ChiNext Index: 2140.32 (+0.85%)
Notes
- Updates in real time during trading hours; after hours, the closing price is displayed
- The free version for Hong Kong stocks has a 15-minute delay
- A single query should include no more than 20 codes
- The returned encoding is GBK
