# Fiscal.ai · Earnings 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.

- Provider: Alexandria
- Category: Finance
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `fiscal-ai/events/calendar`
- Page: https://spiral.ai/tools/alexandria/fiscal-ai/events/calendar

## Pricing

$0.026189 per call.

## Limits

- 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 | Allowed | 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 `companyFiscalIdentifier` field. The only identifier that survives a ticker change or a relisting, so prefer it when carrying a company between calls. |
| `isin` | text |  | — | ISIN of the security. Licensed identifier. |
| `page` | number |  | 1 | Page number, 1-indexed. Spelled `page` here, where every other Fiscal.ai list takes `pageNumber`. |
| `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 `eventStatus` for what each means. |
| `ticker` | text |  | — | Ticker symbol, for example MSFT. Only unique within an exchange, so pass `exchange` with it. |
| `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 `ticker`, for example NASDAQ, or a MIC code for a non-US/CA listing. |
| `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: `NASDAQ_MSFT` for US and Canadian listings, or MIC code and ticker elsewhere, as in `XWAR_PKN`. |

## Example

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

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=fiscal-ai%2Fevents%2Fcalendar

## Common questions

### Fiscal.ai · Earnings calendar

**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.

