List Yahoo Finance calendar
List Yahoo Finance earnings, economic, split and IPO calendar rows.
Headers
Get your API keyAPI key (`sfk_...`)
Window start, as an ISO 8601 date or time (such as `2026-01-31`) or epoch seconds. A time with no zone is UTC.
Window end: an ISO 8601 date or time. It is exclusive. Epoch seconds are also accepted.
Calendar: `earnings`, `economic`, `splits` or `ipo`. Default: `earnings`.
one of: earnings, economic, splits, ipo
Market region, a two-letter code such as `US`, `GB` or `JP`.
pattern: ^[A-Z]{2}$
Language tag for names and news, e.g. `en-US` or `ja-JP`.
max 24 chars · pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$
Page size as an integer from 1 to 250. Default: 100.
≥ 1 · ≤ 250
Zero-based position to begin the list at. Default: 0; maximum: 1,000,000. Only the first 10,000 rows are available; past that the page is empty.
≥ 0 · ≤ 1000000
Cursor from `page.nextCursor` of the previous response. It only works with the same filters.
min 1 chars · max 1024 chars
Endpoint-specific response payload.
Calendar kind: `earnings`, `economic`, `splits` or `ipo`.
Window start, ISO 8601 UTC.
Window end, ISO 8601 UTC.
Total matching rows; null when not reported.
≥ 0
Zero-based position of the first row.
≥ 0
Number of rows in this page.
≥ 0
Calendar rows.
A Yahoo Finance JSON record, normalised.
Pagination state for the current page.
Whether another page is available.
Cursor to pass in the next request when more pages exist; null on the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/yahoo-finance/calendar?from=2015-01-05&to=2015-01-10" \
-H "x-api-key: YOUR_API_KEY"Responses
Yahoo Finance calendar rows.