Finance

Data source: ECB Data API (SDMX 2.1)

REST Bridge Endpoint https://context.gnist.ai/rest/ecb-stats/

Authentication

All requests require a Gnist-API-Key header (or api_key query parameter).

Free tier: 100 calls/day. Get your API key.

Tools (6)

search_datasets
list_datasets
get_dataset_structure
get_data
compare_series
report_feedback

search_datasets

Search the ECB dataset catalog by keyword.

Returns matching datasets with their dataflow IDs needed for
get_data, get_dataset_structure, and compare_series calls.
ECB covers monetary policy, interest rates, inflation, bank lending,
exchange rates, financial markets, and balance of payments for the
euro area and EU member states.

Args:
query: Search term (e.g. "interest rate", "inflation", "lending").
limit: Number of results to return (1-50, default 20).

Returns:
List of matching datasets with id, name, agency, and description.
Use the 'id' field as the dataflow parameter in other tools.

Parameter	Type	Required	Description
`query`	`string`	required	Search term for ECB datasets (e.g. "interest rate", "inflation", "bank lending", "money supply", "exchange").
`limit`	`integer`	optional	Number of results to return (1-50, default 20). (default: 20)

Request Body

{
  "query": "example"
}

list_datasets

List available ECB datasets, optionally filtered by topic.

Browse the full ECB data catalog (150+ dataflows). Use this to
discover what datasets exist before querying specific data.

Args:
topic: Optional topic filter keyword. Omit to list all datasets.
limit: Maximum datasets to return (1-200, default 50).

Returns:
List of datasets with id, name, and description.

Parameter	Type	Required	Description
`topic`	`any`	optional	Optional topic filter (e.g. "monetary", "exchange", "lending", "balance"). Omit to list all.
`limit`	`integer`	optional	Maximum datasets to return (1-200, default 50). (default: 50)

Request Body

{
  "query": "example"
}

get_dataset_structure

Get the dimension structure of an ECB dataset.

Shows what dimensions (filters) are available for a dataset and their
valid values. Use this before get_data to understand what currencies,
frequencies, and other parameters are accepted.

Args:
dataflow: ECB dataflow identifier from search_datasets.

Returns:
List of dimensions with their valid codes/values. Each dimension
shows its position in the SDMX key and sample values.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ECB dataflow identifier from search_datasets (e.g. "EXR", "IRS", "ICP", "BLS", "FM").

Request Body

{
  "dataflow": "example"
}

get_data

Fetch data from an ECB dataset.

Query any ECB dataset using SDMX key filters. Covers exchange rates,
interest rates, inflation, money supply, bank lending, and 150+ more
data series for the euro area and EU member states.

Args:
dataflow: ECB dataflow identifier. Use search_datasets to find IDs.
key_filter: SDMX key filter. Use get_dataset_structure for valid values.
start_period: Start period filter (e.g. "2015").
end_period: End period filter (e.g. "2023").
limit: Maximum observations to return (1-1000, default 200).

Returns:
Observations with all dimension labels and values.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ECB dataflow identifier (e.g. "EXR", "IRS", "ICP"). Use search_datasets to find IDs.
`key_filter`	`any`	optional	SDMX key filter (e.g. "M.USD.EUR.SP00.A" for monthly USD/EUR spot rate). Dot-separated dimension values. Use get_dataset_structure to find valid values. Omit for all data.
`start_period`	`any`	optional	Start period (e.g. "2015", "2020-Q1", "2020-01").
`end_period`	`any`	optional	End period (e.g. "2023", "2023-Q4", "2023-12").
`limit`	`integer`	optional	Maximum observations to return (1-1000, default 200). (default: 200)

Request Body

{
  "dataflow": "example"
}

compare_series

Compare multiple data series from the same ECB dataset.

Fetches multiple series side by side for comparison. Useful for
comparing exchange rates, interest rates across countries, or
different inflation measures.

Args:
dataflow: ECB dataflow identifier.
keys: SDMX key filters to compare. Maximum 10.
start_period: Start period. Omit for most recent data.
end_period: End period. Omit for most recent data.

Returns:
Data grouped by series key for easy comparison.

Parameter	Type	Required	Description
`dataflow`	`string`	required	ECB dataflow identifier (e.g. "EXR", "IRS").
`keys`	`list[string]`	required	SDMX key filters to compare (e.g. ["M.USD.EUR.SP00.A", "M.GBP.EUR.SP00.A"]). Maximum 10.
`start_period`	`any`	optional	Start period (e.g. "2020"). Omit for most recent data.
`end_period`	`any`	optional	End period (e.g. "2023"). Omit for most recent data.

Request Body

{
  "dataflow": "example",
  "keys": [
    "example"
  ]
}

report_feedback

Report a bug, feature request, or general feedback for this data source.

Use this when something doesn't work as expected, when you'd like
a new feature, or when you have suggestions for improvement.

Args:
feedback: Describe the issue or suggestion.
feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	`string`	required
`feedback_type`	`string`	optional	(default: "general")

Request Body

{
  "feedback": "example"
}

Quick Start

Shell

curl -X POST "https://context.gnist.ai/rest/ecb-stats/search_datasets" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"query": "example"}'

Python

import httpx

resp = httpx.post(
    "https://context.gnist.ai/rest/ecb-stats/search_datasets",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={
  "query": "example"
},
)
print(resp.json())