[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Fiscal.ai earnings calendar](https://spiral.ai/integrations/opencode/fiscal-ai-earnings-calendar)

# How to Use Fiscal.ai earnings calendar in opencode

Returns past and upcoming earnings events with company details, fiscal periods, dates, and date certainty. Use it to plan earnings coverage and distinguish company-confirmed dates from estimates and projected windows.

|  |  |
| --- | --- |
| Model | Fiscal.ai earnings calendar |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.026189 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Fiscal.ai earnings calendar in opencode

- Use Fiscal.ai earnings calendar for Apple (NASDAQ: AAPL) and add the returned events to our internal watchlist view, including fiscal period, date, and date certainty.
- Use Fiscal.ai earnings calendar for Costco (NASDAQ: COST) and update our event component so confirmed dates, estimated dates, and projected windows display accurately.
- Use Fiscal.ai earnings calendar to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Fiscal.ai earnings calendar and tell me what changed since last week.
- Check Fiscal.ai earnings calendar and summarize what you find in three bullet points.

## How to set up Fiscal.ai earnings calendar in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Fiscal.ai earnings calendar**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "fiscal-ai/events/calendar",
    "input": {
      "cik": "<cik>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Fiscal.ai earnings calendar on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Fiscal.ai earnings calendar tools and prices

- [Fiscal.ai · Earnings calendar](https://spiral.ai/tools/alexandria/fiscal-ai/events/calendar) (Alexandria): $0.026189 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| cik |  | — | SEC Central Index Key. Use when a company has no ticker, or after a rename. |
| figi |  | — | OpenFIGI identifier of the security. Licensed identifier. |
| fscl |  | — | Fiscal.ai's stable company identifier, the `companyFiscalIdentifier` field. The only identifier that survives a ticker change or a relisting, so prefer it when carrying a company between calls. |
| isin |  | — | ISIN of the security. Licensed identifier. |
| page |  | 1 | Page number, 1-indexed. Spelled `page` here, where every other Fiscal.ai list takes `pageNumber`. |
| cusip |  | — | CUSIP of the security. Licensed identifier. |

## What can you do with Fiscal.ai earnings calendar in opencode?

Build an internal earnings view that shows reporting dates, available documents, or attributed call excerpts for a public-company watchlist. A coding agent can turn Fiscal.ai's returned fiscal periods, resource links, and transcript structure into the project's research interface.

### Prepare an earnings-week briefing

Organize Microsoft's, Apple's, and Amazon's earnings dates, identify available reporting documents, and add timestamped management comments after their calls. Keep confirmed dates distinct from estimates and projected windows.

### Review competitors around earnings

Compare when Coca-Cola and PepsiCo report, which materials are available for each reporting period, and what management says about demand and pricing. Use the returned fiscal periods to label the comparison.

### Draft an internal quarterly research memo

Anchor a Costco research memo to its earnings event, list the supporting reports and presentation, and include attributed call excerpts about margins and demand.

### Maintain an internal earnings tracker

Follow a public-company watchlist from scheduled earnings through document availability and call review. Show date certainty, resource links, and a short transcript summary as separate parts of each company's entry.

### Check earnings research readiness

For Apple and Microsoft, compare the calendar's reporting status with the resources already indexed for the corresponding fiscal period. Produce a checklist of available reports, presentations, releases, and call materials.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Fiscal.ai earnings calendar in other agents

- [Amp](https://spiral.ai/integrations/amp/fiscal-ai-earnings-calendar)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/fiscal-ai-earnings-calendar)
- [Claude](https://spiral.ai/integrations/claude-desktop/fiscal-ai-earnings-calendar)
- [Claude Code](https://spiral.ai/integrations/claude-code/fiscal-ai-earnings-calendar)
- [Cline](https://spiral.ai/integrations/cline/fiscal-ai-earnings-calendar)
- [Codex](https://spiral.ai/integrations/codex/fiscal-ai-earnings-calendar)
- [Cursor](https://spiral.ai/integrations/cursor/fiscal-ai-earnings-calendar)
- [Devin](https://spiral.ai/integrations/devin/fiscal-ai-earnings-calendar)
- [dots](https://spiral.ai/integrations/dots/fiscal-ai-earnings-calendar)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/fiscal-ai-earnings-calendar)
- [Gemini](https://spiral.ai/integrations/gemini/fiscal-ai-earnings-calendar)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/fiscal-ai-earnings-calendar)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/fiscal-ai-earnings-calendar)
- [goose](https://spiral.ai/integrations/goose/fiscal-ai-earnings-calendar)
- [Grok](https://spiral.ai/integrations/grok/fiscal-ai-earnings-calendar)
- [Grok Build](https://spiral.ai/integrations/grok-build/fiscal-ai-earnings-calendar)
- [Hermes](https://spiral.ai/integrations/hermes/fiscal-ai-earnings-calendar)
- [Instinct](https://spiral.ai/integrations/instinct/fiscal-ai-earnings-calendar)
- [Manus](https://spiral.ai/integrations/manus/fiscal-ai-earnings-calendar)
- [Muse](https://spiral.ai/integrations/muse/fiscal-ai-earnings-calendar)
- [Muse Code](https://spiral.ai/integrations/muse-code/fiscal-ai-earnings-calendar)
- [n8n](https://spiral.ai/integrations/n8n/fiscal-ai-earnings-calendar)
- [Notion](https://spiral.ai/integrations/notion/fiscal-ai-earnings-calendar)
- [OpenClaw](https://spiral.ai/integrations/openclaw/fiscal-ai-earnings-calendar)
- [Perplexity](https://spiral.ai/integrations/perplexity/fiscal-ai-earnings-calendar)
- [Raycast](https://spiral.ai/integrations/raycast/fiscal-ai-earnings-calendar)
- [VS Code](https://spiral.ai/integrations/vscode/fiscal-ai-earnings-calendar)
- [Windsurf](https://spiral.ai/integrations/windsurf/fiscal-ai-earnings-calendar)
- [Zapier](https://spiral.ai/integrations/zapier/fiscal-ai-earnings-calendar)

## More opencode guides

- [Fiscal.ai daily stock prices](https://spiral.ai/integrations/opencode/fiscal-ai-daily-stock-prices)
- [Fiscal.ai earnings call transcript](https://spiral.ai/integrations/opencode/fiscal-ai-earnings-call-transcript)
- [Fiscal.ai daily financial ratios](https://spiral.ai/integrations/opencode/fiscal-ai-daily-financial-ratios)
- [Fiscal.ai financial ratio definitions](https://spiral.ai/integrations/opencode/fiscal-ai-financial-ratio-definitions)
- [Fiscal.ai company profile](https://spiral.ai/integrations/opencode/fiscal-ai-company-profile)
- [Fiscal.ai financial ratios by period](https://spiral.ai/integrations/opencode/fiscal-ai-financial-ratios-by-period)

## Questions about Fiscal.ai earnings calendar in opencode

**Can opencode use Fiscal.ai earnings calendar?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Fiscal.ai earnings calendar like any built-in tool.

**How much does Fiscal.ai earnings calendar cost in opencode?**

$0.026189 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use Fiscal.ai earnings calendar in opencode?**

No. Spiral runs Fiscal.ai earnings calendar on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up Fiscal.ai earnings calendar in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while Fiscal.ai earnings calendar runs?**

Fiscal.ai earnings calendar runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**Which events does Fiscal.ai cover?**

The calendar currently covers earnings events. The associated IR material includes reports, presentations, results releases, and available call transcripts or recordings; transcript coverage is English-language only.

**How far back does the earnings data go?**

Calendar history starts June 16, 2026. For IR resources and transcripts, Fiscal.ai captured each company's latest period as of July 7, 2026, best-effort, then collects subsequent periods going forward.

**Are upcoming earnings dates confirmed?**

Only dates marked confirmed are company-stated. Estimated dates are source-derived, projected dates are windows inferred from reporting cadence, and reported events have already occurred.

**Does one earnings event arrive with all its documents?**

Resources arrive incrementally: Fiscal.ai emits updates when reports, presentations, releases, transcripts, or recordings become available. Resources sharing the same fiscal period belong to the same reporting event.

**How many calendar results can one request return?**

The documented maximum page size is 1,000 rows. Without an explicit page size, a result exceeding 1,000 rows is rejected, so broad calendar queries need narrower scope or pagination.

