\r \r

Stock Data Query\r

\r Two data sources are supported. Tencent Finance HTTP API is used by default:\r \r

1. Tencent Finance HTTP API (Default) — Lightweight, no installation, no proxy required\r
2. adata SDK (Optional) — More comprehensive data, requires installation and possibly a proxy\r \r ---\r \r

1. Tencent Finance HTTP API (Default)\r

\r

1.1 China A-Share Real-Time Quotes\r

\r Endpoint:\r

http://qt.gtimg.cn/q=\x3Cstock_code>\r
```\r
\r
**Stock Code Format:**\r
\r
| Market | Code Prefix | Example |\r
|--------|-------------|---------|\r
| Shanghai Main Board | sh600xxx | sh600519 (Moutai) |\r
| STAR Market | sh688xxx | sh688111 |\r
| Shenzhen Main Board | sz000xxx | sz000001 (Ping An Bank) |\r
| ChiNext (GEM) | sz300xxx | sz300033 |\r
| ETF | sz159xxx | sz159919 |\r
\r
**Index Codes:**\r
\r
| Index | Code |\r
|-------|------|\r
| SSE Composite (Shanghai) | sh000001 |\r
| SZSE Component (Shenzhen) | sz399001 |\r
| ChiNext Index | sz399006 |\r
| STAR 50 | sz399987 |\r
| CSI 300 | sh000300 |\r
\r
**Examples:**\r
```bash\r
# Single stock\r
curl -s "http://qt.gtimg.cn/q=sh600519"\r
\r
# Multiple stocks\r
curl -s "http://qt.gtimg.cn/q=sh600519,sh000001,sz399001"\r
```\r
\r
**Response Fields:**\r
```\r
v_sh600519="1~贵州茅台~600519~1460.00~1466.21~1466.99~14146~6374~7772~..."\r
          ~  Name    ~ Code  ~  Open  ~  High  ~   Low  ~ Volume\r
```\r
\r
| Index | Field |\r
|-------|-------|\r
| 0 | Market code |\r
| 1 | Stock name |\r
| 2 | Stock code |\r
| 3 | Current price |\r
| 4 | Open price |\r
| 5 | Low price |\r
| 6 | High price |\r
| 30 | Price change |\r
| 31 | Change % |\r
\r
---\r
\r
### 1.2 Hong Kong Stock Real-Time Quotes\r
\r
**Endpoint:**\r
```\r
http://qt.gtimg.cn/q=hk\x3Cstock_code>\r
```\r
\r
**Examples:**\r
```bash\r
# Tencent Holdings\r
curl -s "http://qt.gtimg.cn/q=hk00700"\r
\r
# Alibaba\r
curl -s "http://qt.gtimg.cn/q=hk09988"\r
```\r
\r
---\r
\r
### 1.3 US Stock Real-Time Quotes\r
\r
**Endpoint:**\r
```\r
http://qt.gtimg.cn/q=us\x3Cticker>\r
```\r
\r
**Examples:**\r
```bash\r
# Apple\r
curl -s "http://qt.gtimg.cn/q=usAAPL"\r
\r
# Tesla\r
curl -s "http://qt.gtimg.cn/q=usTSLA"\r
\r
# NVIDIA\r
curl -s "http://qt.gtimg.cn/q=usNVDA"\r
```\r
\r
---\r
\r
### 1.4 K-Line Historical Data\r
\r
**Endpoint:**\r
```\r
https://web.ifzq.gtimg.cn/appstock/app/fqkline/get\r
```\r
\r
**Parameters:**\r
| Parameter | Description |\r
|-----------|-------------|\r
| `_var` | Variable name, e.g. `kline_dayqfq` |\r
| `param` | stock_code, kline_type, start_date, end_date, count, adjust_type |\r
\r
**K-Line Types:** `day` / `week` / `month`\r
\r
**Adjustment Types:** `qfqa` (forward-adjusted) / `qfq` (backward-adjusted) / empty (unadjusted)\r
\r
**Examples:**\r
```bash\r
# Moutai daily K-line (last 10 days, forward-adjusted)\r
curl -s "https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?_var=kline_dayqfq&param=sh600519,day,,,10,qfqa"\r
\r
# Ping An Bank weekly K-line (last 5 weeks)\r
curl -s "https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?_var=kline_weekqfq&param=sz000001,week,,,5,qfqa"\r
\r
# ChiNext Index monthly K-line (last 3 months)\r
curl -s "https://web.ifzq.gtimg.cn/appstock/app/fqkline/get?_var=kline_monthqfq&param=sz399006,month,,,3,qfqa"\r
```\r
\r
**Response Format:**\r
```json\r
{"day": [["2026-02-27", "1466.99", "1461.19", "1476.21", "1456.01", "13534"], ...]}\r
                Date       Open      Close      High       Low      Volume\r
```\r
\r
---\r
\r
### 1.5 Order Book Analysis\r
\r
**Endpoint:**\r
```\r
http://qt.gtimg.cn/q=s_pk\x3Cstock_code>\r
```\r
\r
**Example:**\r
```bash\r
curl -s "http://qt.gtimg.cn/q=s_pksh600519"\r
```\r
\r
**Returns:** Buy/sell volume ratios (internal vs external trades)\r
\r
---\r
\r
## 2. adata SDK (Optional)\r
\r
adata is an open-source A-share quantitative data library providing more comprehensive data. Requires installation and possibly a proxy.\r
\r
### Installation\r
\r
```bash\r
pip install adata\r
```\r
\r
### Proxy Setup (if needed)\r
\r
```python\r
import adata\r
adata.proxy(is_proxy=True, ip='your-proxy-ip:port')\r
```\r
\r
### Feature List\r
\r
| Feature | Description |\r
|---------|-------------|\r
| Stock Basic Info | All A-share codes, share capital, SW industry classification |\r
| K-Line Data | Daily/Weekly/Monthly, forward/backward adjustment |\r
| Real-Time Quotes | Batch real-time pricing |\r
| Level-2 Order Book | Bid/ask depth data |\r
| Capital Flow | Individual stock capital flow analysis |\r
| Concept Sectors | Thematic sector data |\r
| Index Data | Major index quotes |\r
| ETF | ETF quotes |\r
\r
### Usage Examples\r
\r
```python\r
import adata\r
\r
# Get all A-share stock codes\r
df = adata.stock.info.all_code()\r
\r
# Get K-line data\r
df = adata.stock.market.get_market(\r
    stock_code='000001',\r
    k_type=1,           # 1=daily, 2=weekly, 3=monthly\r
    start_date='2024-01-01',\r
    adjust_type=1        # 0=unadjusted, 1=forward, 2=backward\r
)\r
\r
# Real-time quotes\r
df = adata.stock.market.list_market_current(\r
    code_list=['000001', '600519']\r
)\r
```\r
\r
---\r
\r
## 3. Use Case Guide\r
\r
| Scenario | Recommended Source |\r
|----------|--------------------|\r
| Quick single stock price check | Tencent Finance API |\r
| K-line historical data | Tencent Finance API |\r
| Batch quote queries | Tencent Finance API |\r
| Capital flow data | adata SDK |\r
| Full financial statements | adata SDK |\r
| Concept/sector analysis | adata SDK |\r
| Level-2 order book | Tencent Finance API or adata SDK |\r
\r
---\r
\r
## 4. Important Notes\r
\r
1. **Encoding**: Tencent Finance API returns GBK-encoded text — decode accordingly\r
2. **Change %**: Use the API's built-in field (index 31) — do not calculate manually\r
3. **Data Delay**: Real-time data may have up to 15-minute delay\r
4. **Request Rate**: Avoid high-frequency requests — use batch queries when possible\r
5. **Error Handling**: Invalid stock codes return `v_pv_none_match="1"`\r