Skip to content

Institutional holding overview for one crypto ​

GET /api/v1.0/quote/crypto/institution-holding/overview

Institutional holding overview for one crypto, grouped by institution type. symbol e.g. CC.BTC. Omit institution_type for all groups. Holdings are in coins; ratios are percentages.

Parameters ​

NameTypeInRequiredDescription
codestringqueryyesCrypto symbol, e.g. CC.BTC
institution_typeintquerynoInstitution type; omit for all groups

Example ​

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

Response parameters ​

NameTypeDescription
data.itemsobject[]
data.items[].institution_typeintInstitution type
data.items[].institution_countintNumber of institutions
data.items[].holding_countnumberTotal coins held
data.items[].holding_ratiostringShare of supply, percent
data.items[].holding_valuestringTotal holding value, USD
data.items[].update_timeintUpdate time, Unix microseconds

Errors ​

ret_codeerror.codeDescription
0—Success
-3invalid_parameterMissing or invalid parameter
-8unsupportedNot supported
-10no_dataNo data

Response example ​

json
{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "institution_type": 0,
        "institution_count": 0,
        "holding_count": 1.2,
        "holding_ratio": "example",
        "holding_value": "example",
        "update_time": 1710000000000000
      }
    ]
  }
}