Skip to content

内部人交易 ​

GET /api/v1.0/quote/{symbol}/shareholders/insider-trades

获取公司内部人(董事、高管、5% 以上股东)的交易记录列表。数据基于美国 SEC 内部人申报(Form 3/4/144)。

请求参数 ​

参数类型位置必填说明
symbolstring路径是证券代码(路径参数),格式 US.CODE,例: US.AAPL 最长长度 32; 格式 ^[A-Z0-9_]+\.[A-Za-z0-9_.\-]+$
next_keystring查询否翻页游标(首页留空)。回传上一页 pagination.next_key;以 pagination.has_more=false 停止 最长长度 1000; 格式 ^$|^(-?[0-9]+)?$
limitint查询否每页条数,默认 10,最大 50 ≤ 50; 默认 10
holder_idint查询否按内部人 ID 过滤(0=不过滤;传非零值只返回该内部人的交易记录),可来自 insider_holder_list 返回。例: 234085 ≥ 0; 默认 0

请求示例 ​

bash
curl "https://webapi.futunn.com/api/v1.0/quote/US.AAPL/shareholders/insider-trades?limit=2" | jq

响应字段 ​

参数类型说明
dataobject
data.tradesobject[]
data.trades[].holder_idint内部人 ID,例: 1976351584
data.trades[].namestring内部人姓名,例: 'Ben Borders'
data.trades[].titlestring内部人头衔,例: 'Principal Accounting Officer'
data.trades[].trade_sharesint交易股数(正为买入,负为卖出),例: -1274
data.trades[].min_trade_dateint区间内最早交易日,毫秒时间戳,例: 1778169600000
data.trades[].max_trade_dateint区间内最晚交易日,毫秒时间戳,例: 1778169600000
data.trades[].min_trade_date_strstring区间内最早交易日字符串(市场时区),格式 yyyy-MM-dd,例: '2026-05-07'
data.trades[].max_trade_date_strstring区间内最晚交易日字符串(市场时区),格式 yyyy-MM-dd,例: '2026-05-07'
data.trades[].min_pricenumber区间内最低交易价格(USD),例: 290
data.trades[].max_pricenumber区间内最高交易价格(USD),例: 290
data.trades[].security_holder_quantityint该证券类型当前持股数量(股),例: 38713
data.trades[].is_proposed_sale_of_securitiesbool是否为计划出售证券(Form 144),例: false
data.trades[].security_descriptionstring证券类型描述,例: '普通股'
data.trades[].transaction_typestring交易类型(英文),例: 'Buy' / 'Sell' / 'Other Disposition'
data.trades[].source_group_namestring数据来源,例: 'Form 4'
paginationobject
pagination.totalint
pagination.has_morebool
pagination.next_keystring

限制范围 ​

  • 数据源为美国 SEC 内部人申报。覆盖美股运营公司及其海外双重上市/ADR。
  • 无此类申报的标的(A 股、多数港股、ETF 等)返回空 trades。

错误码 ​

ret_codeerror.code触发条件处理建议
0—成功(无数据时 trades 为空数组)—
-3invalid_parameterlimit > 50 / symbol 格式非法校正参数
-7invalid_symbolsymbol 在证券库中查不到检查证券代码
-2 / -5 / -6internal_error服务错误重试,持续失败请反馈

响应示例 ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "trades": [
      {
        "holder_id": 234085,
        "is_proposed_sale_of_securities": false,
        "max_price": 311.02,
        "max_trade_date": 1779811200000,
        "max_trade_date_str": "2026-05-26",
        "min_price": 311.02,
        "min_trade_date": 1779811200000,
        "min_trade_date_str": "2026-05-26",
        "name": "Arthur Levinson",
        "security_description": "普通股",
        "security_holder_quantity": 3755576,
        "source_group_name": "Form 4",
        "title": "独立非执行主席",
        "trade_shares": -50000,
        "transaction_type": "Sell"
      }
    ]
  },
  "pagination": {
    "has_more": true,
    "total": 178,
    "next_key": "10"
  }
}