Stock Data Query
Two data sources are supported. Tencent Finance HTTP API is used by default:
- 1. Tencent Finance HTTP API (Default) — Lightweight, no installation, no proxy required
- adata SDK (Optional) — More comprehensive data, requires installation and possibly a proxy
1. Tencent Finance HTTP API (Default)
1.1 China A-Share Real-Time Quotes
Endpoint:
CODEBLOCK0
Stock Code Format:
| Market | Code Prefix | Example |
|---|
| Shanghai Main Board | sh600xxx | sh600519 (Moutai) |
| STAR Market |
sh688xxx | sh688111 |
| Shenzhen Main Board | sz000xxx | sz000001 (Ping An Bank) |
| ChiNext (GEM) | sz300xxx | sz300033 |
| ETF | sz159xxx | sz159919 |
Index Codes:
| Index | Code |
|---|
| SSE Composite (Shanghai) | sh000001 |
| SZSE Component (Shenzhen) |
sz399001 |
| ChiNext Index | sz399006 |
| STAR 50 | sz399987 |
| CSI 300 | sh000300 |
Examples:
CODEBLOCK1
Response Fields:
v_sh600519="1~贵州茅台~600519~1460.00~1466.21~1466.99~14146~6374~7772~..."
~ Name ~ Code ~ Open ~ High ~ Low ~ Volume
Stock name |
| 2 | Stock code |
| 3 | Current price |
| 4 | Open price |
| 5 | Low price |
| 6 | High price |
| 30 | Price change |
| 31 | Change % |
1.2 Hong Kong Stock Real-Time Quotes
Endpoint:
CODEBLOCK3
Examples:
# Tencent Holdings
curl -s "http://qt.gtimg.cn/q=hk00700"
# Alibaba
curl -s "http://qt.gtimg.cn/q=hk09988"
1.3 US Stock Real-Time Quotes
Endpoint:
CODEBLOCK5
Examples:
# Apple
curl -s "http://qt.gtimg.cn/q=usAAPL"
# Tesla
curl -s "http://qt.gtimg.cn/q=usTSLA"
# NVIDIA
curl -s "http://qt.gtimg.cn/q=usNVDA"
1.4 K-Line Historical Data
Endpoint:
CODEBLOCK7
Parameters:
| Parameter | Description |
|---|
| INLINECODE0 | Variable name, e.g. INLINECODE1 |
| INLINECODE2 |
stock
code, klinetype, start
date, enddate, count, adjust_type |
K-Line Types: day / week / INLINECODE5
Adjustment Types: qfqa (forward-adjusted) / qfq (backward-adjusted) / empty (unadjusted)
Examples:
CODEBLOCK8
Response Format:
{"day": [["2026-02-27", "1466.99", "1461.19", "1476.21", "1456.01", "13534"], ...]}
Date Open Close High Low Volume
1.5 Order Book Analysis
Endpoint:
CODEBLOCK10
Example:
CODEBLOCK11
Returns: Buy/sell volume ratios (internal vs external trades)
2. adata SDK (Optional)
adata is an open-source A-share quantitative data library providing more comprehensive data. Requires installation and possibly a proxy.
Installation
CODEBLOCK12
Proxy Setup (if needed)
CODEBLOCK13
Feature List
| Feature | Description |
|---|
| Stock Basic Info | All A-share codes, share capital, SW industry classification |
| K-Line Data |
Daily/Weekly/Monthly, forward/backward adjustment |
| Real-Time Quotes | Batch real-time pricing |
| Level-2 Order Book | Bid/ask depth data |
| Capital Flow | Individual stock capital flow analysis |
| Concept Sectors | Thematic sector data |
| Index Data | Major index quotes |
| ETF | ETF quotes |
Usage Examples
CODEBLOCK14
3. Use Case Guide
| Scenario | Recommended Source |
|---|
| Quick single stock price check | Tencent Finance API |
| K-line historical data |
Tencent Finance API |
| Batch quote queries | Tencent Finance API |
| Capital flow data | adata SDK |
| Full financial statements | adata SDK |
| Concept/sector analysis | adata SDK |
| Level-2 order book | Tencent Finance API or adata SDK |
4. Important Notes
- 1. Encoding: Tencent Finance API returns GBK-encoded text — decode accordingly
- Change %: Use the API's built-in field (index 31) — do not calculate manually
- Data Delay: Real-time data may have up to 15-minute delay
- Request Rate: Avoid high-frequency requests — use batch queries when possible
- Error Handling: Invalid stock codes return INLINECODE8
股票数据查询
支持两种数据源。默认使用腾讯财经HTTP接口：
- 1. 腾讯财经HTTP接口（默认） — 轻量级，无需安装，无需代理
- adata SDK（可选） — 数据更全面，需要安装并可能需要代理
1. 腾讯财经HTTP接口（默认）
1.1 A股实时行情
接口地址：
http://qt.gtimg.cn/q=<股票代码>
股票代码格式：
| 市场 | 代码前缀 | 示例 |
|---|
| 沪市主板 | sh600xxx | sh600519（贵州茅台） |
| 科创板 |
sh688xxx | sh688111 |
| 深市主板 | sz000xxx | sz000001（平安银行） |
| 创业板 | sz300xxx | sz300033 |
| ETF | sz159xxx | sz159919 |
指数代码：
sz399001 |
| 创业板指 | sz399006 |
| 科创50 | sz399987 |
| 沪深300 | sh000300 |
示例：
bash
单只股票
curl -s http://qt.gtimg.cn/q=sh600519
多只股票
curl -s http://qt.gtimg.cn/q=sh600519,sh000001,sz399001
响应字段：
v_sh600519=1~贵州茅台~600519~1460.00~1466.21~1466.99~14146~6374~7772~...
~ 名称 ~ 代码 ~ 开盘价 ~ 最高价 ~ 最低价 ~ 成交量
股票名称 |
| 2 | 股票代码 |
| 3 | 当前价格 |
| 4 | 开盘价 |
| 5 | 最低价 |
| 6 | 最高价 |
| 30 | 涨跌额 |
| 31 | 涨跌幅 |
1.2 港股实时行情
接口地址：
http://qt.gtimg.cn/q=hk<股票代码>
示例：
bash
腾讯控股
curl -s http://qt.gtimg.cn/q=hk00700
阿里巴巴
curl -s http://qt.gtimg.cn/q=hk09988
1.3 美股实时行情
接口地址：
http://qt.gtimg.cn/q=us<股票代码>
示例：
bash
苹果
curl -s http://qt.gtimg.cn/q=usAAPL
特斯拉
curl -s http://qt.gtimg.cn/q=usTSLA
英伟达
curl -s http://qt.gtimg.cn/q=usNVDA
1.4 K线历史数据
接口地址：
https://web.ifzq.gtimg.cn/appstock/app/fqkline/get
参数：
| 参数 | 说明 |
|---|
| var | 变量名，例如 klinedayqfq |
| param |
股票代码、K线类型、开始日期、结束日期、数量、复权类型 |
K线类型： day（日线）/ week（周线）/ month（月线）
复权类型： qfqa（前复权）/ qfq（后复权）/ 空（不复权）
示例：
bash
贵州茅台日K线（最近10天，前复权）
curl -s https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?
var=klinedayqfq¶m=sh600519,day,,,10,qfqa
平安银行周K线（最近5周）
curl -s https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?
var=klineweekqfq¶m=sz000001,week,,,5,qfqa
创业板指月K线（最近3个月）
curl -s https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?
var=klinemonthqfq¶m=sz399006,month,,,3,qfqa
响应格式：
json
{day: [[2026-02-27, 1466.99, 1461.19, 1476.21, 1456.01, 13534], ...]}
日期 开盘价 收盘价 最高价 最低价 成交量
1.5 盘口分析
接口地址：
http://qt.gtimg.cn/q=s_pk<股票代码>
示例：
bash
curl -s http://qt.gtimg.cn/q=s_pksh600519
返回： 买卖成交量比例（内盘与外盘）
2. adata SDK（可选）
adata是一个开源的A股量化数据库，提供更全面的数据。需要安装并可能需要代理。
安装
bash
pip install adata
代理设置（如需）
python
import adata
adata.proxy(is_proxy=True, ip=your-proxy-ip:port)
功能列表
| 功能 | 说明 |
|---|
| 股票基本信息 | 全部A股代码、股本、申万行业分类 |
| K线数据 |
日/周/月线，前/后复权 |
| 实时行情 | 批量实时报价 |
| Level-2盘口 | 买卖盘深度数据 |
| 资金流向 | 个股资金流向分析 |
| 概念板块 | 主题板块数据 |
| 指数数据 | 主要指数行情 |
| ETF | ETF行情 |
使用示例
python
import adata
获取全部A股股票代码
df = adata.stock.info.all_code()
获取K线数据
df = adata.stock.market.get_market(
stock_code=000001,
k_type=1, # 1=日线, 2=周线, 3=月线
start_date=2024-01-01,
adjust_type=1 # 0=不复权, 1=前复权, 2=后复权
)
实时行情
df = adata.stock.market.list
marketcurrent(
code_list=[000001, 600519]
)
3. 使用场景指南
| 场景 | 推荐数据源 |
|---|
| 快速查询单只股票价格 | 腾讯财经API |
| K线历史数据 |
腾讯财经API |
| 批量行情查询 | 腾讯财经API |
| 资金流向数据 | adata SDK |
| 完整财务报表 | adata SDK |
| 概念/板块分析 | adata SDK |
| Level-2盘口 | 腾讯财经API或adata SDK |
4. 重要提示
- 1. 编码：腾讯财经API返回GBK编码文本——需相应解码
- 涨跌幅：使用API内置字段（索引31）——请勿手动计算
- 数据延迟：实时数据可能有最多15分钟延迟
- 请求频率：避免高频请求——尽量使用批量查询
- 错误处理：无效股票代码返回 vpvnone_match=1
