Earnings calendar by market

GET /api/v1.0/quote/earnings-calendar

Earnings calendar by market. Pass one market; optional begin_date / end_date (YYYY-MM-DD, inclusive, span at most 7 days; omit for today). Explodes per-day groups into rows: symbol, session, fiscal quarter, EPS/revenue/EBIT actual vs estimate, option volume/IV, market cap and price. For a single symbol use quote.financials_*; for options earnings opportunities use quote.option_earnings_screener.

Parameters

Name	Type	In	Required	Description
market	string	query	yes	Market. HK / US / SH / SZ / CN / SG / JP / AU / CA / MY. SH and SZ both map to CN A-shares
begin_date	string	query	no	Start date YYYY-MM-DD; omit for today in that market zone
end_date	string	query	no	End date YYYY-MM-DD inclusive; omit to query only begin_date. Span at most 7 days. Date YYYY-MM-DD in the security's market timezone
sort_type	string	query	no	Sort. HOT (default) / MARKET_CAP / OPTION_VOLUME / IV / IV_RANK / IV_PERCENTILE / RT_MARKET_CAP
count	int	query	no	Max rows per earnings day, default 100 (max 1000)

Example

curl -X GET 'https://webapi.moomoo.com/api/v1.0/quote/earnings-calendar?market=HK' \
  -H 'Authorization: Bearer <AccessToken>' | jq

Response parameters

Name	Type	Description
data.items	object[]
data.items[].code	string	Symbol, e.g. US.AAPL
data.items[].name	string	Security name
data.items[].earnings_date	string	Earnings date YYYY-MM-DD
data.items[].earnings_timestamp	int	Earnings publish timestamp , Unix microseconds
data.items[].pub_type	int	Session BEFORE / AFTER / REGULAR
data.items[].period_text	string	Fiscal quarter, e.g. 2026Q3
data.items[].eps_actual	number	EPS actual
data.items[].eps_predict	number	EPS estimate
data.items[].revenue_actual	number	Revenue actual
data.items[].revenue_predict	number	Revenue estimate
data.items[].ebit_actual	number	EBIT actual
data.items[].ebit_predict	number	EBIT estimate
data.items[].option_volume	string	Option volume
data.items[].iv	number	IV (percent)
data.items[].iv_rank	number	IV rank (percent)
data.items[].iv_percentile	number	IV percentile (percent)
data.items[].market_cap	number	Realtime market cap
data.items[].price	string	Last price
data.items[].published	int	Whether earnings have been published

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": [
      {
        "code": "US.AAPL",
        "name": "example",
        "earnings_date": "2026-10-16",
        "earnings_timestamp": 1710000000000000,
        "pub_type": 0,
        "period_text": "example",
        "eps_actual": 1.2,
        "eps_predict": 1.2,
        "revenue_actual": 1.2,
        "revenue_predict": 1.2,
        "ebit_actual": 1.2,
        "ebit_predict": 1.2,
        "option_volume": "example",
        "iv": 1.2,
        "iv_rank": 1.2,
        "iv_percentile": 1.2,
        "market_cap": 1.2,
        "price": "example",
        "published": 0
      }
    ]
  }
}