API referenceEndpointsFinancials
Get earnings context
GET
/v2/earningsEarnings-related context for stocks. ETFs return an unsupported response because ETFs do not report earnings.
Access: Starter and Builder.
Authorization
ApiKeyAuth X-API-Key<token>
noxstock API key from the dashboard.
In: header
Query Parameters
symbol*Symbol
Ticker symbol. Case-insensitive; share-class dots are normalized to dashes (BRK.B == BRK-B). Returns SYMBOL_UNKNOWN when the symbol is outside the supported universe.
Header Parameters
X-API-Key?string|null
Response Body
application/json
application/json
curl -X GET "https://example.com/v2/earnings?symbol=AAPL"{
"data": {
"as_of": "string",
"cache_age_seconds": 0,
"currency": "USD",
"freshness": "intraday",
"history": [
{
"eps_actual": 0,
"eps_yoy_pct": 0,
"filing_date": "string",
"fiscal_period": "string",
"fiscal_year": 0,
"period_end": "string",
"revenue_actual": 0,
"revenue_yoy_pct": 0
}
],
"last": {
"eps_actual": 0,
"eps_yoy_pct": 0,
"filing_date": "string",
"fiscal_period": "string",
"fiscal_year": 0,
"period_end": "string",
"revenue_actual": 0,
"revenue_yoy_pct": 0,
"vs_trend": {
"eps_baseline_4q_avg": 0,
"eps_vs_trailing_4q_avg_pct": 0,
"revenue_baseline_4q_avg": 0,
"revenue_vs_trailing_4q_avg_pct": 0
}
},
"market_status": "open",
"next_estimated_date": "string",
"symbol": "string"
}
}Empty
Empty
{
"detail": [
{
"ctx": {},
"input": null,
"loc": [
"string"
],
"msg": "string",
"type": "string"
}
]
}Empty
Empty