Crypto market-data card

GET /api/v1.0/quote/crypto/market-data-card

Crypto market-data card (market cap / turnover / cap share). Pass symbol (e.g. CC.BTC) for one coin; omit it to aggregate by ALL / STABLE / OTHER.

Parameters

Name	Type	In	Required	Description
scene	string	query	yes	Scene: market cap / turnover / cap share
time_range	string	query	no	Time range, default 24H
code	string	query	no	Symbol such as CC.BTC; preferred over aggregation
aggregation	string	query	no	Aggregate when symbol is omitted, default ALL

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/crypto/market-data-card?scene=MARKET_CAP' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response parameters

Name	Type	Description
data.items	object[]
data.items[].timestamp	int	Quote time, Unix microseconds
data.items[].market_cap	number	Market cap in USD, unscaled
data.items[].turnover_24h	number	24h turnover in USD
data.items[].market_cap_pct	number	Market-cap share, percent
data.items[].aggregation_type	int	Aggregate type, 1=ALL / 2=STABLE / 3=OTHER; 0 when queried by symbol

Errors

ret_code	error.code	Description
0	—	Success
-3	invalid_parameter	Missing or invalid parameter
-8	unsupported	Not supported
-10	no_data	No data

Response example

{
  "ret_code": 0,
  "ret_msg": "success",
  "data": {
    "items": [
      {
        "timestamp": 1710000000000000,
        "market_cap": 1.2,
        "turnover_24h": 1.2,
        "market_cap_pct": 1.2,
        "aggregation_type": 0
      }
    ]
  }
}