Currency Rate API

GET

Track one currency's live value, recent moves and 30-day history.

Currency Rate returns one currency's live value in US dollars or any other base, across 170+ currencies, with its name, symbol and direction since yesterday. Paid plans add any base currency, 1-day to 1-year changes, 24-hour and 30-day highs and lows, and hourly and 30-day daily history.

Try it — live request, no key required

Request

GETapi.apiverve.com/v1/currencyrate?currency=EUR

Query parameters

currencystring

Verification

Format

No key required to try it. Get a key to use it in your app.

Example

{
  "status": "ok",
  "error": null,
  "data": {
    "currency": "EUR",
    "currencyName": "Euro",
    "currencySymbol": "€",
    "base": "USD",
    "baseName": "US Dollar",
    "price": 1.1136478,
    "rate": 0.89795,
    "changeDirection": "down",
    "date": "2026-10-27",
    "lastUpdated": "2026-10-27T21:40:09.212Z",
    "change1d": -0.3669,
    "change7d": -0.8927,
    "change30d": -2.2433,
    "change1y": -4.3062,
    "high24h": 1.1177493,
    "low24h": 1.1133452,
    "high30d": 1.1389036,
    "low30d": 1.1136478,
    "average30d": 1.1229754,
    "volatility30d": 0.2717
  }
}

About the Currency Rate API

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.

What people use it for

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.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON: Default REST response
XML: Markup format
YAML: Human-readable
CSV: Tabular export
GraphQL: Query language
MCP: For AI agents

View all integrations →

Other ways to use Currency Rate

Same data, same APIVerve account, same credit balance — one key works on all of them.

Give it to an AI agentConnect over MCP and your agent calls it as a native tool — Claude, Cursor, ChatGPT.on VerveKit Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.on VerveSheets Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.on VerveContext

Questions.

Common questions about the Currency Rate API.

Read the docs →

How is this different from Exchange Rate?

Exchange Rate takes two currencies and returns the rate between them. Currency Rate takes one currency and reports its value in US dollars by default, with its symbol, recent moves and history, which suits watchlists, tickers and alerts where there is only one currency to track.

What does the Free plan return?

The Free plan returns the currency's value in US dollars and units per dollar, its name and symbol, the direction since yesterday's close and the update time. Other base currencies, the 1-day to 1-year changes, 24-hour and 30-day highs and lows, 30-day average and volatility, and the hourly and daily history need any paid plan.

How much history is available?

hourly=true returns the price for each of the last 24 hours and daily=true the last 30 daily closes. The 1-year change is measured against the stored close from a year earlier. Older daily rows are not returned; for a single past day use Exchange Rate with a date.

What would 50,000 currency checks a month cost me?

At 2 credits per call, 50,000 checks use 100,000 credits, half of the Starter plan's 200,000 monthly credits. That works out to about $0.30 per 1,000 calls. The Free plan includes 100 calls each month for testing.

Can I show these rates in a commercial app?

Yes, on any paid plan. You can display the values and history inside your own product, provided you do not resell or redistribute the raw rate data.

Request parameters — GET /v1/currencyrate

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them. Anything not listed here is dropped rather than passed through.

Required

Parameter	Type	Example	Description
`currency`Required	string	`EUR`	The ISO 4217 code of the currency to price (e.g. EUR)

Optional

Parameter	Type	Example	Description
`base`OptionalPremium	string	`USD`	The currency to price it in; defaults to USD default USD
`hourly`OptionalPremium	boolean	`true`	Include the price for each of the last 24 hours default false
`daily`OptionalPremium	boolean	`true`	Include the daily closing price for the last 30 days default false

Example request

1
2

curl "https://api.apiverve.com/v1/currencyrate?currency=EUR&base=USD&hourly=true&daily=true" \
  -H "x-api-key: YOUR_API_KEY"

Authentication

Send your key in the x-api-key header. That is the only auth step — no token exchange, and no per-endpoint scope to configure.

Header	When	Value
`x-api-key`Required	Every request	Your API key. Header names are case-insensitive, so `X-API-Key` is the same header.
`Authorization`Alternate	Instead of the above	`Bearer <key>` — for clients that only expose bearer auth. Resolves to the same account and the same billing.

401 is the only auth verdict

A 401 means the key is missing, invalid or expired. A 403 means the key is valid but not permitted here — blocked by a key restriction or an IP allow-list. Running out of credits is a 429.

Response — GET /v1/currencyrate

Every APIVerve endpoint returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape.

Sample response

{
  "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)
`hour`Premium	number	`21`	UTC hour of day (0-23) the price was recorded in
`price`Premium	number	`1.1216899`	Value of 1 unit in the base currency at that hour
`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)
`date`Premium	string	`"2026-09-28"`	UTC date of the close (YYYY-MM-DD)
`price`Premium	number	`1.1389042`	Value of 1 unit in the base currency at that close

Response headers

Every response carries your balance, so your own code always knows where it stands without polling anything. All four are exposed to browsers through CORS.

Header	What it carries
`x-api-remaining-credits`	Credits left in the current cycle
`x-api-credits-used`	Credits spent in the current cycle
`x-api-max-credits`	The allowance for the cycle
`x-api-version`	Version of the endpoint that answered

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change.

Status	Meaning	What to do
`400`	Input was rejected	Read `error`; it names the parameter that has to change.
`401`	Key missing or invalid	Check the header name and the key value.
`403`	Key valid, but not permitted here	A key restriction or an IP allow-list — never a bad key.
`429`	Rate limited, or out of credits	Read `error` to tell them apart, then back off or top up.

What a call costs — 2 credits per call

Credits are shared across every APIVerve API — one balance, one key, one bill. Failed requests never count against it, so a rejected input costs nothing.

Plan	Per month	Credits	Currency Rate calls	Per 1,000 calls
Free	Free	200	100	Free
Starter	$29.99	200,000	100,000	$0.30
Pro	$99.99	1,000,000	500,000	$0.20
Mega	$299.99	4,000,000	2,000,000	$0.15

Calls are what the credits buy at this API's rate — spend them here, on any of the other APIs, or across both. Nothing is reserved per endpoint.

Compare all pricing tiers →

Call it from cURL — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

cURL

1
2

curl "https://api.apiverve.com/v1/currencyrate" \
  -H "x-api-key: YOUR_API_KEY"

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Node.js — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

Node.js

const res = await fetch("https://api.apiverve.com/v1/currencyrate", {
  headers: { "x-api-key": "YOUR_API_KEY" },
});
const { data } = await res.json();
console.log(data);

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Python — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

Python

import requests

res = requests.get(
    "https://api.apiverve.com/v1/currencyrate",
    headers={"x-api-key": "YOUR_API_KEY"},
)
print(res.json()["data"])

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from C# / .NET — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

C# / .NET

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var json = await client.GetStringAsync("https://api.apiverve.com/v1/currencyrate");
Console.WriteLine(json);

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Go — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/currencyrate", nil)
req.Header.Set("x-api-key", "YOUR_API_KEY")

res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from PHP — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

PHP

$ch = curl_init("https://api.apiverve.com/v1/currencyrate");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);

$response = curl_exec($ch);
echo $response;

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Call it from Ruby — GET /v1/currencyrate

No SDK to install — this is a plain HTTPS call to /v1/currencyrate with your key in the x-api-key header. Swap in a real key and it runs as-is.

Ruby

require "net/http"

uri = URI("https://api.apiverve.com/v1/currencyrate")
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = "YOUR_API_KEY"

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |h| h.request(req) }
puts res.body

Resources

ReferenceCurrency Rate API docsEvery parameter, every response field, and the errors.ParametersWhat this call acceptsRequired and optional inputs, with example values.

Finance

View all 53 →

Currency Rate API

Try it — live request, no key required

About the Currency Rate API

What people use it for

Ways to call it

Other ways to use Currency Rate

Questions.

Request parameters — GET /v1/currencyrate

Required

Optional

Authentication

Response — GET /v1/currencyrate

Response fields

Response headers

Errors

What a call costs — 2 credits per call

Call it from cURL — GET /v1/currencyrate

Resources

Call it from Node.js — GET /v1/currencyrate

Resources

Call it from Python — GET /v1/currencyrate

Resources

Call it from C# / .NET — GET /v1/currencyrate

Resources

Call it from Go — GET /v1/currencyrate

Resources

Call it from PHP — GET /v1/currencyrate

Resources

Call it from Ruby — GET /v1/currencyrate

Resources

Zero-code embed — one snippet, no backend

Changelog — Currency Rate API

Finance

Ready to build with Currency Rate? Start with 200 free credits — one key unlocks all 300+ APIs.

Explore the catalog