Fiscal.ai · Ratios by period
fiscal-ai/ratios/seriesGet 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
| 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. |
cusip | text | — | CUSIP of the security. Licensed identifier. |
ticker | text | — | Ticker symbol, for example MSFT. Only unique within an exchange, so pass |
ratioId | text | — | Restrict to one ratio by id. Omit for every supported ratio. Ids come from metrics/ratios-list. |
currency | text | — | 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. |
exchange | text | — | Exchange code for |
companyKey | text | — | Exchange and ticker joined by an underscore: |
periodType | text | annual | 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.