沪深港通持股历史
GET/api/v1.0/quote/{symbol}/stock-connect/hold-ratio获取个股沪深港通持股数量与持股比例时间序列。 港股为南向持股，A 股为北向持股。按时间倒序；end 为开区间上界（不含该日）。 持股比例为百分数（如 20.35 表示 20.35%）；持仓成本已还原。 个股累计净流入请用 quote.stock_connect_stock_flow。
请求参数
| 参数 | 类型 | 位置 | 必填 | 说明 |
|---|---|---|---|---|
symbol | string | 路径 | 是 | 股票代码（路径参数），例: HK.00700 / SH.600519 |
end | string | 查询 | 否 | 截止日期 yyyy-MM-dd（不含该日）；不传从最新开始。翻页时改用 page_flag |
limit | int | 查询 | 否 | 返回条数，默认 30，最大 200 |
page_flag | string | 查询 | 否 | 翻页游标，首页留空；下一页回传 pagination.page_flag |
请求示例
bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/US.AAPL/stock-connect/hold-ratio?end=1&limit=1&page_flag=1' \
-H 'Authorization: Bearer <AccessToken>' | jq响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
data.items | object[] | |
data.hold_cost | string | 持仓成本（元） |
data.update_time | integer | 数据更新时间（Unix 秒） |
data.items[].timestamp | integer | 持股日期（Unix 秒，精确到日） |
data.items[].hold_shares | integer | 持股数量（股） |
data.items[].hold_ratio | string | 持股比例百分数（如 20.35 表示 20.35%） |
data.items[].net_buy_shares | integer | 当日净买入股数 |
data.items[].net_buy_amount | string | 当日净买入金额（元） |
data.items[].open_price | string | 开盘价 |
data.items[].close_price | string | 收盘价 |
data.items[].last_close_price | string | 昨收价 |
pagination.completed | string | 是否已到末页 |
pagination.page_flag | string | 下一页游标（上一页最后一条 timestamp，作为下一页 date_end） |
错误码
| ret_code | error.code | 说明 |
|---|---|---|
| 0 | — | 成功 |
| -3 | invalid_parameter | 参数缺失或不在允许范围内 |
| -7 | invalid_symbol | 标的不存在 |
| -8 | unsupported | 市场或品类不支持 |
| -9 | permission_denied | 没有对应权限 |
| -10 | no_data | 没有可返回的数据 |
| -11 | rate_limited | 调用过于频繁 |
响应示例
json
{
"ret_code": 0,
"ret_msg": "success",
"data": {
"hold_cost": "example",
"update_time": "example",
"items": [
{
"timestamp": 0,
"hold_shares": 0,
"hold_ratio": "example",
"net_buy_shares": 0,
"net_buy_amount": "example",
"open_price": "example"
}
]
},
"pagination": {
"completed": true,
"page_flag": ""
}
}