Social Fetch
Start for freeStart free
Yahoo Finance hub

Yahoo Finance Calendar API

Four calendar types over a date window, one page at a time.

GET /v1/yahoo-finance/calendar

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/yahoo-finance/calendar?type=earnings&from=2015-01-05&to=2015-01-10 returns data.type, data.from, data.to, data.total, data.start, data.count, data.events and data.page. Types are earnings, economic, splits and ipo; the default is earnings. from and to are ISO 8601 dates or times, with epoch seconds also accepted.

The window must be at most 366 days and from must be earlier than to. Page with limit, offset or the opaque cursor from data.page.nextCursor. A window with no rows is an empty page, not an error. Send region and language for the local calendar where Yahoo Finance offers one.

Yahoo Finance Calendar API FAQ

Which calendar types are supported?

earnings, economic, splits and ipo, selected with type. The default is earnings.

What date window can I request?

From and to must be ISO 8601 dates or times, with from earlier than to, and the window can be at most 366 days.

How do I page a calendar?

Read data.page.nextCursor and pass it as cursor while data.page.hasMore is true. A page past the end returns no rows and no next cursor.

What if a window has no rows?

data.events is empty and data.page.hasMore is false. That is a completed answer for an empty window, not a missing calendar.

How many credits does this route cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Yahoo Finance endpoints