用自然语言查询 A 股行情:TickPlus AI Agent 示例

TickPlus 提供面向 LLM 和 AI Agent 调用的 REST API。对于已知股票代码,AI 助手可用一次 GET 请求读取行情快照;请求参数、返回字段和权限要求均可在接口文档中逐项核对。

全推接口是什么?

TickPlus 的全推接口(/plus/basic/fullquotes)是 REST GET 快照接口,一次请求可返回全市场或批量股票的实时快照。code 参数为空时请求全市场数据;传入多个股票代码时最多支持 100 个。它按请求返回快照,不等同于 WebSocket 长连接主动推送;相比逐只股票分别请求,批量查询可减少请求次数。需要服务端主动推送时,应使用 WebSocket。

首页展示的平台数据包括 <200ms 响应延迟、99.99% 服务可用性,以及 36,000+ 交易品种(该品种数标注更新于 2026-11-18)。这些是平台展示指标,页面未提供其统计方法,不代表单次请求的 SLA 保证。WebSocket 示例中,Tick 股票订阅上限标注为 100 只;该上限以当前接口文档和账户权限为准。

批量查询指定股票

用户提问:帮我查一下 000001 和 000002 现在的行情。

AI 调用:

GET /plus/basic/fullquotes?symbol=stock&code=000001,000002&token=YOUR_TOKEN

响应记录包含 code、o(开盘价)、c(文档定义为收盘价)和 v(成交量)等字段;实际数值由接口响应决定。

查询全市场快照

用户提问:给我一份当前沪深京 A 股的全市场行情快照。

AI 调用:

GET /plus/basic/fullquotes?symbol=stock&code=&token=YOUR_TOKEN

code 留空表示请求该品种的全市场数据;全市场响应量可能较大,实际数据范围以接口返回和账户权限为准。

订阅单只股票 WebSocket 行情

用户提问:持续监控 000001.SZ 的实时 Tick 变化。

AI 调用:连接 ws://ws.tickplus.org/ws/YOUR_TOKEN,然后发送:

{"token":"YOUR_TOKEN","operation":"subscribe","authCodes":["000001.SZ"]}

WebSocket 实时推送需要专业版权限。当前示例文档标注 Tick 股票订阅上限为 100 只。

将以下Markdown文档复制给AI助手,或直接下载文档链接投喂

文档预览

26355 字符
# TickPlus API 使用教程 - AI助手专用

> 本文档专为AI助手(如小龙虾)设计,帮助其理解如何使用TickPlus平台获取股票数据。

---

## 📌 平台介绍

**TickPlus** 是一个专业的金融数据API接口平台,提供实时股票行情、K线数据、财务指标等丰富的金融数据服务。

- **官方网站**: http://www.tickplus.org/
- **开源项目**: https://github.com/tickplusx/TickPlusSkill
- **API基础URL**: http://api.tickplus.org

---

## 🔑 使用说明

### 1. 获取Token
- 访问官网注册账号并登录
- 在控制面板中获取您的专属Token
- 所有API请求都需要携带token参数

### 2. 请求方式
- 所有接口均使用 **GET** 请求
- 参数通过URL查询字符串传递
- 返回格式为 **JSON**

### 3. 权限等级
- **基础版(Basic)**: apiAuth=[1,2,3] - 基础行情、K线、财务数据
- **高级版(Pro)**: apiAuth=[2,3] - 分钟线、概念板块等进阶数据
- **专业版(Expert)**: apiAuth=[3] - 逐笔交易、集合竞价、Level-2等专业数据

> **注意**: 高级权限包含低级权限的所有功能。例如专业版用户可以使用所有接口。

> ⚠️ **WebSocket特别说明**: WebSocket实时推送功能**仅限专业版(Expert)套餐用户使用**,基础版和高级版用户无法使用此功能。如需使用WebSocket,请先开通专业版套餐。

---

## 📚 API接口列表

> **总计**: 3个分类,16个API接口

### API层级概览

| API分类 | 接口数量 | 权限要求 | 主要功能 |
|---------|----------|----------|----------|
| Basic Api | 7个 | 基础版及以上 | 金融数据 |
| Pro Api | 5个 | 高级版及以上 | 金融数据 |
| Expert Api | 4个 | 仅专业版 | 金融数据 |

### 快速导航

1. [Basic Api](#1-basic-api) - 7个接口
2. [Pro Api](#2-pro-api) - 5个接口
3. [Expert Api](#3-expert-api) - 4个接口

---

### 1. Basic Api

#### 1. 股票列表

**接口描述**: 获取股票分类列表,包括沪深京A股、ETF基金、沪深可转债、沪深主要指数。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/list
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `name` | String | 股票名称 |

**返回示例**:

```json
[{"code":"000011","name":"深物业A"},{"code":"300697","name":"电工合金"}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/list"
params = {
    "symbol": "stock",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 2. 实时行情

**接口描述**: 股票实时行情数据,更新速度快,适合盯盘。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/fullquotes
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码。code取值为空,则表示全推全市场数据;code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-13 15:30:00","code":"002937","o":20.15,"c":19.7,"h":20.51,"l":19.6,"v":43719.0,"a":8.74862E7,"pc":20.03},{"t":"2026-11-13 15:30:10","code":"603236","o":85.3,"c":83.0,"h":86.1,"l":82.4,"v":178527.0,"a":1.4994476E9,"pc":85.2}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/fullquotes"
params = {
    "symbol": "stock",
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 3. 日线数据

**接口描述**: 实时日K线数据,按个股获取日K线数据,包括前复权、后复权、不复权。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/daykline
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码,仅支持单个股票获取 |
| `period` | String | 1d-日线,1w-周线,1mon-月线,1y-年线 | K线周期 |
| `dividend` | String | 1-不复权,2-前复权,3-后复权 | 复权类型 |
| `startDate` | String | - | 开始日期 |
| `endDate` | String | - | 结束日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-13 15:30:00","code":"002937","o":20.15,"c":19.7,"h":20.51,"l":19.6,"v":43719.0,"a":8.74862E7,"pc":20.03},{"t":"2026-11-13 15:30:10","code":"603236","o":85.3,"c":83.0,"h":86.1,"l":82.4,"v":178527.0,"a":1.4994476E9,"pc":85.2}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/daykline"
params = {
    "symbol": "stock",
    "code": "000001",
    "period": "1d",
    "dividend": "1",
    "startDate": "2024-01-01",
    "endDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 4. 行情指标

**接口描述**: 行情指标实时数据,包括量比、换手率、市盈率、市净率、总市值、均价、涨幅、涨速等核心指标。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/fullmetric
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码。code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `tradeDate` | String | 交易时间 |
| `zxj` | float | 最新价(元) |
| `open` | float | 开盘价(元) |
| `high` | float | 最高价(元) |
| `low` | float | 最低价(元) |
| `cjl` | float | 成交量(手) |
| `cje` | float | 成交额(元) |
| `zrspj` | float | 昨日收盘价(元) |
| `jj` | float | 均价(元) |
| `ztj` | float | 涨停价(元) |
| `dtj` | float | 跌停价(元) |
| `zdf` | float | 涨跌幅(%) |
| `zde` | float | 涨跌额(元) |
| `zf` | float | 振幅(%) |
| `hsl` | float | 换手率(%) |
| `sjhsl` | float | 实际换手率(%) |
| `lb` | float | 量比 |
| `zsz` | float | 总市值(元) |
| `ltsz` | float | 流通市值(元) |
| `sjl` | float | 市净率(%) |
| `jtsyl` | float | 市盈率(静) |
| `dtsyl` | float | 市盈率(动) |
| `ttmsyl` | float | 市盈率(TTM) |
| `zdf05` | float | 5日涨跌幅(%) |
| `zdf10` | float | 10日涨幅(%) |
| `zdf20` | float | 20日涨幅(%) |

**返回示例**:

```json
[{"code":"000001","tradeDate":"2026-11-06 11:10:45","zxj":11.73,"open":11.62,"high":11.74,"low":11.57,"cjl":717944,"cje":838859000,"zrspj":11.64,"jj":11.68,"ztj":12.8,"dtj":10.48,"zdf":0.77,"zde":0.09,"zf":1.46,"hsl":0.37,"sjhsl":21474836,"lb":1.03,"zsz":227631200000,"ltsz":227628840000,"sjl":0.48,"jtsyl":5.34,"dtsyl":4.36,"ttmsyl":5.24,"zdf05":0.77,"zdf10":4.73,"zdf20":1.21},{"code":"000002","tradeDate":"2026-11-06 11:10:45","zxj":3.27,"open":3.25,"high":3.3,"low":3.23,"cjl":995994,"cje":324884800,"zrspj":3.33,"jj":3.26,"ztj":3.66,"dtj":3,"zdf":-1.8,"zde":-0.06,"zf":2.1,"hsl":1.03,"sjhsl":21474836,"lb":1.08,"zsz":39013390000,"ltsz":31768410000,"sjl":0.42,"jtsyl":-0.44,"dtsyl":-1.22,"ttmsyl":-0.46,"zdf05":2.51,"zdf10":-2.97,"zdf20":-19.46}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/fullmetric"
params = {
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 5. 财务指标

**接口描述**: 核心财务指标,包括ROE、每股净资产、基本每股收益、净资产收益率等核心财务指标。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/financecore
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码,仅支持单个股票获取,不支持批量参数,不支持ALL参数。 |
| `startDate` | String | - | 开始日期 |
| `endDate` | String | - | 结束日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `reportDate` | String | 报告截止日 |
| `publicDate` | String | 公告日 |
| `ocfps` | Float | 每股经营活动现金流量 |
| `bps` | Float | 每股净资产 |
| `basicEps` | Float | 基本每股收益 |
| `dilutedEps` | Float | 稀释每股收益 |
| `dps` | Float | 每股未分配利润 |
| `fund` | Float | 每股资本公积金 |
| `equity` | Float | 净资产收益率 |
| `salesProfit` | Float | 销售毛利率 |
| `revenueInc` | Float | 主营收入同比增长 |
| `profitInc` | Float | 净利润同比增长 |
| `netProfitM` | Float | 归属于母公司所有者的净利润同比增长 |
| `netProfitA` | Float | 扣非净利润同比增长 |
| `roe` | Float | 净资产收益率 |
| `grossProfit` | Float | 毛利率 |
| `netProfit` | Float | 净利率 |
| `prePay` | Float | 预收款 |
| `salesCash` | Float | 销售现金流 |
| `gearRatio` | Float | 资产负债比率 |
| `turnover` | Float | 存货周转率 |

**返回示例**:

```json
[{"code":"000001","reportDate":"2026-06-30","publicDate":"2026-08-15","ocfps":11.0797,"bps":24.13,"basicEps":1.24,"dilutedEps":1.24,"dps":14.8335,"fund":4.1445,"equity":4.6746,"salesProfit":null,"revenueInc":1.7756,"profitInc":3.3213,"netProfitM":3.3213,"netProfitA":2.8199,"roe":4.6872,"grossProfit":null,"netProfit":36.3878,"prePay":null,"salesCash":null,"gearRatio":90.9067,"turnover":null},{"code":"000001","reportDate":"2026-09-30","publicDate":"2026-10-24","ocfps":14.5946,"bps":24.56,"basicEps":1.94,"dilutedEps":1.94,"dps":15.2775,"fund":4.1453,"equity":7.074,"salesProfit":null,"revenueInc":2.4159,"profitInc":2.2092,"netProfitM":2.2092,"netProfitA":2.2342,"roe":7.039,"grossProfit":null,"netProfit":38.0078,"prePay":null,"salesCash":null,"gearRatio":90.6474,"turnover":null}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/financecore"
params = {
    "code": "000001",
    "startDate": "2024-01-01",
    "endDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 6. 股本数据

**接口描述**: 股本表,已上市流通A股等数据

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/capital
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码,仅支持单个股票获取,不支持批量参数,不支持ALL参数。 |
| `startDate` | String | - | 开始日期 |
| `endDate` | String | - | 结束日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `reportDate` | String | 报告截止日 |
| `publicDate` | String | 公告日 |
| `totalCapital` | Float | 总股本 |
| `flowCapital` | Float | 已上市流通A股 |
| `restrictCapital` | Float | 限售流通股份 |

**返回示例**:

```json
[{"code":"000001","reportDate":"2026-06-30","publicDate":"2026-08-15","totalCapital":19405900000,"flowCapital":19405700000,"restrictCapital":0},{"code":"000001","reportDate":"2026-09-30","publicDate":"2026-10-24","totalCapital":19405900000,"flowCapital":19405700000,"restrictCapital":0}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/capital"
params = {
    "code": "000001",
    "startDate": "2024-01-01",
    "endDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 7. 增量数据

**接口描述**: 盘后增量更新,获取每日全市场日线数据,仅支持最近一周的增量数据。日线数据每日更新,非常快速、方便。

**权限要求**: 基础版(Basic)、高级版(Pro)、专业版(Expert)

> 💡 所有套餐用户均可使用此接口

**请求URL**:
```
http://api.tickplus.org/plus/basic/updatedaykline
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `dividend` | String | 1-不复权,2-前复权,3-后复权 | 复权类型 |
| `tradeDate` | String | - | 交易日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/updatedaykline"
params = {
    "symbol": "stock",
    "dividend": "1",
    "tradeDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

### 2. Pro Api

#### 1. 日内分时

**接口描述**: 日内分时数据,支持获取交易日当天所有的分钟K线数据,盘中实时更新。

**权限要求**: 高级版(Pro)、专业版(Expert)

> ⚠️ 需要高级版(Pro)或专业版(Expert)套餐

**请求URL**:
```
http://api.tickplus.org/plus/pro/timekline
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码,仅支持单个股票获取 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-13 09:15:00","code":"000001","o":11.81,"c":11.81,"h":11.81,"l":11.81,"v":0,"a":0,"pc":11.79},{"t":"2026-11-13 09:16:00","code":"000001","o":11.81,"c":11.8,"h":11.81,"l":11.8,"v":0,"a":0,"pc":11.79}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/pro/timekline"
params = {
    "symbol": "stock",
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 2. 题材概念

**接口描述**: 获取行业板块、概念板块、特色板块下的成分股数据。

**权限要求**: 高级版(Pro)、专业版(Expert)

> ⚠️ 需要高级版(Pro)或专业版(Expert)套餐

**请求URL**:
```
http://api.tickplus.org/plus/pro/gncgf
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | hy-行业板块,gn-概念板块,ts-特色板块 | 板块划分 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `name` | String | 股票名称 |

**返回示例**:

```json
[{"bkname":"高速公路","stocks":["000429","000548","000755","000828","000886","000900","001965","600012","600020","600033","600035","600106","600269","600350","600368","600377","600548","601107","601188","601518"]},{"bkname":"汽车服务","stocks":["000757","300825","301215","600335","600386","600653","600822","920030"]}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/pro/gncgf"
params = {
    "symbol": "hy",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 3. 分钟K线数据

**接口描述**: 实时分钟K线数据,盘中1分钟实时更新一次。支持按月调取分钟级别K线数据。

**权限要求**: 高级版(Pro)、专业版(Expert)

> ⚠️ 需要高级版(Pro)或专业版(Expert)套餐

**请求URL**:
```
http://api.tickplus.org/plus/pro/minutekline
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码,仅支持单个股票获取 |
| `period` | String | 1m-1分钟线,5m-5分钟线,15m-15分钟线,30m-30分钟线,1h-1小时线 | K线周期 |
| `dividend` | String | 1-不复权,2-前复权,3-后复权 | 复权类型 |
| `startDate` | String | - | 开始日期 |
| `endDate` | String | - | 结束日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-12 10:30:59","code":"000001","o":11.69,"c":11.75,"h":11.78,"l":11.66,"v":399619,"a":467905540,"pc":11.71},{"t":"2026-11-12 11:30:59","code":"000001","o":11.74,"c":11.81,"h":11.81,"l":11.73,"v":205660,"a":242275040,"pc":11.75},{"t":"2026-11-12 14:00:59","code":"000001","o":11.8,"c":11.77,"h":11.82,"l":11.76,"v":183852,"a":216731250,"pc":11.81}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/pro/minutekline"
params = {
    "symbol": "stock",
    "code": "000001",
    "period": "1m",
    "dividend": "1",
    "startDate": "2024-01-01",
    "endDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 4. 盘中分钟K线

**接口描述**: 交易日当天,实时分钟K线数据全推,盘中1分钟实时更新一次。

**权限要求**: 高级版(Pro)、专业版(Expert)

> ⚠️ 需要高级版(Pro)或专业版(Expert)套餐

**请求URL**:
```
http://api.tickplus.org/plus/pro/fullminute
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码。code取值为空,则表示全推全市场数据;code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-13 15:00:00","code":"000001","o":12.06,"c":12.07,"h":12.07,"l":12.06,"v":13881,"a":16754176,"pc":12.06},{"t":"2026-11-13 15:00:00","code":"000002","o":3.06,"c":3.06,"h":3.06,"l":3.06,"v":14819,"a":4534592,"pc":3.06}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/pro/fullminute"
params = {
    "symbol": "stock",
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 5. 盘中分钟快照

**接口描述**: 实时分钟快照数据全推,盘中秒级实时更新。

**权限要求**: 高级版(Pro)、专业版(Expert)

> ⚠️ 需要高级版(Pro)或专业版(Expert)套餐

**请求URL**:
```
http://api.tickplus.org/plus/pro/fullminutesnapshot
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码。code取值为空,则表示全推全市场数据;code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `o` | float | 开盘价(元) |
| `c` | float | 收盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `v` | float | 成交量(手) |
| `a` | float | 成交额(元) |
| `pc` | float | 昨收价(元) |

**返回示例**:

```json
[{"t":"2026-11-13 15:00:00","code":"000001","o":12.06,"c":12.07,"h":12.07,"l":12.06,"v":13881,"a":16754176,"pc":12.06},{"t":"2026-11-13 15:00:00","code":"000002","o":3.06,"c":3.06,"h":3.06,"l":3.06,"v":14819,"a":4534592,"pc":3.06}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/pro/fullminutesnapshot"
params = {
    "symbol": "stock",
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

### 3. Expert Api

#### 1. 逐笔交易

**接口描述**: 逐笔交易历史数据,每日盘后更新。

**权限要求**: 专业版(Expert)

> 🔒 仅专业版(Expert)用户可使用

**请求URL**:
```
http://api.tickplus.org/plus/expert/transaction
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码,仅支持单个股票获取,不支持批量参数 |
| `tradeDate` | String | - | 交易日期 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `cjj` | float | 成交价(元) |
| `zd` | float | 涨跌额(元) |
| `cjl` | long | 成交量(手) |
| `cje` | long | 成交额(元) |
| `bs` | int | 买卖点,-1主动性卖,1主动性买 |

**返回示例**:

```json
[{"t":"2026-11-12 09:15:00","cjj":11.7,"zd":-0.01,"cjl":195,"cje":228150,"bs":-1},{"t":"2026-11-12 09:15:09","cjj":11.72,"zd":0.01,"cjl":913,"cje":1070036,"bs":1},{"t":"2026-11-12 09:15:45","cjj":11.72,"zd":0.01,"cjl":913,"cje":1070036,"bs":1},{"t":"2026-11-12 09:16:03","cjj":11.72,"zd":0.01,"cjl":925,"cje":1084100,"bs":1}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/transaction"
params = {
    "code": "000001",
    "tradeDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 2. 买卖五档

**接口描述**: 买卖五档实时数据全推,盘中秒级实时更新。

**权限要求**: 专业版(Expert)

> 🔒 仅专业版(Expert)用户可使用

**请求URL**:
```
http://api.tickplus.org/plus/expert/fivelevel
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `symbol` | String | stock-沪深京A股,etf-ETF基金,bond-沪深可转债,index-指数 | 股票类型 |
| `code` | String | - | 股票代码。code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `t` | String | 交易时间 |
| `code` | String | 股票代码 |
| `p` | float | 最新价(元) |
| `o` | float | 开盘价(元) |
| `h` | float | 最高价(元) |
| `l` | float | 最低价(元) |
| `pc` | float | 前收盘价(元) |
| `a` | float | 成交总额(元) |
| `v` | float | 成交总量(手) |
| `bp1` | float | 买一价(元) |
| `bp2` | float | 买二价(元) |
| `bp3` | float | 买三价(元) |
| `bp4` | float | 买四价(元) |
| `bp5` | float | 买五价(元) |
| `bv1` | float | 买一量(手) |
| `bv2` | float | 买二量(手) |
| `bv3` | float | 买三量(手) |
| `bv4` | float | 买四量(手) |
| `bv5` | float | 买五量(手) |
| `sp1` | float | 卖一价(元) |
| `sp2` | float | 卖二价(元) |
| `sp3` | float | 卖三价(元) |
| `sp4` | float | 卖四价(元) |
| `sp5` | float | 卖五价(元) |
| `sv1` | float | 卖一量(手) |
| `sv2` | float | 卖二量(手) |
| `sv3` | float | 卖三量(手) |
| `sv4` | float | 卖四量(手) |
| `sv5` | float | 卖五量(手) |

**返回示例**:

```json
[{"t":"2026-11-13 15:30:00","code":"000001","p":12.07,"o":11.76,"h":12.1,"l":11.7,"pc":11.79,"a":2624481800,"v":2189430,"bp1":12.06,"bp2":12.05,"bp3":12.04,"bp4":12.03,"bp5":12.02,"bv1":1576,"bv2":2413,"bv3":2196,"bv4":1769,"bv5":1483,"sp1":12.07,"sp2":12.08,"sp3":12.09,"sp4":12.1,"sp5":12.11,"sv1":7313,"sv2":19648,"sv3":25195,"sv4":47126,"sv5":11300},{"t":"2026-11-13 15:30:00","code":"000002","p":3.06,"o":3.15,"h":3.15,"l":3.06,"pc":3.14,"a":518616000,"v":1675267,"bp1":3.06,"bp2":3.05,"bp3":3.04,"bp4":3.03,"bp5":3.02,"bv1":20623,"bv2":32508,"bv3":12549,"bv4":10988,"bv5":7822,"sp1":3.07,"sp2":3.08,"sp3":3.09,"sp4":3.1,"sp5":3.11,"sv1":11385,"sv2":9572,"sv3":5232,"sv4":7947,"sv5":8688}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/fivelevel"
params = {
    "symbol": "stock",
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 3. 集合竞价

**接口描述**: 获取沪深A股实时竞价快照数据,竞价时间段:09:15-09:25,盘中实时更新,适合短线打板选股。

**权限要求**: 专业版(Expert)

> 🔒 仅专业版(Expert)用户可使用

**请求URL**:
```
http://api.tickplus.org/plus/expert/fullbid
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码。code取值为空,则表示全推全市场数据;code取值为000001,000002,则表示批量获取获取,股票数量最大为100个;code取值为000001,则表示获取单个股票数据。 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `t` | String | 交易时间 |
| `p` | float | 最新价(元) |
| `pc` | float | 昨日收盘价(元) |
| `zf` | float | 竞价涨幅(%) |
| `jv` | long | 竞价量(手) |
| `je` | long | 竞价金额(元) |
| `nv` | long | 未匹配量(手) |
| `ne` | long | 未匹配金额(元) |
| `bs` | int | 买卖点,-1未匹配量靠近卖一侧,1未匹配量靠近买一侧 |

**返回示例**:

```json
[{"code":"000001","t":"2026-11-13 09:25:00","p":11.76,"pc":11.79,"zf":-0.25,"jv":4159,"je":4891000,"nv":355,"ne":417480,"bs":-1},{"code":"000002","t":"2026-11-13 09:25:00","p":3.15,"pc":3.14,"zf":0.32,"jv":3816,"je":1202000,"nv":6077,"ne":1914255,"bs":-1}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/fullbid"
params = {
    "code": "000001",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

#### 4. 异动数据

**接口描述**: 涨停板数据全推,包含首板股池,一进二,二进三,三进四这些数据,盘中秒级实时更新。

**权限要求**: 专业版(Expert)

> 🔒 仅专业版(Expert)用户可使用

**请求URL**:
```
http://api.tickplus.org/plus/expert/fluctuation
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `tradeDate` | String | - | 交易日期。如果为交易日当天 |
| `token` | String | - | 登录网站获取token |

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `time` | String | 交易日期 |
| `first` | String | 首次触及涨停板时间 |
| `days` | int | 连续涨停天数 |
| `pc` | float | 昨日收盘价 |
| `p` | float | 最新价 |
| `v` | float | 成交量 |
| `a` | float | 成交额 |
| `fbv` | float | 封板量 |
| `fba` | float | 封板资金 |
| `update` | String | 更新时间 |

**返回示例**:

```json
[{"code":"002578","time":"2026-11-06 00:00:00","first":"2026-11-06 09:25:00","days":5,"pc":4.55,"p":5.01,"v":1013120,"a":506808300,"fbv":655663,"fba":328487170,"update":"2026-11-06 11:29:57"},{"code":"002388","time":"2026-11-06 00:00:00","first":"2026-11-06 10:27:24","days":3,"pc":6.06,"p":6.67,"v":985204,"a":608766000,"fbv":164633,"fba":109810210,"update":"2026-11-06 11:29:42"},{"code":"301697","time":"2026-11-06 00:00:00","first":"2026-11-06 09:34:06","days":3,"pc":30.5,"p":36.6,"v":172762,"a":608431100,"fbv":33456,"fba":122448950,"update":"2026-11-06 11:29:42"}]
```

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/fluctuation"
params = {
    "tradeDate": "2024-01-01",
    "token": "YOUR_TOKEN"
}

response = requests.get(url, params=params)
data = response.json()
print(data)
```

---

## 🔌 WebSocket实时数据接入

> ⚠️ **重要权限提示**: WebSocket功能**必须开通专业版(Expert)套餐**才能使用!

> - 基础版(Basic)和高级版(Pro)用户**无法使用**WebSocket功能
> - 只有专业版(Expert)套餐用户才拥有WebSocket订阅权限
> - WebSocket提供秒级实时数据推送,比HTTP API更高效

> 💡 **如何开通专业版**: 访问官网 http://www.tickplus.org/ 登录后可在控制面板中升级套餐

*WebSocket文档加载失败,请稍后重试*

---

## 🤖 AI助手使用指南

当你需要帮助用户获取股票数据时,请按照以下步骤操作:

### 步骤1: 确认用户需求
- 用户需要什么类型的股票数据?(行情、K线、财务等)
- 用户是否有Token?如果没有,引导用户注册获取
- 用户需要的股票代码是什么?

### 步骤2: 选择合适的API
- 根据用户需求,从上文API列表中选择最合适的接口
- 注意检查权限要求,确保用户的套餐等级支持该接口

### 步骤3: 构建请求
- 使用正确的API URL
- 填入必要的参数(特别是token和股票代码)
- 参考上文的使用示例代码

### 步骤4: 解析返回数据
- 根据返回参数说明,提取用户需要的信息
- 以清晰易懂的方式呈现给用户

### 常用场景示例

**场景1: 查询某只股票的实时价格**
- 使用接口: Basic Api - 实时行情全推
- 参数: symbol=stock, code=股票代码, token=用户Token
- 返回字段: c(收盘价/最新价)

**场景2: 查询某只股票的日K线数据**
- 使用接口: Basic Api - 实时日K线数据
- 参数: symbol=stock, code=股票代码, period=1d, startDate, endDate, token
- 返回字段: o(开盘), h(最高), l(最低), c(收盘), v(成交量)

**场景3: 查询某只股票的财务指标**
- 使用接口: Basic Api - 核心财务指标
- 参数: code=股票代码, startDate, endDate, token
- 返回字段: roe(净资产收益率), basicEps(每股收益), bps(每股净资产)等

**场景4: 实时监控多只股票价格变化(WebSocket)**
- **前提条件**: 用户必须已开通**专业版(Expert)套餐**
- **使用方式**: WebSocket订阅(非HTTP API)
- **订阅代码格式**: ["000001.SZ", "600000.SH", "000002.SZ"] (注意:必须带市场后缀)
- **优势**: 秒级推送,无需轮询,适合实时监控股盘异动
- **重要提醒**: 如果用户未开通专业版,需引导其先升级套餐
- **参考文档**: 详见上文「WebSocket实时数据接入」章节

**场景5: 实时监控集合竞价阶段实时竞价数据变化(WebSocket)**
- **前提条件**: 用户必须已开通**专业版(Expert)套餐**
- **使用方式**: WebSocket订阅(非HTTP API)
- **订阅代码格式**: ["auction"]
- **优势**: 秒级推送,无需轮询,适合短线打板选股
- **重要提醒**: 如果用户未开通专业版,需引导其先升级套餐
- **参考文档**: 详见上文「WebSocket实时数据接入」章节

**场景6: 实时监控盘中1分钟K线变化(WebSocket)**
- **前提条件**: 用户必须已开通**专业版(Expert)套餐**
- **使用方式**: WebSocket订阅(非HTTP API)
- **订阅代码格式**: ["minute.hsj", "minute.index", "minute.etf"]
- **优势**: 秒级推送,无需轮询,包括沪深京A股、沪深指数、ETF品种的一分钟K线数据,适合盘中盯盘,策略验证
- **重要提醒**: 如果用户未开通专业版,需引导其先升级套餐
- **参考文档**: 详见上文「WebSocket实时数据接入」章节

## 📞 技术支持

- **邮箱**: tickplus@126.com
- **GitHub**: https://github.com/tickplusx/TickPlusSkill
- **官网**: http://www.tickplus.org/

---

如何使用本文档

💡 如何使用本文档?

步骤1: 复制文档

点击"一键复制全部文档"按钮,将整个教程复制到剪贴板

步骤2: 投喂AI助手

将复制的内容粘贴给AI助手(如小龙虾),让其学习API使用方法

步骤3: 开始提问

向AI助手询问如何获取股票数据,它会根据文档提供准确的API调用方法

备选方案:下载文档

如果AI助手支持文件上传,可下载.md文件直接投喂

金融行情 API 快速示例

🚀 快速示例

用户提问:帮我查一下平安银行(000001)的当前价格

AI助手应该:

  1. 识别需要使用"Basic Api - 实时行情全推"接口
  2. 构建请求URL:/plus/basic/fullquotes?symbol=stock&code=000001&token=USER_TOKEN
  3. 从返回数据中提取字段 c(收盘价/最新价)
  4. 告诉用户:平安银行当前价格为 XX 元

用户提问:我想看贵州茅台(600519)最近一周的日线走势

AI助手应该:

  1. 识别需要使用"Basic Api - 实时日K线数据"接口
  2. 计算日期范围(最近7天)
  3. 构建请求URL:/plus/basic/daykline?symbol=stock&code=600519&period=1d&startDate=XXXX-XX-XX&endDate=XXXX-XX-XX&token=USER_TOKEN
  4. 解析返回的K线数组,提取每日的开盘、收盘、最高、最低价
  5. 以表格或文字形式展示给用户

用户提问:腾讯控股的ROE和每股收益是多少?

AI助手应该:

  1. 识别需要使用"Basic Api - 核心财务指标"接口
  2. 注意:此接口仅支持A股,港股需使用Pro Api
  3. 如果使用Pro权限,调用相应接口获取财务数据
  4. 提取字段 roe(净资产收益率)和 basicEps(基本每股收益)
  5. 告诉用户具体的数值和报告日期