The SentiSense Calendar API: See Earnings Coming, Not Just Reported

Most market data tells you what already happened. An earnings calendar is one of the few feeds that tells you what is about to. That difference is the whole point of today's launch.

We are adding a new family to the SentiSense API: Calendars. The first calendar is earnings, available now at /api/v1/calendar/earnings.

What it returns

A clean, sorted list of upcoming company earnings. Each entry carries:

• ticker and companyName
• earningsDate (the report date)
• earningsTime: before the open, after the close, or during the session
• fiscalQuarter (e.g. Q2 2026)
• confirmed: whether the company has locked the date, or it is still projected
• estimatedEps: the consensus estimate going in

You can filter to a single ticker, to this week or next week, to a custom date range, to confirmed-only, or by session timing.

curl -H "X-SentiSense-API-Key: ss_live_YOUR_KEY" \
  "https://app.sentisense.ai/api/v1/calendar/earnings?week=next&confirmed=true"

Why lead time is the product

Knowing what reports tonight is commodity information. You can get it anywhere, and by the time it is news it is already priced.

The value is the forward window: which companies report over the next several weeks, so you can build a pre-earnings watchlist, screen for catalysts in a given range, or hand an agent the dates it needs to know when a thesis actually has a catalyst coming. That is the data that lets you position ahead of the event instead of reacting to it, and it is the kind of forward calendar that data services typically reserve for their upgraded plans.

We include it in PRO at $15/month.

What is free

The earnings calendar requires an API key on every call, so we can keep it fast and abuse-resistant. On a free key you get the current week, with every field populated: real dates, real timing, real EPS estimates. Nothing is blurred or stripped. The gate is simply how far ahead you can see.

PRO unlocks the full forward window (about 30 days). On a free response we also tell you how much you are not seeing, so you always know what the upgrade buys:

{
  "isPreview": true,
  "previewReason": "PRO_REQUIRED",
  "totalCount": 142,
  "data": { "earnings": [ /* this week */ ], "metadata": { /* ... */ } }
}

In the SDKs and the agent skills

The Calendar API ships across the surface, not just as a raw endpoint:

from sentisense import SentiSenseClient

client = SentiSenseClient(api_key="ss_live_YOUR_KEY")
cal = client.get_earnings_calendar(week="next")
for e in cal.earnings:
    print(f"{e['earningsDate']} {e['ticker']} ({e['earningsTime']})")

import SentiSense from 'sentisense';
const client = new SentiSense({ apiKey: 'ss_live_YOUR_KEY' });
const cal = await client.calendar.getEarnings({ week: 'next' });

It is also wired into our AI agent skills, so a terminal-style assistant can answer "who reports next week?" or anchor a pre-earnings briefing to a real, confirmed date instead of guessing.

What is next

The /calendar/{type} namespace is built to grow. Earnings is the first feed; the shape is designed so future calendars slot in the same way. Tell us which ones you want.

Start here:

• API reference: sentisense.ai/docs/api/calendar
• Get a key: app.sentisense.ai/settings/developer
• Full agent skill: sentisense.ai/skill.md

SentiSense is a product of Compass AI Data Services, LLC. This data is for informational purposes only, not investment advice.