实时行情 {#realtime}

GET /v1/realtime?symbol=603778.SS
GET /v1/realtime?symbol=000001.SS
GET /v1/realtime?symbol=600519.SS&symbol=603778.SS
GET /v1/realtime?symbol=600519.SS,000001.SS
GET /v1/realtime?symbol=603778.SS&include_valuation=true
GET /v1/realtime?symbol=603778.SS&include_depth=true

单只时 data 为对象；多只时 data 为数组。部分未命中时 HTTP 200，meta.missing 列出未找到的代码。指数响应 meta.instrument_type 为 index。

include_valuation=true 时额外返回：

需 realtime_valuation scope（默认映射见 realtime_feature_gates）。

include_depth=true 时额外返回 depth（需 realtime_depth scope，映射见 realtime_feature_gates）：

需 realtime 权限（基础版及以上）。当前 Key 单次上限见 GET /v1/me 的 max_realtime_symbols。

ETF 不可走本接口（返回 400），须改用 /v1/etf/realtime 等专用路径。

北交所不可走本接口（返回 400），须改用 /v1/bj/kline 或 /v1/bj/trend。

主要指数 {#indices}

实时、分时、K 线接口支持多个主要指数（与个股共用 realtime / trend / kline scope）。完整列表：

GET /public/v1/indices

响应 data[] 含 symbol、name、group；股指期货类另含 futures（IF/IH/IC/IM）。

裸写 000001 会解析为个股平安银行（000001.SZ），查询上证请用 000001.SS。

暂未提供行情数据的指数（如北证50 899050、中证2000 932000、中证全指 000985）。

指数 K 线无复权，统一按 adjust_type=none 返回（见 meta.hints）。

分时图 {#trend}

GET /v1/trend?symbol=300042.SZ
GET /v1/trend?symbol=000001.SS
GET /v1/trend?symbol=399006.SZ&date=20250620

需 trend 权限（基础版及以上）。每次仅 1 只 symbol；可选 date=YYYYMMDD 查询历史交易日分时。

响应 data 结构：

data[] 每项含 timestamp（毫秒）、price、avg_price、volume、turnover、open、high、low、change、change_percent。meta 含 symbol、instrument_type、tick_count；历史分时另含 date。

K 线 {#kline}

复权方式由管理后台配置，所有 K 线拉取路径（含盘中实时、快照窗口）均遵循：

• direct：按 adjust_type 从接口拉已复权 K
• factor：从接口拉不复权 K，再按复权因子动态换算（快照/本地冷存同理：先 none、合入当日 bar、再换算）

meta.adjust_mode 返回当前配置。复权因子见 /v1/adjust-factors。

GET /v1/kline?symbol=603778.SS&period=86400&adjust_type=forward&count=256
GET /v1/kline?symbol=000001.SS&period=86400&count=120
GET /v1/kline?symbol=600519.SS&count=120&indicators=ma:5,10,20&indicators=rsi:14&indicators=macd:12,26,9&indicators=boll:20,2

请求指标时，每根 K 线在 data[] 元素内附带 indicators 对象；预热不足处为 null。计算指标时会自动多拉若干根 K 线用于预热（见 meta.warmup_bars，不计入 count）。

data[].indicators 结构示例：

{
  "date": "20250620",
  "close": 105.2,
  "indicators": {
    "ma:5,10,20": { "5": 104.2, "10": 103.1, "20": 102.0 },
    "rsi:14": { "14": 55.3 },
    "macd:12,26,9": { "dif": 0.5, "dea": 0.3, "macd": 0.4 },
    "boll:20,2": { "upper": 110.0, "mid": 105.0, "lower": 100.0 }
  }
}

可用指标种类与单次上限见 GET /v1/me 的 kline.allowed_indicators_label、kline.max_indicator_specs。

周期取值（period 秒）：

K 线 data[] 每项含 timestamp（毫秒）、date、open、high、low、close、volume、turnover。