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

AlexandriaFinanceAvailable now

Fiscal.ai · Earnings calendar

fiscal-ai/events/calendar

Get market and financial data with Fiscal.ai · Earnings calendar from Alexandria through one Spiral API key. Call to answer who reports when. Omit every company identifier for the whole calendar, which is what makes this the one capability here that answers a question not about a specific company. Read eventStatus before relying on a date - an estimated one moves. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.026189 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
ciktext—

SEC Central Index Key. Use when a company has no ticker, or after a rename.

figitext—

OpenFIGI identifier of the security. Licensed identifier.

fscltext—

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.

isintext—

ISIN of the security. Licensed identifier.

pagenumber1

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

cusiptext—

CUSIP of the security. Licensed identifier.

sectortext—

GICS sector, to restrict the calendar by industry.

statustext—

Restrict by event status: confirmed, estimated, projected or reported. See eventStatus for what each means.

tickertext—

Ticker symbol, for example MSFT. Only unique within an exchange, so pass exchange with it.

countrytext—

ISO country code of the headquarters, to restrict the calendar by geography.

endDatetext—

Inclusive end of the event window, ISO 8601.

exchangetext—

Exchange code for ticker, for example NASDAQ, or a MIC code for a non-US/CA listing.

pageSizenumber
… to 250
250

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

startDatetext—

Inclusive start of the event window, ISO 8601.

companyKeytext—

Exchange and ticker joined by an underscore: NASDAQ_MSFT for US and Canadian listings, or MIC code and ticker elsewhere, as in XWAR_PKN.

Same request in code

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>"
    }
  }'

Frequently asked questions

How much does Fiscal.ai · Earnings calendar cost?

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

How do I use Fiscal.ai · Earnings calendar through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "fiscal-ai/events/calendar"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use Fiscal.ai · Earnings calendar?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use Fiscal.ai · Earnings calendar?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.