Skill: ezio-xiang/tencent-finance (version 1.0.0)

--- name: tencent-finance description: 腾讯财经实时行情接口，查询A股、港股、美股、期货、外汇、ETF的实时行情数据。触发关键词：查股价、查行情、查指数、腾讯接口、股票报价、实时行情 --- # 腾讯财经行情接口（Tencent Finance API） ## 接口信息 **Base URL：** `https://qt.gtimg.cn/q=代码` **特点：** - 毫秒级响应，无需注册，即插即用 - 支持 A股、港股、美股、期货、外汇、ETF - 查询频率建议间隔 100ms 以上，避免封 IP --- ## 代码规则 ### A 股 | 前缀 | 市场 | 示例 | |------|------|------| | `sh` | 上交所 | `sh000001`（上证指数）、`sh600519`（茅台） | | `sz` | 深交所 | `sz399001`（深证成指）、`sz000858`（五粮液） | ### 港 股 | 前缀 | 市场 | 示例 | |------|------|------| | `hk` | 港交所 | `hkHSI`（恒生指数）、`hkHSTECH`（恒生科技） | | `hk` | 港交所个股 | `hk00700`（腾讯）、`hk09988`（阿里） | ### 美 股（指数） | 代码 | 名称 | |------|------| | `usNDX` | 纳斯达克 100 | | `usSPX` | 标普 500 | | `usDJI` | 道琼斯 | ### 大宗商品 | 代码 | 名称 | |------|------| | `hf_GC` | 黄金（COMEX） | | `hf_CL` | WTI 原油 | | `hf_SI` | 白银 | ### 外汇 | 代码 | 名称 | |------|------| | `fx_usr` | 美元/人民币（USD/CNY） | --- ## 数据字段说明 返回字段以 `~` 分隔，关键字段索引： | 索引 | 含义 | |------|------| | `[3]` | 当前价格 | | `[4]` | 昨收价格 | | `[5]` | 今开价格 | | `[31]` | 涨跌额 | | `[32]` | 涨跌幅（%） | | `[33]` | 最高价 | | `[34]` | 最低价 | | `[36]` | 成交量（手） | | `[37]` | 成交额（万元） | | `[38]` | 换手率（%） | | `[39]` | 市盈率（PE） | | `[43]` | 振幅（%） | | `[44]` | 流通市值 | | `[45]` | 总市值 | --- ## 使用方式 ### 直接在脚本中调用 ```python import requests def get_quote(code): url = f"https://qt.gtimg.cn/q={code}" resp = requests.get(url, timeout=10) data = resp.text # 解析 v_xxx="51~名称~代码~价格~..." parts = data.split('="')[1].strip().strip('";') fields = parts.split('~') return { "name": fields[1], "code": fields[2], "price": fields[3], "yesterday_close": fields[4], "open": fields[5], "change": fields[31], "change_pct": fields[32], "high": fields[33], "low": fields[34], "volume": fields[36], "turnover": fields[37], "turnover_rate": fields[38], "pe": fields[39], "amplitude": fields[43], } # 示例 quote = get_quote("sh000001") print(f"{quote['name']}: {quote['price']} ({quote['change_pct']}%)") ``` ### 多只股票同时查询 ```python def get_quotes(codes): # codes: list，如 ["sh000001", "sz399001", "hkHSI"] url = "https://qt.gtimg.cn/q=" + ",".join(codes) resp = requests.get(url, timeout=10) results = [] for line in resp.text.strip().split('\n'): if '="v_' in line: parts = line.split('="')[1].strip().strip('";') fields = parts.split('~') results.append({ "name": fields[1], "code": fields[2], "price": fields[3], "change": fields[31], "change_pct": fields[32], "high": fields[33], "low": fields[34], }) return results # 同时查询多只 quotes = get_quotes(["sh000001", "sz399001", "hkHSI", "hkHSTECH", "sh560860"]) for q in quotes: print(f"{q['name']}: {q['price']} ({q['change_pct']}%)") ``` --- ## 常用代码速查 ### A 股指数 | 名称 | 代码 | |------|------| | 上证指数 | `sh000001` | | 深证成指 | `sz399001` | | 创业板指 | `sz399006` | | 沪深300 | `sh000300` | | 科创50 | `sh000688` | | 北证50 | `sz899050` | ### A 股个股 | 名称 | 代码 | |------|------| | 贵州茅台 | `sh600519` | | 宁德时代 | `sz300750` | | 比亚迪 | `sz002594` | | 招商银行 | `sh600036` | | 中国平安 | `sh601318` | | 工业有色ETF | `sh560860` | ### 港股 | 名称 | 代码 | |------|------| | 恒生指数 | `hkHSI` | | 恒生科技 | `hkHSTECH` | | 腾讯控股 | `hk00700` | | 阿里巴巴 | `hk09988` | | 美团 | `hk03690` | | 小米集团 | `hk01810` | | 京东集团 | `hk09618` | | 快手 | `hk01024` | ### ETF | 名称 | 代码 | |------|------| | 工业有色ETF | `sh560860` | | 沪深300ETF | `sh510300` | | 恒生ETF | `sh159920` | --- ## 定时任务中的用法 在 cron 任务中调用腾讯接口获取行情数据： ```python import requests codes = ["sh000001", "sz399001", "hkHSI", "hkHSTECH"] url = "https://qt.gtimg.cn/q=" + ",".join(codes) resp = requests.get(url, timeout=10) # 解析并输出 ``` --- ## 注意事项 1. **查询频率**：建议每次调用间隔 100ms 以上，高频调用可能被封 IP 2. **数据用途**：仅供参考，不构成投资建议 3. **接口稳定**：腾讯接口稳定性和速度均优于国内大多数免费 API 4. **字段缺失**：部分股票（如港股一些股票）字段可能不全，返回空字符串时跳过即可 5. **时区**：港股交易时间 9:30-16:00 香港时间（A 股 9:30-15:00 北京时间）


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)