Finance

Data source: ECB, Norges Bank

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

Authentication

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

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

Tools (7)

get_ecb_exchange_rate
list_ecb_exchange_rates
get_ecb_policy_rate
get_norges_bank_exchange_rate
list_norges_bank_exchange_rates
get_norges_bank_policy_rate
report_feedback

get_ecb_exchange_rate

Get the ECB official reference rate for a currency vs EUR.

The ECB publishes reference rates at ~16:00 CET each business day
for ~30 currencies. The rate is expressed as units of EUR per 1 unit
of the foreign currency (e.g. EUR/USD = 1.08 means 1 EUR buys 1.08 USD).

Args:
currency: ISO 4217 currency code (e.g. "USD", "GBP", "JPY", "NOK").
date: Optional date in ISO 8601 format (YYYY-MM-DD). If omitted,
returns the most recent available rate.

Returns:
currency, base_currency ("EUR"), rate, date, source.

Parameter	Type	Required	Description
`currency`	`string`	required	ISO 4217 currency code (e.g. "USD", "GBP", "JPY", "NOK").
`date`	`any`	optional	Optional date in ISO 8601 format (YYYY-MM-DD). If omitted, returns the most recent available rate.

Request Body

{
  "currency": "example"
}

list_ecb_exchange_rates

List all ECB official reference exchange rates for a given date.

The ECB publishes ~30 currency pairs vs EUR each business day.
Useful when you need a full forex snapshot to price international
transactions or convert between multiple currencies via EUR.

Args:
date: Optional date in ISO 8601 format (YYYY-MM-DD). If omitted,
returns the most recent available rates.

Returns:
List of exchange rates with currency, rate, and date.

Parameter	Type	Required	Description
`date`	`any`	optional	Optional date in ISO 8601 format (YYYY-MM-DD). If omitted, returns the most recent available rates.

Request Body

{
  "query": "example"
}

get_ecb_policy_rate

Get ECB key interest rate history.

The ECB sets three key interest rates at Governing Council meetings
(held every 6–8 weeks). The deposit facility rate is the primary
policy instrument since the 2022 hiking cycle.

Args:
rate_type: Which ECB rate to fetch:
- "deposit_facility" (default) — rate on bank deposits at ECB overnight
- "main_refinancing" — rate on main refinancing operations (MRO)
- "marginal_lending" — rate on overnight marginal lending facility
date_from: Optional start date (YYYY-MM-DD). Defaults to last 10 changes.
date_to: Optional end date (YYYY-MM-DD).

Returns:
List of rate changes with date and rate_pct, most recent last.

Parameter	Type	Required	Description
`rate_type`	`string`	optional	Which ECB rate to fetch: - "deposit_facility" (default) — rate on bank deposits at ECB overnight - "main_refinancing" — rate on main refinancing operations (MRO) - "marginal_lending" — rate o... (default: "deposit_facility")
`date_from`	`any`	optional	Optional start date (YYYY-MM-DD). Defaults to last 10 changes.
`date_to`	`any`	optional	Optional end date (YYYY-MM-DD).

Request Body

{
  "query": "example"
}

get_norges_bank_exchange_rate

Get Norges Bank official exchange rate for a currency vs NOK.

Norges Bank publishes exchange rates each business day for ~40
currencies. Rates are expressed as NOK per 1 unit of foreign currency
(e.g. EUR/NOK = 11.8 means 1 EUR = 11.8 NOK).

Args:
currency: ISO 4217 currency code (e.g. "EUR", "USD", "GBP", "SEK").
date_from: Optional start date (YYYY-MM-DD). If neither date is given,
returns the most recent available rate.
date_to: Optional end date (YYYY-MM-DD).

Returns:
List of (date, rate) pairs, oldest first.

Parameter	Type	Required	Description
`currency`	`string`	required	ISO 4217 currency code (e.g. "EUR", "USD", "GBP", "SEK").
`date_from`	`any`	optional	Optional start date (YYYY-MM-DD). If neither date is given, returns the most recent available rate.
`date_to`	`any`	optional	Optional end date (YYYY-MM-DD).

Request Body

{
  "currency": "example"
}

list_norges_bank_exchange_rates

List all Norges Bank exchange rates for a given date (or latest).

Norges Bank publishes ~40 NOK cross rates each business day.

Args:
date: Optional date (YYYY-MM-DD). If omitted, returns the latest available.

Returns:
List of currencies and their NOK rates.

Parameter	Type	Required	Description
`date`	`any`	optional	Optional date (YYYY-MM-DD). If omitted, returns the latest available.

Request Body

{
  "query": "example"
}

get_norges_bank_policy_rate

Get Norges Bank key policy rate (styringsrente) history.

Norges Bank sets the key policy rate at scheduled meetings (~8 per year).
The rate directly influences mortgage rates and the Norwegian economy.

Args:
date_from: Optional start date (YYYY-MM-DD). Defaults to last 10 decisions.
date_to: Optional end date (YYYY-MM-DD).

Returns:
List of rate decisions with date and rate_pct, most recent last.

Parameter	Type	Required	Description
`date_from`	`any`	optional	Optional start date (YYYY-MM-DD). Defaults to last 10 decisions.
`date_to`	`any`	optional	Optional end date (YYYY-MM-DD).

Request Body

{
  "query": "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-norgesbank/get_ecb_exchange_rate" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"currency": "example"}'

Python

import httpx

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