Spiral gives your agent every tool with one account. Browse the tools →

opencode · Finance

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.

Prompts to try with Fiscal.ai earnings calendar in opencode

Copy an example into opencode, or ask in your own words.

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.

Fiscal.ai earnings calendaropencode
Try asking
  • 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.

    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.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    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.

    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.

    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.

Fiscal.ai earnings calendar providers and prices

Spiral runs Fiscal.ai earnings calendar through Alexandria. Open a card for today's price, with every fee included.

AlexandriaFinance
Fiscal.ai · Earnings calendar
fiscal-ai/events/calendar

Settings you can ask for

Ask opencode for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Pagea number1

Page number, 1-indexed. Spelled page here, where every other Fiscal.ai list takes pageNumber.

Page sizea number up to 250250

Rows per page, up to 250. Defaults to 250; page for more.

Every API field of Fiscal.ai · Earnings calendar is on its tool page: open its card above.

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.

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.

Get started

Start using Fiscal.ai earnings calendar in opencode

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into opencode:

Set up opencode

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options