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

AlexandriaFinanceAvailable now

Fiscal.ai · Ratios by period

fiscal-ai/ratios/series

Get market and financial data with Fiscal.ai · Ratios by period from Alexandria through one Spiral API key. Call for valuation, margin and leverage ratios already computed against the reported statements, rather than recomputing them from financials and risking a different denominator. 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.

cusiptext—

CUSIP of the security. Licensed identifier.

tickertext—

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

ratioIdtext—

Restrict to one ratio by id. Omit for every supported ratio. Ids come from metrics/ratios-list.

currencytext—

ISO 4217 code to convert into, for example USD or EUR. Defaults to the company's own reporting currency, and the response carries the rate that was applied.

exchangetext—

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

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.

periodTypetextannual

Comma-separated period filter: annual, quarterly, semi-annual, ltm, ytd, latest. Defaults to annual.

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/ratios/series",
    "input": {
      "fscl": "<fscl>"
    }
  }'

Frequently asked questions

How much does Fiscal.ai · Ratios by period 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 · Ratios by period through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "fiscal-ai/ratios/series"` 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 · Ratios by period?

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

Can my AI agent use Fiscal.ai · Ratios by period?

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