资金分布
GET/v1/quote/{symbol}/capital-distribution获取个股当日资金按订单大小分档的累计流入流出分布。返回流入 / 流出各 4 档（特大单 / 大单 / 中单 / 小单）的金额合计与数据更新时间。仅当日累计快照，不含时间序列。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 股票代码，MARKET.CODE 格式，例 HK.00700 / US.AAPL / SZ.000001。 |
请求示例
bash
curl '$ip/v1/quote/US.AAPL/capital-distribution' | jq
curl '$ip/v1/quote/HK.00700/capital-distribution' | jq响应字段
顶层 data（对象，非数组；仅当日单条快照）：
| 字段 | 类型 | 说明 |
|---|---|---|
capital_in_super | double | 流入 - 特大单累计（标的本币元）。 |
capital_in_big | double | 流入 - 大单累计。 |
capital_in_mid | double | 流入 - 中单累计。 |
capital_in_small | double | 流入 - 小单累计。 |
capital_out_super | double | 流出 - 特大单累计。 |
capital_out_big | double | 流出 - 大单累计。 |
capital_out_mid | double | 流出 - 中单累计。 |
capital_out_small | double | 流出 - 小单累计。 |
update_time | int64 | 数据更新时间（毫秒时间戳）。 |
净流入 =
capital_in_*-capital_out_*（由调用方按需相减）。
限制范围
| 维度 | 支持 | 不支持 / 当前无数据 |
|---|---|---|
| 市场（正股 / ETF） | HK · US · SH · SZ · SG · JP · CA · AU | KR · MY · BJ（部分代码可解析但当前无数据） |
| 品类 | 正股、ETF | 指数、窝轮、期权、期货（标的合法但无分档分布数据，返回 no_data）；数字货币（不支持） |
| 时间范围 | 仅当日累计快照 | 不含时间序列；时间序列请用资金流向（日内），历史聚合请用资金流向（历史） |
当标的合法但当前无资金分布数据（指数 / 窝轮 / 期权 / 期货 / 停牌 / 上市前等），返回 ret_code=-10、error.code=no_data。
错误码
| ret_code | error.code | 触发场景 | 调用方处理建议 |
|---|---|---|---|
| 0 | — | 成功 | 直接消费 data |
| -3 | invalid_parameter | symbol 不符合 MARKET.CODE 格式 / 必填缺失 | 校正入参后重试 |
| -7 | invalid_symbol | 标的格式合法但在证券缓存中查不到（不存在 / 拼写错误 / 当前未支持的市场） | 检查 symbol 是否真实存在 |
| -10 | no_data | 标的合法但当前无资金分布数据（指数 / 窝轮 / 期权 / 期货 / 停牌 / 上市前 / 非交易时段） | 视为"无数据"分支，无需重试 |
| -5 | internal_error | 后端调用失败 / 响应转换失败等内部异常 | 重试或上报 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"capital_in_super": 33258999.22,
"capital_in_big": 538273730.406,
"capital_in_mid": 717644215.485,
"capital_in_small": 1293213140.084,
"capital_out_super": 81854403.005,
"capital_out_big": 615472467.736,
"capital_out_mid": 801663840.013,
"capital_out_small": 1426845341.759,
"update_time": 1780531198000
}
}