IMF Data · Weo
data-imf-org/datasets/weoGet market and financial data with IMF Data · Weo from Alexandria through one Spiral API key. World Economic Outlook observations for one edition (2026-04 current, 2025-10, 2025-04, or latest), given WEO subject codes (NGDP_RPCH, PCPIPCH, LUR, GGXWDG_NGDP, BCA_NGDPD, ...) and ISO3 economy or WEO group codes. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 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 |
|---|---|---|---|
edition required | text | — | YYYY-MM edition. Served now: 2026-04 (IMF.RES:WEO), 2025-10 (WEO_2025_OCT_VINTAGE), 2025-04 (IMF.RES:WEO 6.0.0). Other months map to WEO_YYYY_MON_VINTAGE and return not_found when the IMF has not published that vintage. Pattern: ^([0-9]{4}-(01|04|07|10)|latest|current)$. |
country_codes required | list | — | ISO3 codes (USA, DEU) or WEO group codes (G001 World, G110 Advanced economies, G163 Euro area, G200 Emerging market and developing economies). |
subject_codes required | list | — | subject_codes |
cursor | text | — | cursor |
year_to | number 1980 to 2100 | — | year_to |
page_size | number 1 to 1000 | 100 | page_size |
year_from | number 1980 to 2100 | — | year_from |
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": "data-imf-org/datasets/weo",
"input": {
"edition": "<edition>",
"country_codes": [
"<country_codes>"
],
"subject_codes": [
"<subject_codes>"
]
}
}'Frequently asked questions
How much does IMF Data · Weo cost?
$0.00873 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 IMF Data · Weo through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "data-imf-org/datasets/weo"` 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 IMF Data · Weo?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use IMF Data · Weo?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.