Skip to content

机构个股持仓变动 ​

GET /api/v1.0/quote/institution/transaction-record

查询指定机构在单只股票上最近 10 个报告期的持仓变动记录与对应季度末收盘价(用于机构买卖打点与复盘)。 返回包含:每个报告期的 period_id、起止日期、季末股价(kline_price),以及当期有调仓时的持股数(share_held)、变动股数(change_shares)、变动金额(change_value)与组合占比。

请求参数 ​

参数类型位置必填说明
institution_idint查询是机构 ID,例: 255251
codestring查询是股票代码,例: US.AAPL / US.TSLA

请求示例 ​

bash
curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/institution/transaction-record?institution_id=1&code=US.AAPL' \
  -H 'Authorization: Bearer <AccessToken>' | jq

响应参数 ​

参数类型说明
data.itemsobject[]
data.items[].period_idinteger报告期 ID
data.items[].start_dateinteger报告期起始日 YYYY-MM-DD
data.items[].end_dateinteger报告期结束日 YYYY-MM-DD
data.items[].kline_pricenumber该报告期末股票价格
data.items[].share_heldstring期末持股数量(股)
data.items[].change_sharesstring当期持仓变动股数
data.items[].change_valuestring当期持仓变动金额
data.items[].portfolio_pctstring占组合市值比例(百分数)
data.items[].change_pctstring持仓变动比例(百分数)

错误码 ​

ret_codeerror.code说明
0—成功
-3invalid_parameter参数缺失或不在允许范围内
-7invalid_symbol标的不存在
-8unsupported市场或品类不支持
-9permission_denied没有对应权限
-10no_data没有可返回的数据
-11rate_limited调用过于频繁

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "period_id": 0,
        "start_date": 0,
        "end_date": 0,
        "kline_price": "example",
        "share_held": "example",
        "change_shares": "example"
      }
    ]
  }
}