开发教程 - TickPlus API 使用指南

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

21759 字符
# 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个分类，17个API接口

### API层级概览

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

### 快速导航

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

---

### 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 | 昨收价（元） |

**使用示例**:

```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线数据，按个股获取日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 | 昨收价（元） |

**使用示例**:

```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. 行情指标全推

**接口描述**: 实时行情指标全推，包括量比、换手率、ROE、市盈率、市净率、总市值、均价、涨幅、涨速等核心指标。盘中1-2分钟更新一次数据。

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

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

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

**输入参数**:

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

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `name` | 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 | 换手率（%） |
| `lb` | float | 量比 |
| `zsz` | float | 总市值（元） |
| `ltsz` | float | 流通市值（元） |
| `sjl` | float | 市净率（%） |
| `roe` | float | ROE |
| `zgb` | float | 总股本（股） |
| `ltgb` | float | 流通股本（股） |
| `jtsyl` | float | 市盈率（静） |
| `dtsyl` | float | 市盈率（动） |
| `ttmsyl` | float | 市盈率（TTM） |
| `zdf05` | float | 5日涨跌幅（%） |
| `zdf10` | float | 10日涨幅（%） |
| `zdf20` | float | 20日涨幅（%） |
| `zdf60` | float | 60日涨幅（%） |

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/basic/fullfactor"
params = {
    "symbol": "stock",
    "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 | - | 股票代码，仅支持单个股票获取 |
| `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 | 存货周转率 |

**使用示例**:

```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 | 限售流通股份 |

**使用示例**:

```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线数据

**接口描述**: 实时分钟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 | 昨收价（元） |

**使用示例**:

```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)
```

---

#### 2. 盘中分钟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 | 昨收价（元） |

**使用示例**:

```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)
```

---

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

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

**权限要求**: 高级版(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 | 昨收价（元） |

**使用示例**:

```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)
```

---

#### 4. 日内分时

**接口描述**: 日内分时数据，支持获取交易日当天所有的分钟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 | 昨收价（元） |

**使用示例**:

```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)
```

---

#### 5. 概念成分股

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

**权限要求**: 高级版(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":["000001","000002"]}]
```

**使用示例**:

```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. 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主动性买 |

**使用示例**:

```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/fullfive
```

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码。code取值为空，则表示全推全市场数据；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 | 卖五量（手） |

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/fullfive"
params = {
    "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未匹配量靠近买一侧 |

**使用示例**:

```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. 竞价明细数据

**接口描述**: 获取沪深A股实时竞价每笔数据，竞价时间段：09:15-09:25，盘中秒级实时更新，按个股获取交易日内的所有竞价记录。

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

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

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

**输入参数**:

| 参数名 | 类型 | 取值范围 | 说明 |
|--------|------|----------|------|
| `code` | String | - | 股票代码，仅支持单个股票获取，不支持批量参数 |
| `tradeDate` | String | - | 开始日期 |
| `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未匹配量靠近买一侧 |

**使用示例**:

```python
import requests

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

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

---

#### 5. 涨停板全推

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

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

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

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

**输入参数**:

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

**返回参数**:

| 参数名 | 类型 | 说明 |
|--------|------|------|
| `code` | String | 股票代码 |
| `time` | long | 交易日期 |
| `ftime` | long | 首次触及涨停板时间 |
| `days` | int | 连续涨停天数 |
| `preClose` | float | 昨日收盘价 |
| `price` | float | 最新价 |
| `volume` | float | 成交量 |
| `amount` | float | 成交额 |
| `fbvolumn` | float | 封板量 |
| `fbamount` | float | 封板资金 |
| `uTime` | long | 更新时间 |

**使用示例**:

```python
import requests

url = "http://api.tickplus.org/plus/expert/fullboard"
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文件直接投喂
🚀 快速示例
示例1: 查询股票实时价格
用户提问：帮我查一下平安银行(000001)的当前价格
AI助手应该：
识别需要使用"Basic Api - 实时行情全推"接口
构建请求URL：/plus/basic/fullquotes?symbol=stock&code=000001&token=USER_TOKEN
从返回数据中提取字段 c（收盘价/最新价）
告诉用户：平安银行当前价格为 XX 元
示例2: 查询股票日K线
用户提问：我想看贵州茅台(600519)最近一周的日线走势
AI助手应该：
识别需要使用"Basic Api - 实时日K线数据"接口
计算日期范围（最近7天）
构建请求URL：/plus/basic/daykline?symbol=stock&code=600519&period=1d&startDate=XXXX-XX-XX&endDate=XXXX-XX-XX&token=USER_TOKEN
解析返回的K线数组，提取每日的开盘、收盘、最高、最低价
以表格或文字形式展示给用户
示例3: 查询财务指标
用户提问：腾讯控股的ROE和每股收益是多少？
AI助手应该：
识别需要使用"Basic Api - 核心财务指标"接口
注意：此接口仅支持A股，港股需使用Pro Api
如果使用Pro权限，调用相应接口获取财务数据
提取字段 roe（净资产收益率）和 basicEps（基本每股收益）
告诉用户具体的数值和报告日期
龙虾教程 - AI助手使用指南

文档预览

步骤1: 复制文档

步骤2: 投喂AI助手

步骤3: 开始提问

备选方案：下载文档
