Economic Time Series with Observations by Provider, Dataset and Series Code (DBnomics)
dbnomics/get-series
One economic or statistical time series from DBnomics, looked up by its source agency code, dataset code and series code (for example IMF, WEO:2023-10 and USA.NGDP_RPCH for US real GDP growth in the IMF World Economic Outlook). Returns the series with its name, frequency, dimensions and its observations as parallel period and value arrays, plus when DBnomics last updated it. Only public statistical agencies (central banks, national statistics offices, IMF, OECD, Eurostat, World Bank and similar) can be requested; commercial sources DBnomics also indexes are refused. Each series keeps the licence and terms of the agency that publishes it, named in provider_code; the terms_of_use link of every agency is in DBnomics List Providers. An unknown series or dataset code is a VALIDATION error. DBnomics data, passed through unmodified and served by Eden Engine; not an official DBnomics product.
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.
Data source
Data from DBnomics (CEPREMAP), https://db.nomics.world. DBnomics' own aggregated datasets are published under the ODbL; each series is the original source agency's data and remains subject to that agency's licence and terms of use (listed by agency in DBnomics List Providers). Credit DBnomics and the source agency. Served by Eden Engine; not an official DBnomics product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "dbnomics/get-series" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "dbnomics/get-series" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "dbnomics/get-series", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "dbnomics/get-series", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 20, 2026
Input and output schemas
Input schema
{
"type": "object",
"required": [
"provider_code",
"dataset_code",
"series_code"
],
"properties": {
"series_code": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,120}$",
"description": "The series code within the dataset, for example USA.NGDP_RPCH (US real GDP growth in WEO:2023-10)."
},
"dataset_code": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,120}$",
"description": "The agency's dataset code, case as published, for example WEO:2023-10 (IMF World Economic Outlook, October 2023) or EXR (ECB exchange rates). DBnomics Search Series finds series codes inside a dataset."
},
"provider_code": {
"enum": [
"AFDB",
"AMECO",
"BDF",
"BEA",
"BIS",
"BLS",
"BOC",
"EC",
"ECB",
"EIA",
"Eurostat",
"FED",
"FHFA",
"ILO",
"IMF",
"INDEC",
"INEPT",
"INSEE",
"ISTAT",
"NBB",
"OBR",
"OECD",
"ONS",
"STATCAN",
"STATJP",
"UNCTAD",
"UNDATA",
"WB"
],
"type": "string",
"description": "The source agency's DBnomics code, case as shown, for example IMF, ECB, Eurostat, OECD, WB or BEA. Only public statistical agencies are served (the enum); DBnomics also indexes commercial sources, which are refused."
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"required": [
"results"
],
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "array",
"items": {},
"description": "The observation for each period, in the series' unit. Parallel to `period`."
},
"period": {
"type": "array",
"items": {
"type": "string"
},
"description": "The period of each observation, for example 2024 for an annual series. Parallel to `value`."
},
"@frequency": {
"type": "string",
"description": "Observation frequency, for example annual."
},
"dimensions": {
"type": "object",
"description": "The series' dimension codes, for example country, subject and unit.",
"additionalProperties": true
},
"indexed_at": {
"type": "string",
"description": "When DBnomics last fetched this series from the agency (ISO 8601, UTC)."
},
"series_code": {
"type": "string",
"description": "Full series code, which can include a trailing dimension."
},
"series_name": {
"type": "string",
"description": "Human-readable series name."
},
"dataset_code": {
"type": "string",
"description": "Dataset code."
},
"dataset_name": {
"type": "string",
"description": "Dataset name."
},
"provider_code": {
"type": "string",
"description": "Source agency code."
},
"period_start_day": {
"type": "array",
"items": {
"type": "string"
},
"description": "First day (YYYY-MM-DD) of each period. Parallel to `period`."
}
},
"additionalProperties": true
},
"description": "The matching series (one element)."
}
},
"description": "The series DBnomics holds under the three codes: a list of one.",
"additionalProperties": true
}