FRED · Sources
fred/sources/sourcesGet market and financial data with FRED · Sources from Alexandria through one Spiral API key. Where a source_id comes from. There are only about a hundred agencies and limit defaults to 1000, so one call is the whole list and paging is never needed here. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.013 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 |
|---|---|---|---|
limit | number … to 1000 | 1000 | Records to return. The default is the maximum, so a naive call is a large response rather than a page. |
offset | number | 0 | Records to skip. Page by adding |
order_by | one of source_id, name, realtime_start, realtime_end | source_id | Which source attribute to sort by. |
sort_order | one of asc, desc | asc | Sort direction. |
realtime_end | text | — | End of the real-time period, YYYY-MM-DD. Defaults to today. Set 9999-12-31 for the full revision history. |
realtime_start | text | — | Start of the real-time period, YYYY-MM-DD. Defaults to today, which means the current vintage only. Set 1776-07-04 for the full revision history. Setting one bound implies the other. |
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": "fred/sources/sources",
"input": {
"limit": 1000
}
}'Frequently asked questions
How much does FRED · Sources cost?
$0.013 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 FRED · Sources through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "fred/sources/sources"` 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 FRED · Sources?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use FRED · Sources?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.