接口文档

提供 stdb 全部数据接口的调用方式、参数与返回字段。文档以结构化格式组织，

便于**开发者与 AI 检索**：每个接口都有独立小节，含统一请求模板、参数表、返回列。

# stdb 数据 API 接口文档

> 统一 HTTP 接口，覆盖 A 股 / ETF / 指数 / 可转债 / 龙虎榜 / 财务 / 资金流向等。
> 本文档为**结构化接口总览**：每个接口含统一请求格式、参数说明、返回字段，可直接按模板调用。

- **Base URL**: `https://stdb.rewish.top`
- **全部接口**: `POST /api/reference-proxy/<group>/<name>`  (共 126 个)
- **鉴权**: 请求头 `Authorization: Bearer sk-你的API-Key`（缺失/无效 → 401）
- **返回结构**: `{"code":200,"message":"success","data":{"fields":[...],"items":[[行...]]}, "_source":"A_meoz"}`

## 调用模板

```bash
curl -X POST https://stdb.rewish.top/api/reference-proxy/<group>/<name> \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer sk-YOUR_KEY' \
  -d '{"apiname":"<apiname>", "fields":"<需要的列>", "params":{...}}'
```

```json
// 请求体字段
{"apiname": "接口名(见下各节)",      // 必填, 指定具体接口
 "fields": "列名1,列名2,...",          // 返回哪些列(见各接口返回字段)
 "params": { "symbols":"000001", ... }}  // 筛选参数
```

## 鉴权与用量

- **必须**带有效 API-Key：请求头 `Authorization: Bearer sk-xxx` 或 `X-API-Key: sk-xxx`。
- 每日额度默认 **200 次/天**（可在 keyadmin 后台查/调），超额度返回 HTTP 429。
- 用量查询：`GET /api/usage?api_key=sk-xxx` 返回今日已用/额度/近7日趋势。

## 接口分组总览

| 分组 | 路径前缀 | 接口数 | 说明 |
|---|---|---|---|
| calendar | `/api/reference-proxy/calendar` | 6 | 交易日历 |
| convertible | `/api/reference-proxy/convertible` | 11 | 可转债 |
| etf | `/api/reference-proxy/etf` | 11 | ETF |
| finance | `/api/reference-proxy/finance` | 13 | 财务数据 |
| fund-flow | `/api/reference-proxy/fund-flow` | 6 | 资金流向 |
| index | `/api/reference-proxy/index` | 14 | 指数 |
| interactive-qa | `/api/reference-proxy/interactive-qa` | 1 | 互动问答 |
| level2 | `/api/reference-proxy/level2` | 3 | Level2 |
| longhubang | `/api/reference-proxy/longhubang` | 3 | 龙虎榜 |
| margin | `/api/reference-proxy/margin` | 4 | 融资融券 |
| market | `/api/reference-proxy/market` | 3 | 市场统计 |
| news | `/api/reference-proxy/news` | 1 | 资讯 |
| stock | `/api/reference-proxy/stock` | 34 | 股票数据 |
| theme | `/api/reference-proxy/theme` | 16 | 板块/题材 |

## 分组 `calendar` — 交易日历

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `tradecal` | `calendar/latest` | 最新交易日 |
| `tradecal` | `calendar/range` | 区间列表 |
| `tradecal` | `calendar/start-to-latest` | 起始至最新 |
| `tradecal` | `calendar/recent-list` | 近N日列表 |
| `tradecal` | `calendar/recent-days` | 交易日偏移 |
| `tradecal` | `calendar/by-date` | 指定交易日 |

### `tradecal` — 最新交易日

- **路径**: `POST /api/reference-proxy/calendar/latest`
- **分组**: `calendar`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{}}
```

### `tradecal` — 区间列表

- **路径**: `POST /api/reference-proxy/calendar/range`
- **分组**: `calendar`

**可用参数**:

- 必填: `startdate, enddate`
- 可选: `startdate , enddate , end_latest`

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{"startdate":"示例值"}}
```

### `tradecal` — 起始至最新

- **路径**: `POST /api/reference-proxy/calendar/start-to-latest`
- **分组**: `calendar`

**可用参数**:

- 必填: `startdate`
- 可选: `startdate`

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{"startdate":"示例值"}}
```

### `tradecal` — 近N日列表

- **路径**: `POST /api/reference-proxy/calendar/recent-list`
- **分组**: `calendar`

**可用参数**:

- 必填: `recentdays`
- 可选: `recentdays`

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{"recentdays":"示例值"}}
```

### `tradecal` — 交易日偏移

- **路径**: `POST /api/reference-proxy/calendar/recent-days`
- **分组**: `calendar`

**可用参数**:

- 必填: `tradedate_offset`
- 可选: `tradedate_offset`

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{"tradedate_offset":"示例值"}}
```

### `tradecal` — 指定交易日

- **路径**: `POST /api/reference-proxy/calendar/by-date`
- **分组**: `calendar`

**可用参数**:

- 必填: `tradedate`
- 可选: `tradedate`

**调用示例**:

```json
{"apiname":"tradecal",
 "fields":"字段1,字段2",
 "params":{"tradedate":"示例值"}}
```

## 分组 `convertible` — 可转债

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `convertible_basic` | `convertible/basic` | 基础信息 |
| `convertible_subscription` | `convertible/subscription` | 可转债发行 |
| `convertible_daily` | `convertible/daily` | 日 |
| `convertible_minute` | `convertible/minute` | 1分 |
| `convertible_minute` | `convertible/minute-5m` | 5分 |
| `convertible_minute` | `convertible/minute-15m` | 15分 |
| `convertible_minute` | `convertible/minute-30m` | 30分 |
| `convertible_minute` | `convertible/minute-60m` | 60分 |
| `None` | `convertible/tick_stream_v1` | 分笔订阅 |
| `tick` | `convertible/tick` | 分笔快照 |
| `tick_history` | `convertible/tick-history` | 分笔历史 |

### `convertible_basic` — 基础信息

- **路径**: `POST /api/reference-proxy/convertible/basic`
- **分组**: `convertible`

**可用参数**:

- 可选: `symbols , keyword , exchange , list_date , include_delisted`

**返回列**(`data.fields` 可选的列):

```
| code | symbol | bond_full_name | bond_short_name | cb_code | cb_type | CB | stk_code | stk_short_name | maturity | par | issue_price | issue_size | remain_size | value_date | maturity_date | rate_type | coupon_rate | add_rate | pay_per_year | list_date | delist_date | null | exchange | SZSE | conv_start_date | conv_end_date | conv_stop_date | first_conv_price | conv_price | rate_clause | put_clause | maturity_call_price | maturity_put_price | call_clause | reset_clause | conv_clause | guarantor | guarantee_type | issue_rating | AA | newest_rating | rating_comp |
```

**调用示例**:

```json
{"apiname":"convertible_basic",
 "fields":"code,symbol,bond_full_name",
 "params":{"symbols":"示例值"}}
```

### `convertible_subscription` — 可转债发行

- **路径**: `POST /api/reference-proxy/convertible/subscription`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , market , startdate , enddate , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| symbol | name | market | subscription_code | subscription_date | issue_price | issue_quantity | online_issue_quantity | plan_issue_size | issue_size | subscription_limit | ballot_rate | declaration_date | payment_date | listed_date |
```

**调用示例**:

```json
{"apiname":"convertible_subscription",
 "fields":"symbol,name,market",
 "params":{"symbols":"示例值"}}
```

### `convertible_daily` — 日

- **路径**: `POST /api/reference-proxy/convertible/daily`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | pre_close | open | high | low | close | change | pct_chg | vol | amount | bond_value | bond_over_rate | cb_value | cb_over_rate |
```

**调用示例**:

```json
{"apiname":"convertible_daily",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `convertible_minute` — 1分

- **路径**: `POST /api/reference-proxy/convertible/minute`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"convertible_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `convertible_minute` — 5分

- **路径**: `POST /api/reference-proxy/convertible/minute-5m`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"convertible_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `convertible_minute` — 15分

- **路径**: `POST /api/reference-proxy/convertible/minute-15m`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"convertible_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `convertible_minute` — 30分

- **路径**: `POST /api/reference-proxy/convertible/minute-30m`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"convertible_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `convertible_minute` — 60分

- **路径**: `POST /api/reference-proxy/convertible/minute-60m`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"convertible_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `None` — 分笔订阅

- **路径**: `POST /api/reference-proxy/convertible/tick_stream_v1`
- **分组**: `convertible`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**调用示例**:

```json
{"apiname":"None",
 "fields":"字段1,字段2",
 "params":{}}
```

### `tick` — 分笔快照

- **路径**: `POST /api/reference-proxy/convertible/tick`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , asset , symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| symbol | code | a | cb | time | high | open | close | low | vol | amount | pct_chg | bid1 | bid2 | bid3 | bid4 | bid5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask1 | ask2 | ask3 | ask4 | ask5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick",
 "fields":"symbol,code,a",
 "params":{"type":"示例值"}}
```

### `tick_history` — 分笔历史

- **路径**: `POST /api/reference-proxy/convertible/tick-history`
- **分组**: `convertible`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `asset , symbol , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , order_dir , limit , offset , trademin , side , start_time , end_time`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | open | high | low | close | pre_close | null | pct_chg | vol | amount | transaction_num | bid1 | bid2 | bid3 | bid4 | bid5 | ask1 | ask2 | ask3 | ask4 | ask5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick_history",
 "fields":"tradedate,symbol,time",
 "params":{"asset":"示例值"}}
```

## 分组 `etf` — ETF

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `etf_basic` | `etf/basic` | 基础信息 |
| `etf_daily` | `etf/daily` | 日 |
| `etf_share_size` | `etf/share-size` | 历史份额规模 |
| `etf_minute` | `etf/minute` | 1分 |
| `etf_minute` | `etf/minute-5m` | 5分 |
| `etf_minute` | `etf/minute-15m` | 15分 |
| `etf_minute` | `etf/minute-30m` | 30分 |
| `etf_minute` | `etf/minute-60m` | 60分 |
| `None` | `etf/tick_stream_v1` | 分笔订阅 |
| `tick` | `etf/tick` | 分笔快照 |
| `tick_history` | `etf/tick-history` | 分笔历史 |

### `etf_basic` — 基础信息

- **路径**: `POST /api/reference-proxy/etf/basic`
- **分组**: `etf`

**可用参数**:

- 可选: `symbols , keyword , market , list_date , include_delisted`

**返回列**(`data.fields` 可选的列):

```
| code | symbol | name | management | custodian | fund_type | found_date | due_date | null | list_date | issue_date | delist_date | issue_amount | m_fee | c_fee | duration_year | p_value | min_amount | exp_return | benchmark | status | L | invest_type | type | trustee | purc_startdate | redm_startdate | market | E |
```

**调用示例**:

```json
{"apiname":"etf_basic",
 "fields":"code,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `etf_daily` — 日

- **路径**: `POST /api/reference-proxy/etf/daily`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | pre_close | open | high | low | close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"etf_daily",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `etf_share_size` — 历史份额规模

- **路径**: `POST /api/reference-proxy/etf/share-size`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , limit , offset , exchange`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | total_share | total_size | nav | close | exchange | SSE |
```

**调用示例**:

```json
{"apiname":"etf_share_size",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `etf_minute` — 1分

- **路径**: `POST /api/reference-proxy/etf/minute`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"etf_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `etf_minute` — 5分

- **路径**: `POST /api/reference-proxy/etf/minute-5m`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"etf_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `etf_minute` — 15分

- **路径**: `POST /api/reference-proxy/etf/minute-15m`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"etf_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `etf_minute` — 30分

- **路径**: `POST /api/reference-proxy/etf/minute-30m`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"etf_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `etf_minute` — 60分

- **路径**: `POST /api/reference-proxy/etf/minute-60m`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"etf_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `None` — 分笔订阅

- **路径**: `POST /api/reference-proxy/etf/tick_stream_v1`
- **分组**: `etf`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**调用示例**:

```json
{"apiname":"None",
 "fields":"字段1,字段2",
 "params":{}}
```

### `tick` — 分笔快照

- **路径**: `POST /api/reference-proxy/etf/tick`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , asset , symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| symbol | code | a | e | time | high | open | close | low | vol | amount | pct_chg | bid1 | bid2 | bid3 | bid4 | bid5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask1 | ask2 | ask3 | ask4 | ask5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick",
 "fields":"symbol,code,a",
 "params":{"type":"示例值"}}
```

### `tick_history` — 分笔历史

- **路径**: `POST /api/reference-proxy/etf/tick-history`
- **分组**: `etf`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `asset , symbol , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , order_dir , limit , offset , trademin , side , start_time , end_time`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | open | high | low | close | pre_close | null | pct_chg | vol | amount | transaction_num | bid1 | bid2 | bid3 | bid4 | bid5 | ask1 | ask2 | ask3 | ask4 | ask5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick_history",
 "fields":"tradedate,symbol,time",
 "params":{"asset":"示例值"}}
```

## 分组 `finance` — 财务数据

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `finance_balance_sheet` | `finance/balance-sheet` | 资产负债表 |
| `finance_income_statement` | `finance/income-statement` | 利润表 |
| `finance_cash_flow` | `finance/cash-flow` | 现金流量表 |
| `finance_indicator` | `finance/indicator` | 财务指标 |
| `finance_capital` | `finance/capital` | 股本变动 |
| `finance_holder_number` | `finance/holder-number` | 股东户数 |
| `finance_top10_holder` | `finance/top10-holder` | 十大股东 |
| `finance_top10_float_holder` | `finance/top10-float-holder` | 十大流通股东 |
| `finance_forecast` | `finance/forecast` | 业绩预告 |
| `finance_express` | `finance/express` | 业绩快报 |
| `finance_disclosure_date` | `finance/disclosure-date` | 财报披露计划 |
| `finance_dividend` | `finance/dividend` | 分红送转 |
| `finance_announcement` | `finance/announcement` | 公告 |

### `finance_balance_sheet` — 资产负债表

- **路径**: `POST /api/reference-proxy/finance/balance-sheet`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | total_assets | total_liab | total_hldr_eqy_exc_min_int |
```

**调用示例**:

```json
{"apiname":"finance_balance_sheet",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_income_statement` — 利润表

- **路径**: `POST /api/reference-proxy/finance/income-statement`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | total_revenue | revenue | operate_profit | n_income |
```

**调用示例**:

```json
{"apiname":"finance_income_statement",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_cash_flow` — 现金流量表

- **路径**: `POST /api/reference-proxy/finance/cash-flow`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | n_cashflow_act | n_cashflow_inv_act | n_cash_flows_fnc_act |
```

**调用示例**:

```json
{"apiname":"finance_cash_flow",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_indicator` — 财务指标

- **路径**: `POST /api/reference-proxy/finance/indicator`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | eps | roe | roa | debt_to_assets | update_flag |
```

**调用示例**:

```json
{"apiname":"finance_indicator",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_capital` — 股本变动

- **路径**: `POST /api/reference-proxy/finance/capital`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | event_date | total_capital | circulating_capital | restrict_circulating_capital | free_float_capital |
```

**调用示例**:

```json
{"apiname":"finance_capital",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_holder_number` — 股东户数

- **路径**: `POST /api/reference-proxy/finance/holder-number`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | holder_num |
```

**调用示例**:

```json
{"apiname":"finance_holder_number",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_top10_holder` — 十大股东

- **路径**: `POST /api/reference-proxy/finance/top10-holder`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | rank | holder_name | hold_amount | hold_ratio |
```

**调用示例**:

```json
{"apiname":"finance_top10_holder",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_top10_float_holder` — 十大流通股东

- **路径**: `POST /api/reference-proxy/finance/top10-float-holder`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | rank | holder_name | hold_amount | hold_ratio |
```

**调用示例**:

```json
{"apiname":"finance_top10_float_holder",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_forecast` — 业绩预告

- **路径**: `POST /api/reference-proxy/finance/forecast`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | forecast_type | p_change_min | p_change_max | net_profit_min | net_profit_max | last_parent_net | first_ann_date | change_reason | update_flag | summary |
```

**调用示例**:

```json
{"apiname":"finance_forecast",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_express` — 业绩快报

- **路径**: `POST /api/reference-proxy/finance/express`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | revenue | operate_profit | total_profit | n_income | total_assets | total_hldr_eqy_exc_min_int | diluted_eps | diluted_roe | yoy_net_profit | bps | perf_summary | update_flag | is_audit | remark |
```

**调用示例**:

```json
{"apiname":"finance_express",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_disclosure_date` — 财报披露计划

- **路径**: `POST /api/reference-proxy/finance/disclosure-date`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | pre_date | actual_date | modify_date |
```

**调用示例**:

```json
{"apiname":"finance_disclosure_date",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_dividend` — 分红送转

- **路径**: `POST /api/reference-proxy/finance/dividend`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | report_date | announce_date | revision_no | version_ambiguous | false | div_proc | stk_div | cash_div | record_date | ex_date | pay_date |
```

**调用示例**:

```json
{"apiname":"finance_dividend",
 "fields":"symbol,report_date,announce_date",
 "params":{"symbols":"示例值"}}
```

### `finance_announcement` — 公告

- **路径**: `POST /api/reference-proxy/finance/announcement`
- **分组**: `finance`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , period , date , ann_startdate , ann_enddate , as_of , version , keyword , announcement_type`

**返回列**(`data.fields` 可选的列):

```
| symbol | event_date | title | summary | announcement_type | content_url |
```

**调用示例**:

```json
{"apiname":"finance_announcement",
 "fields":"symbol,event_date,title",
 "params":{"symbols":"示例值"}}
```

## 分组 `fund-flow` — 资金流向

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `northbound_flow` | `fund-flow/northbound` | 资金流向统计 |
| `southbound_flow_minute` | `fund-flow/southbound-flow-minute` | 南向资金分钟 |
| `southbound_daily` | `fund-flow/southbound-daily` | 港股通成交统计 |
| `northbound_top10` | `fund-flow/northbound-top10` | 陆股通十大成交 |
| `southbound_top10` | `fund-flow/southbound-top10` | 港股通十大成交 |
| `northbound_holding` | `fund-flow/northbound-holding` | 持股明细 |

### `northbound_flow` — 资金流向统计

- **路径**: `POST /api/reference-proxy/fund-flow/northbound`
- **分组**: `fund-flow`

**可用参数**:

- 可选: `tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | hgt | sgt | north_money | ggt_ss | ggt_ss_buy | ggt_ss_sell | ggt_ss_turnover | ggt_sz | ggt_sz_buy | ggt_sz_sell | ggt_sz_turnover | south_money | south_buy | south_sell | south_turnover |
```

**调用示例**:

```json
{"apiname":"northbound_flow",
 "fields":"tradedate,hgt,sgt",
 "params":{"tradedate":"示例值"}}
```

### `southbound_flow_minute` — 南向资金分钟

- **路径**: `POST /api/reference-proxy/fund-flow/southbound-flow-minute`
- **分组**: `fund-flow`

**可用参数**:

- 可选: `tradedate , startdate , enddate , trademin , starttrademin , endtrademin , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | trademin | ggt_ss_net_cum | ggt_ss_buy_cum | ggt_ss_sell_cum | ggt_ss_turnover_cum | ggt_sz_net_cum | ggt_sz_buy_cum | ggt_sz_sell_cum | ggt_sz_turnover_cum | south_net_cum | south_buy_cum | south_sell_cum | south_turnover_cum |
```

**调用示例**:

```json
{"apiname":"southbound_flow_minute",
 "fields":"tradedate,trademin,ggt_ss_net_cum",
 "params":{"tradedate":"示例值"}}
```

### `southbound_daily` — 港股通成交统计

- **路径**: `POST /api/reference-proxy/fund-flow/southbound-daily`
- **分组**: `fund-flow`

**可用参数**:

- 可选: `tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| trade_date | buy_amount | buy_volume | sell_amount | sell_volume |
```

**调用示例**:

```json
{"apiname":"southbound_daily",
 "fields":"trade_date,buy_amount,buy_volume",
 "params":{"tradedate":"示例值"}}
```

### `northbound_top10` — 陆股通十大成交

- **路径**: `POST /api/reference-proxy/fund-flow/northbound-top10`
- **分组**: `fund-flow`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , market_type`

**返回列**(`data.fields` 可选的列):

```
| trade_date | code | name | close | change | rank | market_type | amount | net_amount | buy | sell |
```

**调用示例**:

```json
{"apiname":"northbound_top10",
 "fields":"trade_date,code,name",
 "params":{"symbols":"示例值"}}
```

### `southbound_top10` — 港股通十大成交

- **路径**: `POST /api/reference-proxy/fund-flow/southbound-top10`
- **分组**: `fund-flow`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , market_type`

**返回列**(`data.fields` 可选的列):

```
| trade_date | code | name | close | p_change | rank | market_type | amount | net_amount | sh_amount | sh_net_amount | sh_buy | sh_sell | sz_amount | sz_net_amount | sz_buy | sz_sell |
```

**调用示例**:

```json
{"apiname":"southbound_top10",
 "fields":"trade_date,code,name",
 "params":{"symbols":"示例值"}}
```

### `northbound_holding` — 持股明细

- **路径**: `POST /api/reference-proxy/fund-flow/northbound-holding`
- **分组**: `fund-flow`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , exchange`

**返回列**(`data.fields` 可选的列):

```
| symbol | trade_date | name | vol | ratio | exchange |
```

**调用示例**:

```json
{"apiname":"northbound_holding",
 "fields":"symbol,trade_date,name",
 "params":{"symbols":"示例值"}}
```

## 分组 `index` — 指数

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `indexbasic` | `index/basic` | 基础信息 |
| `index_minute` | `index/minute` | 1分 |
| `index_minute` | `index/minute-5m` | 5分 |
| `index_minute` | `index/minute-15m` | 15分 |
| `index_minute` | `index/minute-30m` | 30分 |
| `index_minute` | `index/minute-60m` | 60分 |
| `index_snapshot` | `index/snapshot` | 分钟行情 |
| `indexdaily` | `index/indexdaily` | 日 |
| `global_index` | `index/global` | 全球 |
| `index_weekly` | `index/weekly` | 周 |
| `index_monthly` | `index/monthly` | 月 |
| `None` | `index/tick_stream_v1` | 分笔订阅 |
| `tick` | `index/tick` | 分笔快照 |
| `tick_history` | `index/tick-history` | 分笔历史 |

### `indexbasic` — 基础信息

- **路径**: `POST /api/reference-proxy/index/basic`
- **分组**: `index`

**可用参数**:

- 可选: `symbols , keyword , market , publisher , category`

**返回列**(`data.fields` 可选的列):

```
| code | symbol | name | fullname | market | CSI | publisher | index_type | category | base_date | base_point | list_date | weight_rule | desc | exp_date | null |
```

**调用示例**:

```json
{"apiname":"indexbasic",
 "fields":"code,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `index_minute` — 1分

- **路径**: `POST /api/reference-proxy/index/minute`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `index_minute` — 5分

- **路径**: `POST /api/reference-proxy/index/minute-5m`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `index_minute` — 15分

- **路径**: `POST /api/reference-proxy/index/minute-15m`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `index_minute` — 30分

- **路径**: `POST /api/reference-proxy/index/minute-30m`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `index_minute` — 60分

- **路径**: `POST /api/reference-proxy/index/minute-60m`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `index_snapshot` — 分钟行情

- **路径**: `POST /api/reference-proxy/index/snapshot`
- **分组**: `index`

**可用参数**:

- 可选: `symbols`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | open | high | low | close | pre_close | change | pct_chg | vol | amount | bid1 | bid_vol1 | servertime |
```

**调用示例**:

```json
{"apiname":"index_snapshot",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `indexdaily` — 日

- **路径**: `POST /api/reference-proxy/index/indexdaily`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , filters , order_by , order_dir , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | index_type | open | high | low | close | pre_close | change | pct_chg | vol | amount | bid1 | bid_vol1 | servertime |
```

**调用示例**:

```json
{"apiname":"indexdaily",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `global_index` — 全球

- **路径**: `POST /api/reference-proxy/index/global`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , filters , order_by , order_dir , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | XIN9 | name | open | high | low | close | pre_close | change | pct_chg | swing | vol | null | amount |
```

**调用示例**:

```json
{"apiname":"global_index",
 "fields":"tradedate,symbol,XIN9",
 "params":{"symbols":"示例值"}}
```

### `index_weekly` — 周

- **路径**: `POST /api/reference-proxy/index/weekly`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | index_type | open | high | low | close | pre_close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_weekly",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `index_monthly` — 月

- **路径**: `POST /api/reference-proxy/index/monthly`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | index_type | open | high | low | close | pre_close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"index_monthly",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `None` — 分笔订阅

- **路径**: `POST /api/reference-proxy/index/tick_stream_v1`
- **分组**: `index`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**调用示例**:

```json
{"apiname":"None",
 "fields":"字段1,字段2",
 "params":{}}
```

### `tick` — 分笔快照

- **路径**: `POST /api/reference-proxy/index/tick`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , asset , symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| symbol | code | a | i | time | high | open | close | low | vol | amount | pct_chg | bid1 | bid2 | bid3 | bid4 | bid5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask1 | ask2 | ask3 | ask4 | ask5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick",
 "fields":"symbol,code,a",
 "params":{"type":"示例值"}}
```

### `tick_history` — 分笔历史

- **路径**: `POST /api/reference-proxy/index/tick-history`
- **分组**: `index`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `asset , symbol , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , order_dir , limit , offset , trademin , side , start_time , end_time`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | open | high | low | close | pre_close | null | pct_chg | vol | amount | transaction_num | bid1 | bid2 | bid3 | bid4 | bid5 | ask1 | ask2 | ask3 | ask4 | ask5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick_history",
 "fields":"tradedate,symbol,time",
 "params":{"asset":"示例值"}}
```

## 分组 `interactive-qa` — 互动问答

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `interactive_qa` | `interactive-qa` | 问董秘 |

### `interactive_qa` — 问董秘

- **路径**: `POST /api/reference-proxy/interactive-qa`
- **分组**: `interactive-qa`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , limit , offset , date , qa_id , keyword , version`

**返回列**(`data.fields` 可选的列):

```
| symbol | event_date | qa_id | question_time | question | answer_time | answer | revision_no | version_ambiguous | false |
```

**调用示例**:

```json
{"apiname":"interactive_qa",
 "fields":"symbol,event_date,qa_id",
 "params":{"symbols":"示例值"}}
```

## 分组 `level2` — Level2

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `level2_quote_history` | `level2/quote-history` | 十档盘口 |
| `level2_trade_history` | `level2/trade-history` | 逐笔成交 |
| `level2_order_history` | `level2/order-history` | 逐笔委托 |

### `level2_quote_history` — 十档盘口

- **路径**: `POST /api/reference-proxy/level2/quote-history`
- **分组**: `level2`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `symbol, tradedate`
- 可选: `symbol , tradedate , start_time , end_time , page_size , cursor`

**返回列**(`data.fields` 可选的列):

```
| symbol | tradedate | time | open | high | low | close | pre_close | volume | amount | bid1 | ask1 | bid2 | ask2 | bid3 | ask3 | bid4 | ask4 | bid5 | ask5 | bid6 | ask6 | bid7 | ask7 | bid8 | ask8 | bid9 | ask9 | bid10 | ask10 | bid_vol1 | ask_vol1 | bid_vol2 | ask_vol2 | bid_vol3 | ask_vol3 | bid_vol4 | ask_vol4 | bid_vol5 | ask_vol5 | bid_vol6 | ask_vol6 | bid_vol7 | ask_vol7 | bid_vol8 | ask_vol8 | bid_vol9 | ask_vol9 | bid_vol10 | ask_vol10 |
```

**调用示例**:

```json
{"apiname":"level2_quote_history",
 "fields":"symbol,tradedate,time",
 "params":{"symbol":"示例值"}}
```

### `level2_trade_history` — 逐笔成交

- **路径**: `POST /api/reference-proxy/level2/trade-history`
- **分组**: `level2`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `symbol, tradedate`
- 可选: `symbol , tradedate , start_time , end_time , page_size , cursor`

**返回列**(`data.fields` 可选的列):

```
| symbol | tradedate | time | trade_id | price | volume | amount | bs_flag | trade_code | buy_order_id | sell_order_id |
```

**调用示例**:

```json
{"apiname":"level2_trade_history",
 "fields":"symbol,tradedate,time",
 "params":{"symbol":"示例值"}}
```

### `level2_order_history` — 逐笔委托

- **路径**: `POST /api/reference-proxy/level2/order-history`
- **分组**: `level2`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `symbol, tradedate`
- 可选: `symbol , tradedate , start_time , end_time , page_size , cursor`

**返回列**(`data.fields` 可选的列):

```
| symbol | tradedate | time | order_id | price | volume | amount | side | order_type | order_no |
```

**调用示例**:

```json
{"apiname":"level2_order_history",
 "fields":"symbol,tradedate,time",
 "params":{"symbol":"示例值"}}
```

## 分组 `longhubang` — 龙虎榜

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `longhubang_stock` | `longhubang/stock` | 上榜个股 |
| `longhubang_seat` | `longhubang/seat` | 买卖席位 |
| `longhubang_hot_money` | `longhubang/hot-money` | 游资名单 |

### `longhubang_stock` — 上榜个股

- **路径**: `POST /api/reference-proxy/longhubang/stock`
- **分组**: `longhubang`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | close | pct_chg | turnover_rate | amount | lhb_sell | lhb_buy | lhb_amount | net_amount | net_rate | amount_rate | float_value | reason |
```

**调用示例**:

```json
{"apiname":"longhubang_stock",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `longhubang_seat` — 买卖席位

- **路径**: `POST /api/reference-proxy/longhubang/seat`
- **分组**: `longhubang`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , side`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | reason | side | seat_name | buy | buy_rate | sell | sell_rate | net_buy |
```

**调用示例**:

```json
{"apiname":"longhubang_seat",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `longhubang_hot_money` — 游资名单

- **路径**: `POST /api/reference-proxy/longhubang/hot-money`
- **分组**: `longhubang`

**可用参数**:

- 可选: `name`

**返回列**(`data.fields` 可选的列):

```
| name | description | seats |
```

**调用示例**:

```json
{"apiname":"longhubang_hot_money",
 "fields":"name,description,seats",
 "params":{"name":"示例值"}}
```

## 分组 `margin` — 融资融券

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `margin_summary` | `margin/summary` | 两融概况 |
| `margin_securities` | `margin/securities` | 两融标的 |
| `margin_detail` | `margin/detail` | 个股交易明细 |
| `transfer_financing` | `margin/transfer-financing` | 转融资 |

### `margin_summary` — 两融概况

- **路径**: `POST /api/reference-proxy/margin/summary`
- **分组**: `margin`

**可用参数**:

- 可选: `tradedate , startdate , enddate , recentdays , exchange`

**返回列**(`data.fields` 可选的列):

```
| tradedate | exchange | financing_balance | financing_buy_amount | financing_repayment_amount | securities_lending_balance | securities_lending_sell_quantity | securities_lending_outstanding_quantity | margin_balance |
```

**调用示例**:

```json
{"apiname":"margin_summary",
 "fields":"tradedate,exchange,financing_balance",
 "params":{"tradedate":"示例值"}}
```

### `margin_securities` — 两融标的

- **路径**: `POST /api/reference-proxy/margin/securities`
- **分组**: `margin`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , exchange`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | exchange |
```

**调用示例**:

```json
{"apiname":"margin_securities",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `margin_detail` — 个股交易明细

- **路径**: `POST /api/reference-proxy/margin/detail`
- **分组**: `margin`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , exchange`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | exchange | financing_balance | financing_buy_amount | financing_repayment_amount | securities_lending_balance | securities_lending_sell_quantity | securities_lending_outstanding_quantity | securities_lending_repayment_quantity | margin_balance |
```

**调用示例**:

```json
{"apiname":"margin_detail",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `transfer_financing` — 转融资

- **路径**: `POST /api/reference-proxy/margin/transfer-financing`
- **分组**: `margin`

**可用参数**:

- 可选: `tradedate , startdate , enddate , recentdays`

**返回列**(`data.fields` 可选的列):

```
| tradedate | opening_balance | auction_amount | reborrow_amount | repayment_amount | closing_balance |
```

**调用示例**:

```json
{"apiname":"transfer_financing",
 "fields":"tradedate,opening_balance,auction_amount",
 "params":{"tradedate":"示例值"}}
```

## 分组 `market` — 市场统计

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `emoindic_daily` | `market/emoindic-daily` | 情绪周期 |
| `theme_daily` | `market/theme-style-daily` | 风格板块 |
| `theme_daily` | `market/theme-stat-daily` | 统计指数 |

### `emoindic_daily` — 情绪周期

- **路径**: `POST /api/reference-proxy/market/emoindic-daily`
- **分组**: `market`

**可用参数**:

- 可选: `tradedate , startdate , enddate , recentdays`

**返回列**(`data.fields` 可选的列):

```
| tradedate | s2 | s6 | s10 | s3 | s4 | s5 | s7 | s8 | s9 | u | u5 | yes_u5 | u12 | fp108 | u6 | d3 | l1 | l1_amount | l2 | l2_amount | l3 | l3_amount | l2up | l2up_amount | yes_l2up_amount | l3up | l3up_amount | yes_l3up_amount | l4up | l4up_amount | yes_l4up_amount | l17 | l21 | l22 | l2up_rate | deep_retrace_count | ztwme | ztwme_count | ztwme20 | owfd_overnight | owfd_0920 | owfd_0925 | owfd_0925_count | am_pred | am_pred_pct | am_pred_diff | am | am_diff | mf_main | mf_auction_main |
```

**调用示例**:

```json
{"apiname":"emoindic_daily",
 "fields":"tradedate,s2,s6",
 "params":{"tradedate":"示例值"}}
```

### `theme_daily` — 风格板块

- **路径**: `POST /api/reference-proxy/market/theme-style-daily`
- **分组**: `market`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `type`
- 可选: `type , symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | fg | open | high | low | close | pre_close | change | pct_chg | vol | amount | servertime |
```

**调用示例**:

```json
{"apiname":"theme_daily",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

### `theme_daily` — 统计指数

- **路径**: `POST /api/reference-proxy/market/theme-stat-daily`
- **分组**: `market`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `type`
- 可选: `type , symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | tj | open | high | low | close | pre_close | change | pct_chg | vol | amount | servertime |
```

**调用示例**:

```json
{"apiname":"theme_daily",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

## 分组 `news` — 资讯

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `news` | `news` | 新闻 |

### `news` — 新闻

- **路径**: `POST /api/reference-proxy/news`
- **分组**: `news`

**可用参数**:

- 可选: `limit , view , sources , keyword`

**返回列**(`data.fields` 可选的列):

```
| published_at | display_at | time_label | source | cls_depth_1000 | source_name | title | summary | url | image | rank | source_id | item_type | top_article | updated_at |
```

**调用示例**:

```json
{"apiname":"news",
 "fields":"published_at,display_at,time_label",
 "params":{"limit":"示例值"}}
```

## 分组 `stock` — 股票数据

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `stockbasic` | `stock/basic` | 基本信息 |
| `new_share` | `stock/new-share` | 新股发行 |
| `screening` | `stock/screening` | 实时选股 |
| `None` | `stock/tick_stream_v1` | 分笔订阅 |
| `None` | `stock/stream_limit_event_v2` | 异动订阅 |
| `limit_event_v2_history` | `stock/limit_event_v2_history` | 历史异动 |
| `tick` | `stock/tick` | 分笔快照 |
| `tick_history` | `stock/tick-history` | 分笔历史 |
| `daily_auc` | `stock/daily_auc` | 竞价指标 |
| `daily_auc_detail` | `stock/daily_auc_detail` | 竞价分笔 |
| `tick_history` | `stock/last-tick` | 竞价抢筹 |
| `auc_kp` | `stock/auc-kp` | 涨停委买 |
| `daily_auc_fd` | `stock/daily_auc_fd` | 竞价一字 |
| `daily` | `stock/daily` | 日 |
| `weekly` | `stock/weekly` | 周 |
| `monthly` | `stock/monthly` | 月 |
| `minute` | `stock/minute` | 1分 |
| `minute` | `stock/minute-5m` | 5分 |
| `minute` | `stock/minute-15m` | 15分 |
| `minute` | `stock/minute-30m` | 30分 |
| `minute` | `stock/minute-60m` | 60分 |
| `tick_fd` | `stock/tick-fd` | 分笔封单 |
| `valuation` | `stock/valuation` | 估值指标 |
| `adj_factor` | `stock/adj-factor` | 复权因子 |
| `stk_factor_pro` | `stock/stk-factor-pro` | 复权行情 |
| `limit_pool` | `stock/limit-pool` | 涨跌停池 |
| `limit_pool_yes` | `stock/limit-pool-yes` | 昨日涨停 |
| `suspend` | `stock/suspend` | 停牌复牌 |
| `st` | `stock/st` | ST列表 |
| `point_monitor` | `stock/point-monitor` | 交易监管 |
| `anomaly_forecast` | `stock/anomaly-forecast` | 严重异动预测 |
| `pricelimit` | `stock/pricelimit` | 涨跌停价 |
| `hotstock` | `stock/hotstock` | 实时热搜 |
| `fengk_kp` | `stock/fengk-kp` | 最强风口 |

### `stockbasic` — 基本信息

- **路径**: `POST /api/reference-proxy/stock/basic`
- **分组**: `stock`

**可用参数**:

- 可选: `symbols , keyword , list_status , market , exchange , industry`

**返回列**(`data.fields` 可选的列):

```
| code | symbol | name | area | industry | fullname | enname | cnspell | PAYH | market | exchange | SZSE | curr_type | CNY | list_status | L | list_date | delist_date | null | is_hs | S | act_name | act_ent_type |
```

**调用示例**:

```json
{"apiname":"stockbasic",
 "fields":"code,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `new_share` — 新股发行

- **路径**: `POST /api/reference-proxy/stock/new-share`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , market , startdate , enddate , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| symbol | name | market | subscription_code | subscription_date | issue_price | listed_date | declaration_date | payment_date | subscription_limit | ballot_rate | issue_quantity | online_issue_quantity | pe | industry_pe |
```

**调用示例**:

```json
{"apiname":"new_share",
 "fields":"symbol,name,market",
 "params":{"symbols":"示例值"}}
```

### `screening` — 实时选股

- **路径**: `POST /api/reference-proxy/stock/screening`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | open | high | low | close | pre_close | change | pct_chg | vol | amount | up_limit | down_limit | is_st | false | turnover_rate_f | volume_ratio | free_float_mv | circ_mv | total_mv | type | u | is_break | limit_times | pre_limit_times | fd_amount | pre_fd_amount | prev_fd_amount | fd_to_turnover | fd_to_yesterday | first_time | last_time | m_price | auc_pct_chg | auc_net_amount | auc_amt | auc_vol | auc_turnover | ztwme | ztwme20 | fa_0915 | fa_0920f | fa_0925l | theme_names_xgb | theme_names_kpl | theme_names_jygs | reason_xgb | reason_kpl | reason_jygs | reason_main_kpl | reason_main_jygs | hot_ths_normal_rank | hot_dfcf_biaos_rank | hot_xq_resou_rank | hot_tdx_resou_rank |
```

**调用示例**:

```json
{"apiname":"screening",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `None` — 分笔订阅

- **路径**: `POST /api/reference-proxy/stock/tick_stream_v1`
- **分组**: `stock`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**调用示例**:

```json
{"apiname":"None",
 "fields":"字段1,字段2",
 "params":{}}
```

### `None` — 异动订阅

- **路径**: `POST /api/reference-proxy/stock/stream_limit_event_v2`
- **分组**: `stock`

**可用参数**:

- 无参数（或参数在 `params` 外的顶层字段）

**返回列**(`data.fields` 可选的列):

```
| tradedate | servertime | last_price | limit_price | amount | turnover_rate | fd_amount | trade_amount_3s | fd_decrease_12s | fd_decrease_rate_12s | limit_times | open_times |
```

**调用示例**:

```json
{"apiname":"None",
 "fields":"tradedate,servertime,last_price",
 "params":{}}
```

### `limit_event_v2_history` — 历史异动

- **路径**: `POST /api/reference-proxy/stock/limit_event_v2_history`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , event_types , tradedate , startdate , enddate , recentdays`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | time | event | servertime | last_price | limit_price | amount | turnover_rate | fd_amount | trade_amount_3s | fd_decrease_12s | fd_decrease_rate_12s | limit_times | open_times |
```

**调用示例**:

```json
{"apiname":"limit_event_v2_history",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `tick` — 分笔快照

- **路径**: `POST /api/reference-proxy/stock/tick`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , asset , symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| symbol | code | a | s | time | high | open | close | low | vol | amount | pct_chg | bid1 | bid2 | bid3 | bid4 | bid5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask1 | ask2 | ask3 | ask4 | ask5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick",
 "fields":"symbol,code,a",
 "params":{"type":"示例值"}}
```

### `tick_history` — 分笔历史

- **路径**: `POST /api/reference-proxy/stock/tick-history`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `asset , symbol , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , order_dir , limit , offset , trademin , side , start_time , end_time`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | open | high | low | close | pre_close | null | pct_chg | vol | amount | transaction_num | bid1 | bid2 | bid3 | bid4 | bid5 | ask1 | ask2 | ask3 | ask4 | ask5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick_history",
 "fields":"tradedate,symbol,time",
 "params":{"asset":"示例值"}}
```

### `daily_auc` — 竞价指标

- **路径**: `POST /api/reference-proxy/stock/daily_auc`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | m_price | auc_pct_chg | open_bid_pct | auc_amt | auc_vol | auc_vol_ratio | auc_to_pre_vol_pct | auc_to_pre_auc_vol_ratio | um_vol | auc_turnover_rate | auc_turnover |
```

**调用示例**:

```json
{"apiname":"daily_auc",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `daily_auc_detail` — 竞价分笔

- **路径**: `POST /api/reference-proxy/stock/daily_auc_detail`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , order_dir , limit , offset , trademin , side , start_time , end_time`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | m_price | auc_pct_chg | auc_vol | auc_amt | um_vol | um_side | b | auc_turnover_rate | auc_turnover | auc_to_pre_vol_pct |
```

**调用示例**:

```json
{"apiname":"daily_auc_detail",
 "fields":"tradedate,symbol,time",
 "params":{"symbols":"示例值"}}
```

### `tick_history` — 竞价抢筹

- **路径**: `POST /api/reference-proxy/stock/last-tick`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `asset , symbols , tradedate , tradedate_offset , limit , offset , trademin , side`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | time | open | high | low | close | pre_close | null | pct_chg | vol | amount | transaction_num | bid1 | bid2 | bid3 | bid4 | bid5 | ask1 | ask2 | ask3 | ask4 | ask5 | bid_vol1 | bid_vol2 | bid_vol3 | bid_vol4 | bid_vol5 | ask_vol1 | ask_vol2 | ask_vol3 | ask_vol4 | ask_vol5 |
```

**调用示例**:

```json
{"apiname":"tick_history",
 "fields":"tradedate,symbol,time",
 "params":{"asset":"示例值"}}
```

### `auc_kp` — 涨停委买

- **路径**: `POST /api/reference-proxy/stock/auc-kp`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | ztwme | ztwme20 | pre_ztwme | prev_ztwme | auc_net_amount | close | limit_times | pre_limit_times | auc_pct_chg | pct_chg | theme_names_kpl | theme_names_xgb | latest_theme_names_kpl | latest_theme_names_xgb | auc_amount | auc_vol_ratio | auc_turnover | prev_turnover_rate_f | free_float_mv | fd_amount | is_st | FALSE |
```

**调用示例**:

```json
{"apiname":"auc_kp",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `daily_auc_fd` — 竞价一字

- **路径**: `POST /api/reference-proxy/stock/daily_auc_fd`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | auc_pct_chg | theme_names_kpl | theme_names_xgb | auc_amt | auc_turnover | fa_0915 | fa_0916 | fa_0917 | fa_0918 | fa_0919 | fa_0920 | fa_0921 | fa_0922 | fa_0923 | fa_0924 | fa_0925 | fa_0920f | fa_0925l | is_st | FALSE |
```

**调用示例**:

```json
{"apiname":"daily_auc_fd",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `daily` — 日

- **路径**: `POST /api/reference-proxy/stock/daily`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | open | high | low | close | pre_close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"daily",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `weekly` — 周

- **路径**: `POST /api/reference-proxy/stock/weekly`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | open | high | low | close | pre_close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"weekly",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `monthly` — 月

- **路径**: `POST /api/reference-proxy/stock/monthly`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | open | high | low | close | pre_close | change | pct_chg | vol | amount |
```

**调用示例**:

```json
{"apiname":"monthly",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `minute` — 1分

- **路径**: `POST /api/reference-proxy/stock/minute`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `minute` — 5分

- **路径**: `POST /api/reference-proxy/stock/minute-5m`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `minute` — 15分

- **路径**: `POST /api/reference-proxy/stock/minute-15m`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `minute` — 30分

- **路径**: `POST /api/reference-proxy/stock/minute-30m`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `minute` — 60分

- **路径**: `POST /api/reference-proxy/stock/minute-60m`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , trademin , period`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | trademin | time | open | high | low | close | vol | amount | vwap |
```

**调用示例**:

```json
{"apiname":"minute",
 "fields":"tradedate,symbol,trademin",
 "params":{"symbols":"示例值"}}
```

### `tick_fd` — 分笔封单

- **路径**: `POST /api/reference-proxy/stock/tick-fd`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `symbol`
- 可选: `symbol , tradedate , trademin`

**返回列**(`data.fields` 可选的列):

```
| symbol | tradedate | trademin | time | fd_amount | bid1 | bid_vol1 | close |
```

**调用示例**:

```json
{"apiname":"tick_fd",
 "fields":"symbol,tradedate,trademin",
 "params":{"symbol":"示例值"}}
```

### `valuation` — 估值指标

- **路径**: `POST /api/reference-proxy/stock/valuation`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | close | turnover_rate | turnover_rate_f | volume_ratio | pe | pe_ttm | pb | ps | ps_ttm | dv_ratio | dv_ttm | total_share | float_share | free_share | free_mv | total_mv | circ_mv |
```

**调用示例**:

```json
{"apiname":"valuation",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `adj_factor` — 复权因子

- **路径**: `POST /api/reference-proxy/stock/adj-factor`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | code | adj_factor |
```

**调用示例**:

```json
{"apiname":"adj_factor",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `stk_factor_pro` — 复权行情

- **路径**: `POST /api/reference-proxy/stock/stk-factor-pro`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , symbol , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | open | open_hfq | open_qfq | high | high_hfq | high_qfq | low | low_hfq | low_qfq | close | close_hfq | close_qfq | pre_close | change | pct_chg | vol | amount | turnover_rate | turnover_rate_f | volume_ratio | pe | pe_ttm | pb | ps | ps_ttm | dv_ratio | dv_ttm | total_share | float_share | free_share | total_mv | circ_mv | adj_factor |
```

**调用示例**:

```json
{"apiname":"stk_factor_pro",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `limit_pool` — 涨跌停池

- **路径**: `POST /api/reference-proxy/stock/limit-pool`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , is_break`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | u | pre_type | is_break | false | limit_times | pre_limit_times | fd_amount | first_time | last_time | open_times | limit_detail | limit_type | close | pct_chg | amount | turnover_z | pre_fd_amount | prev_fd_amount | pre_ztwme | prev_ztwme | theme_names_xgb | latest_theme_names_xgb | reason_xgb | theme_names_kpl | latest_theme_names_kpl | reason_main_kpl | reason_kpl | theme_names_jygs | latest_theme_names_jygs | reason_main_jygs | reason_jygs |
```

**调用示例**:

```json
{"apiname":"limit_pool",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

### `limit_pool_yes` — 昨日涨停

- **路径**: `POST /api/reference-proxy/stock/limit-pool-yes`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , symbols , tradedate , is_break`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | u | pre_type | is_break | false | pre_limit_times | pre_fd_amount | prev_fd_amount | pre_close | pre_pct_chg | pre_amount | pre_vol | prev_turnover_rate_f | pre_auc_vol | pre_ztwme | prev_ztwme | first_time | last_time | open_times | limit_type | latest_theme_names_xgb | m_price | auc_pct_chg | auc_amt | auc_vol_ratio | auc_turnover | pct_chg_pub | amount_pub |
```

**调用示例**:

```json
{"apiname":"limit_pool_yes",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

### `suspend` — 停牌复牌

- **路径**: `POST /api/reference-proxy/stock/suspend`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , startdate , enddate , suspend_type`

**返回列**(`data.fields` 可选的列):

```
| symbol | tradedate | suspend_type | S | suspend_timing |
```

**调用示例**:

```json
{"apiname":"suspend",
 "fields":"symbol,tradedate,suspend_type",
 "params":{"symbols":"示例值"}}
```

### `st` — ST列表

- **路径**: `POST /api/reference-proxy/stock/st`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , symbols , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | ST | type_name |
```

**调用示例**:

```json
{"apiname":"st",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

### `point_monitor` — 交易监管

- **路径**: `POST /api/reference-proxy/stock/point-monitor`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , symbols , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| type | symbol | name | startdate | enddate | reason |
```

**调用示例**:

```json
{"apiname":"point_monitor",
 "fields":"type,symbol,name",
 "params":{"type":"示例值"}}
```

### `anomaly_forecast` — 严重异动预测

- **路径**: `POST /api/reference-proxy/stock/anomaly-forecast`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | pct_chg | rule | elapsed_days | deviation_pct | required_pct_chg | trigger_price | status | reachable |
```

**调用示例**:

```json
{"apiname":"anomaly_forecast",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `pricelimit` — 涨跌停价

- **路径**: `POST /api/reference-proxy/stock/pricelimit`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | pre_close | up_limit | down_limit |
```

**调用示例**:

```json
{"apiname":"pricelimit",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `hotstock` — 实时热搜

- **路径**: `POST /api/reference-proxy/stock/hotstock`
- **分组**: `stock`

**可用参数**:

- 必填: `type`
- 可选: `type , tradedate`

**返回列**(`data.fields` 可选的列):

```
| s | n | pc | rank | tradedate | type |
```

**调用示例**:

```json
{"apiname":"hotstock",
 "fields":"s,n,pc",
 "params":{"type":"示例值"}}
```

### `fengk_kp` — 最强风口

- **路径**: `POST /api/reference-proxy/stock/fengk-kp`
- **分组**: `stock`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | rank | strength | pct_chg | main_net_amount | main_buy_amount | main_sell_amount | signal_time | selected_themes |
```

**调用示例**:

```json
{"apiname":"fengk_kp",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

## 分组 `theme` — 板块/题材

| 接口名(apiname) | 路径 | 说明 |
|---|---|---|
| `theme_industry` | `theme/industry` | 行业板块 |
| `theme_concept` | `theme/concept` | 概念板块 |
| `theme_members` | `theme/members` | 成份股 |
| `theme_daily` | `theme/daily` | 日线行情 |
| `thememembers_jx` | `theme/jx-members` | 股票池 |
| `thememembers_jx` | `theme/jx-authentic` | 最正宗 |
| `thememembers_jx` | `theme/jx-long` | 龙排名 |
| `themedaily_jx` | `theme/themedaily_jx` | 一级板块 |
| `themedaily_jx` | `theme/themedaily_jx-child` | 二级板块 |
| `thememinute_jx` | `theme/minute-stat` | 5分统计 |
| `themefundflow_jx` | `theme/themefundflow-jx` | 当日资金流向 |
| `theme_auc_kp` | `theme/theme_auc_kp` | 板块竞价 |
| `fundflow_kp` | `theme/fundflow-kp` | 主力净额 |
| `theme_lib_kp` | `theme/lib-kp` | 题材库 |
| `theme_lib_detail_kp` | `theme/lib-detail-kp` | 题材库详情 |
| `theme_reason` | `theme/reason` | 板块原因 |

### `theme_industry` — 行业板块

- **路径**: `POST /api/reference-proxy/theme/industry`
- **分组**: `theme`

**可用参数**:

- 可选: `type , symbols , symbol , name`

**调用示例**:

```json
{"apiname":"theme_industry",
 "fields":"字段1,字段2",
 "params":{"type":"示例值"}}
```

### `theme_concept` — 概念板块

- **路径**: `POST /api/reference-proxy/theme/concept`
- **分组**: `theme`

**可用参数**:

- 可选: `symbols , symbol , name`

**调用示例**:

```json
{"apiname":"theme_concept",
 "fields":"字段1,字段2",
 "params":{"symbols":"示例值"}}
```

### `theme_members` — 成份股

- **路径**: `POST /api/reference-proxy/theme/members`
- **分组**: `theme`

**可用参数**:

- 可选: `type , theme_symbols , symbols , symbol , theme_symbol`

**调用示例**:

```json
{"apiname":"theme_members",
 "fields":"字段1,字段2",
 "params":{"type":"示例值"}}
```

### `theme_daily` — 日线行情

- **路径**: `POST /api/reference-proxy/theme/daily`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `type , symbols , symbol , tradedate , startdate , enddate`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | type | open | high | low | close | pct_chg | amount |
```

**调用示例**:

```json
{"apiname":"theme_daily",
 "fields":"tradedate,symbol,name",
 "params":{"type":"示例值"}}
```

### `thememembers_jx` — 股票池

- **路径**: `POST /api/reference-proxy/theme/jx-members`
- **分组**: `theme`

**可用参数**:

- 可选: `level , theme_symbols , symbols`

**调用示例**:

```json
{"apiname":"thememembers_jx",
 "fields":"字段1,字段2",
 "params":{"level":"示例值"}}
```

### `thememembers_jx` — 最正宗

- **路径**: `POST /api/reference-proxy/theme/jx-authentic`
- **分组**: `theme`

**可用参数**:

- 可选: `level , theme_symbols , symbols , tag`

**调用示例**:

```json
{"apiname":"thememembers_jx",
 "fields":"字段1,字段2",
 "params":{"level":"示例值"}}
```

### `thememembers_jx` — 龙排名

- **路径**: `POST /api/reference-proxy/theme/jx-long`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `level , theme_symbols , symbols , tradedate , tag`

**调用示例**:

```json
{"apiname":"thememembers_jx",
 "fields":"字段1,字段2",
 "params":{"level":"示例值"}}
```

### `themedaily_jx` — 一级板块

- **路径**: `POST /api/reference-proxy/theme/themedaily_jx`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `level , theme_symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | theme_symbol | theme_name | level | parent | p_symbol | null | strength | pct_chg | chg_speed | amount | main_net_amount | main_buy_amount | main_sell_amount | turnover_rate | volume_ratio | circ_mv | prev_pct_chg | big_order_net_amount | total_mv |
```

**调用示例**:

```json
{"apiname":"themedaily_jx",
 "fields":"tradedate,theme_symbol,theme_name",
 "params":{"level":"示例值"}}
```

### `themedaily_jx` — 二级板块

- **路径**: `POST /api/reference-proxy/theme/themedaily_jx-child`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `level , theme_symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | theme_symbol | theme_name | level | child | p_symbol | strength | pct_chg | chg_speed | amount | main_net_amount | main_buy_amount | main_sell_amount | turnover_rate | volume_ratio | circ_mv | prev_pct_chg | big_order_net_amount | total_mv |
```

**调用示例**:

```json
{"apiname":"themedaily_jx",
 "fields":"tradedate,theme_symbol,theme_name",
 "params":{"level":"示例值"}}
```

### `thememinute_jx` — 5分统计

- **路径**: `POST /api/reference-proxy/theme/minute-stat`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `level , theme_symbols , tradedate , startdate , enddate , recentdays , trademin , start_trademin , end_trademin , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | trademin | theme_symbol | theme_name | level | parent | p_symbol | null | window_start | window_end | strength | pct_chg | chg_speed | amount | main_net_amount | main_buy_amount | main_sell_amount | turnover_rate | volume_ratio | circ_mv | prev_pct_chg | big_order_net_amount | total_mv |
```

**调用示例**:

```json
{"apiname":"thememinute_jx",
 "fields":"tradedate,trademin,theme_symbol",
 "params":{"level":"示例值"}}
```

### `themefundflow_jx` — 当日资金流向

- **路径**: `POST /api/reference-proxy/theme/themefundflow-jx`
- **分组**: `theme`

**可用参数**:

- 可选: `level , theme_symbols , trademin , start_trademin , end_trademin , order_by , order_dir , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | trademin | theme_symbol | theme_name | level | child | p_symbol | main_net_amount | main_buy_amount | main_sell_amount |
```

**调用示例**:

```json
{"apiname":"themefundflow_jx",
 "fields":"tradedate,trademin,theme_symbol",
 "params":{"level":"示例值"}}
```

### `theme_auc_kp` — 板块竞价

- **路径**: `POST /api/reference-proxy/theme/theme_auc_kp`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `groups , theme_symbols , tradedate`

**返回列**(`data.fields` 可选的列):

```
| source_day | group | List1 | group_rank | theme_symbol | theme_name | bid_volume_burst | abnormal_amount | bid_volume | main_net_amount |
```

**调用示例**:

```json
{"apiname":"theme_auc_kp",
 "fields":"source_day,group,List1",
 "params":{"groups":"示例值"}}
```

### `fundflow_kp` — 主力净额

- **路径**: `POST /api/reference-proxy/theme/fundflow-kp`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 可选: `symbols , tradedate , startdate , enddate , recentdays , tradedate_offset , filters , order_by , order_dir , limit , offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | main_net_amount | main_buy_amount | main_sell_amount | auction_main_net_amount | auction_main_buy_amount | auction_main_sell_amount |
```

**调用示例**:

```json
{"apiname":"fundflow_kp",
 "fields":"tradedate,symbol,name",
 "params":{"symbols":"示例值"}}
```

### `theme_lib_kp` — 题材库

- **路径**: `POST /api/reference-proxy/theme/lib-kp`
- **分组**: `theme`

**可用参数**:

- 可选: `theme_ids`

**返回列**(`data.fields` 可选的列):

```
| theme_id | name |
```

**调用示例**:

```json
{"apiname":"theme_lib_kp",
 "fields":"theme_id,name",
 "params":{"theme_ids":"示例值"}}
```

### `theme_lib_detail_kp` — 题材库详情

- **路径**: `POST /api/reference-proxy/theme/lib-detail-kp`
- **分组**: `theme`

**可用参数**:

- 必填: `theme_id`
- 可选: `theme_id`

**调用示例**:

```json
{"apiname":"theme_lib_detail_kp",
 "fields":"字段1,字段2",
 "params":{"theme_id":"示例值"}}
```

### `theme_reason` — 板块原因

- **路径**: `POST /api/reference-proxy/theme/reason`
- **分组**: `theme`
- **类型**: 时间序列（支持按标的 × 日期范围，自动缓存合并）

**可用参数**:

- 必填: `source`
- 可选: `source , symbols , tradedate , startdate , enddate , recentdays , tradedate_offset`

**返回列**(`data.fields` 可选的列):

```
| tradedate | symbol | name | source | xgb | reason |
```

**调用示例**:

```json
{"apiname":"theme_reason",
 "fields":"tradedate,symbol,name",
 "params":{"source":"示例值"}}
```