Currency Rate Grounding Data

Overview

A currency rate API for tracking a single currency rather than a pair. Pass a currency code to get the value of one unit in US dollars (price) and the units per dollar (rate), with the currency's English name, symbol, the direction it moved since yesterday's close and when the rates were refreshed; rates refresh every few minutes. Paid plans can price the currency in any other base, and add its 1-day, 7-day, 30-day and 1-year percent change, the 24-hour high and low, and the 30-day high, low, average and volatility. hourly=true returns the price for each of the last 24 hours and daily=true its last 30 daily closes. To convert between two currencies use Exchange Rate or Currency Converter.

Live Test Currency Rate Grounding Data Source →

The tool

Once your client is connected to the VerveContext server, this appears in its tool list as CurrencyRateGroundingData. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call

{
  "name": "CurrencyRateGroundingData",
  "arguments": {
    "currency": "EUR"
  }
}

You do not name the tool yourself; the model picks it. Asking about EUR in the terms this source covers is enough for it to reach for CurrencyRateGroundingData on its own — naming it explicitly also works, and is the way to force the call.

Connecting

One server URL covers every source in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervecontext": {
      "url": "https://api.vervecontext.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

Argument	Type	Description
`currency`Required	string	The ISO 4217 code of the currency to price (e.g. EUR)
`base`OptionalPremium	string	The currency to price it in; defaults to USD default USD
`hourly`OptionalPremium	boolean	Include the price for each of the last 24 hours
`daily`OptionalPremium	boolean	Include the daily closing price for the last 30 days

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result

{
  "status": "ok",
  "error": null,
  "data": {
    "currency": "EUR",
    "currencyName": "Euro",
    "currencySymbol": "€",
    "base": "USD",
    "baseName": "US Dollar",
    "price": 1.1171949,
    "rate": 0.895099,
    "changeDirection": "down",
    "date": "2026-10-27",
    "lastUpdated": "2026-10-27T20:39:40.670Z",
    "change1d": -0.4448,
    "change7d": -0.5707,
    "change30d": -1.9319,
    "change1y": -4.0014,
    "high24h": 1.1222085,
    "low24h": 1.1169153,
    "high30d": 1.1389042,
    "low30d": 1.1171949,
    "average30d": 1.1237302,
    "volatility30d": 0.2421,
    "hourly": [
      {
        "hour": 21,
        "price": 1.1216899,
        "timestamp": "2026-10-26T21:39:40.670Z"
      },
      {
        "hour": 22,
        "price": 1.1221166,
        "timestamp": "2026-10-26T22:39:40.670Z"
      },
      {
        "hour": 23,
        "price": 1.1222085,
        "timestamp": "2026-10-26T23:39:40.670Z"
      },
      {
        "hour": 0,
        "price": 1.121266,
        "timestamp": "2026-10-27T00:39:40.670Z"
      },
      {
        "hour": 1,
        "price": 1.1209254,
        "timestamp": "2026-10-27T01:39:40.670Z"
      },
      {
        "hour": 2,
        "price": 1.1214635,
        "timestamp": "2026-10-27T02:39:40.670Z"
      },
      {
        "hour": 3,
        "price": 1.1211743,
        "timestamp": "2026-10-27T03:39:40.670Z"
      },
      {
        "hour": 4,
        "price": 1.120221,
        "timestamp": "2026-10-27T04:39:40.670Z"
      },
      {
        "hour": 5,
        "price": 1.1202649,
        "timestamp": "2026-10-27T05:39:40.670Z"
      },
      {
        "hour": 6,
        "price": 1.1207156,
        "timestamp": "2026-10-27T06:39:40.670Z"
      },
      {
        "hour": 7,
        "price": 1.1200654,
        "timestamp": "2026-10-27T07:39:40.670Z"
      },
      {
        "hour": 8,
        "price": 1.1192919,
        "timestamp": "2026-10-27T08:39:40.670Z"
      },
      {
        "hour": 9,
        "price": 1.1196516,
        "timestamp": "2026-10-27T09:39:40.670Z"
      },
      {
        "hour": 10,
        "price": 1.1198409,
        "timestamp": "2026-10-27T10:39:40.670Z"
      },
      {
        "hour": 11,
        "price": 1.1189437,
        "timestamp": "2026-10-27T11:39:40.670Z"
      },
      {
        "hour": 12,
        "price": 1.1184957,
        "timestamp": "2026-10-27T12:39:40.670Z"
      },
      {
        "hour": 13,
        "price": 1.1190188,
        "timestamp": "2026-10-27T13:39:40.670Z"
      },
      {
        "hour": 14,
        "price": 1.1188423,
        "timestamp": "2026-10-27T14:39:40.670Z"
      },
      {
        "hour": 15,
        "price": 1.1178767,
        "timestamp": "2026-10-27T15:39:40.670Z"
      },
      {
        "hour": 16,
        "price": 1.117813,
        "timestamp": "2026-10-27T16:39:40.670Z"
      },
      {
        "hour": 17,
        "price": 1.1183068,
        "timestamp": "2026-10-27T17:39:40.670Z"
      },
      {
        "hour": 18,
        "price": 1.1177543,
        "timestamp": "2026-10-27T18:39:40.670Z"
      },
      {
        "hour": 19,
        "price": 1.1169153,
        "timestamp": "2026-10-27T19:39:40.670Z"
      },
      {
        "hour": 20,
        "price": 1.1171949,
        "timestamp": "2026-10-27T20:39:40.670Z"
      }
    ],
    "daily": [
      {
        "date": "2026-09-28",
        "price": 1.1389042
      },
      {
        "date": "2026-09-29",
        "price": 1.1360719
      },
      {
        "date": "2026-09-30",
        "price": 1.1332292
      },
      {
        "date": "2026-10-01",
        "price": 1.1316672
      },
      {
        "date": "2026-10-02",
        "price": 1.1253328
      },
      {
        "date": "2026-10-03",
        "price": 1.1253328
      },
      {
        "date": "2026-10-04",
        "price": 1.1258142
      },
      {
        "date": "2026-10-05",
        "price": 1.1183506
      },
      {
        "date": "2026-10-06",
        "price": 1.1214861
      },
      {
        "date": "2026-10-07",
        "price": 1.1230668
      },
      {
        "date": "2026-10-08",
        "price": 1.1204946
      },
      {
        "date": "2026-10-09",
        "price": 1.1238531
      },
      {
        "date": "2026-10-10",
        "price": 1.1201771
      },
      {
        "date": "2026-10-11",
        "price": 1.1203591
      },
      {
        "date": "2026-10-12",
        "price": 1.1200441
      },
      {
        "date": "2026-10-13",
        "price": 1.117512
      },
      {
        "date": "2026-10-14",
        "price": 1.1210926
      },
      {
        "date": "2026-10-15",
        "price": 1.1225096
      },
      {
        "date": "2026-10-16",
        "price": 1.1237597
      },
      {
        "date": "2026-10-17",
        "price": 1.1239024
      },
      {
        "date": "2026-10-18",
        "price": 1.1238973
      },
      {
        "date": "2026-10-19",
        "price": 1.1229457
      },
      {
        "date": "2026-10-20",
        "price": 1.1236069
      },
      {
        "date": "2026-10-21",
        "price": 1.122802
      },
      {
        "date": "2026-10-22",
        "price": 1.1243067
      },
      {
        "date": "2026-10-23",
        "price": 1.1213616
      },
      {
        "date": "2026-10-24",
        "price": 1.120408
      },
      {
        "date": "2026-10-25",
        "price": 1.1202373
      },
      {
        "date": "2026-10-26",
        "price": 1.1221858
      },
      {
        "date": "2026-10-27",
        "price": 1.1171949
      }
    ]
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`currency`	string	`EUR`	ISO 4217 code of the currency priced
`currencyName`	string	`Euro`	English name of the currency; null when none is known
`currencySymbol`	string	`€`	Symbol of the currency (e.g. €); the code itself when it has no symbol
`base`	string	`USD`	ISO 4217 code of the currency the price is in
`baseName`	string	`US Dollar`	English name of the base currency
`price`	number	`1.1171949`	Value of 1 unit of the currency in the base currency
`rate`	number	`0.895099`	Units of the currency per 1 unit of the base currency
`changeDirection`	string	`down`	up, down or unchanged since yesterday's close; null when no close is stored
`date`	string	`2026-10-27`	UTC date of the rates (YYYY-MM-DD)
`lastUpdated`	string	`2026-10-27T20:39:40.670Z`	ISO 8601 time the rates were last refreshed
`change1d`Premium	number	`-0.4448`	Percent change in price since yesterday's close; null until a close from then is stored
`change7d`Premium	number	`-0.5707`	Percent change in price over the last 7 days; null until a close from then is stored
`change30d`Premium	number	`-1.9319`	Percent change in price over the last 30 days; null until a close from then is stored
`change1y`Premium	number	`-4.0014`	Percent change in price over the last year; null when no close from then is stored
`high24h`Premium	number	`1.1222085`	Highest hourly price over the last 24 hours; null when no hours are stored
`low24h`Premium	number	`1.1169153`	Lowest hourly price over the last 24 hours; null when no hours are stored
`high30d`Premium	number	`1.1389042`	Highest daily close over the last 30 days; null until two days are stored
`low30d`Premium	number	`1.1171949`	Lowest daily close over the last 30 days; null until two days are stored
`average30d`Premium	number	`1.1237302`	Mean daily close over the last 30 days; null until two days are stored
`volatility30d`Premium	number	`0.2421`	Standard deviation of the daily percent changes over the last 30 days (not annualized); null until two days are stored
`hourly`Premium	array[24]		Price for each of the last 24 hours, oldest first (when hourly=true)
`hourly.0.hour`Premium	number	`21`	UTC hour of day (0-23) the price was recorded in
`hourly.0.price`Premium	number	`1.1216899`	Value of 1 unit in the base currency at that hour
`hourly.0.timestamp`Premium	string	`2026-10-26T21:39:40.670Z`	ISO 8601 time the price was recorded
`daily`Premium	array[30]		Daily closing price for the last 30 days, oldest first; today is the live price (when daily=true)
`daily.0.date`Premium	string	`2026-09-28`	UTC date of the close (YYYY-MM-DD)
`daily.0.price`Premium	number	`1.1389042`	Value of 1 unit in the base currency at that close

Why ground on it

A model can produce something that looks like this answer from its training data, and be confidently out of date or simply wrong. This source returns the current value in a shape you can check, which is the difference between an answer you can cite and one you have to hedge.

Point an evaluation at currencyName: it is the field most worth pinning a claim to, and it is either present and current or absent — never plausibly invented.

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

Status	What it means
`400` / `422`	The arguments did not validate. The message names the offending one.
`401`	The OAuth session is invalid or expired — reconnect the server.
`403`	Blocked by a key restriction or an IP allow-list. Never a bad identity.
`404`	This source is not part of VerveContext. Check the catalog.
`429`	Out of credits, or a brief rate limit. The message tells them apart.

A call costs 2 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

Currency Watch Widgets: Show a home-currency ticker with today's value, direction arrow and a 24-hour sparkline drawn from the hourly prices.
Treasury Exposure Monitoring: Finance teams flag foreign-currency balances whose 30-day volatility or 7-day move crosses a threshold before month-end revaluation.
Remittance Timing Alerts: Remittance apps tell senders when a currency is near its 30-day high against their home currency so they send at a better rate.
Travel Budget Planning: Travel apps show how a destination's currency has moved over the past month so travellers can decide when to buy cash.

Other ways to use Currency Rate Grounding Data

Set up Currency Rate Grounding Data on VerveContext, or reach the same source a different way. Your VerveContext account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.VerveKit →Reference →

Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →