Institution Stock Holding Changes

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

Get an institution's historical quarterly position changes and period-end stock prices on a single symbol over the last 10 periods.

Request

Parameter	Type	In	Required	Description
institution_id	int	query	yes	Institution ID, e.g. 255251
code	string	query	yes	Stock symbol, e.g. US.AAPL / US.TSLA

Example

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

Response

Field	Type	Description
data.items	object[]
data.items[].period_id	integer	Report period ID
data.items[].start_date	integer	Period start date YYYY-MM-DD
data.items[].end_date	integer	Period end date YYYY-MM-DD
data.items[].kline_price	number	Period-end stock price
data.items[].share_held	string	Shares held at period end
data.items[].change_shares	string	Change in shares during the period
data.items[].change_value	string	Change in holding value during the period
data.items[].portfolio_pct	string	Weight in portfolio (percent)
data.items[].change_pct	string	Change ratio (percent)

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-7	invalid_symbol	Unknown symbol
-8	unsupported	Market or product is not supported
-9	permission_denied	Missing permission
-10	no_data	No data
-11	rate_limited	Too many requests

Sample

{
  "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"
      }
    ]
  }
}