Fiscal.ai · Earnings calendar
fiscal-ai/events/calendarGet 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
| Field | Kind | Default | Description |
|---|---|---|---|
cik | text | — | SEC Central Index Key. Use when a company has no ticker, or after a rename. |
figi | text | — | OpenFIGI identifier of the security. Licensed identifier. |
fscl | text | — | Fiscal.ai's stable company identifier, the |
isin | text | — | ISIN of the security. Licensed identifier. |
page | number | 1 | Page number, 1-indexed. Spelled |
cusip | text | — | CUSIP of the security. Licensed identifier. |
sector | text | — | GICS sector, to restrict the calendar by industry. |
status | text | — | Restrict by event status: confirmed, estimated, projected or reported. See |
ticker | text | — | Ticker symbol, for example MSFT. Only unique within an exchange, so pass |
country | text | — | ISO country code of the headquarters, to restrict the calendar by geography. |
endDate | text | — | Inclusive end of the event window, ISO 8601. |
exchange | text | — | Exchange code for |
pageSize | number … to 250 | 250 | Rows per page, up to 250. Defaults to 250; page for more. |
startDate | text | — | Inclusive start of the event window, ISO 8601. |
companyKey | text | — | Exchange and ticker joined by an underscore: |
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.