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.
Endpoint
One host, one path per API. The block below shows this call in four languages; every one of them is the same HTTP request. Making requests covers the timeouts, retries and parameter rules that apply to all of them. The SDKs wrap the same call in a typed client.
curl "https://api.apiverve.com/v1/currencyrate?currency=EUR&base=USD&hourly=true&daily=true" \
-H "x-api-key: your_api_key_here"const res = await fetch('https://api.apiverve.com/v1/currencyrate?currency=EUR&base=USD&hourly=true&daily=true', {
headers: { 'x-api-key': 'your_api_key_here' },
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const { data } = await res.json();
console.log(data);import requests
res = requests.get(
"https://api.apiverve.com/v1/currencyrate?currency=EUR&base=USD&hourly=true&daily=true",
headers={"x-api-key": "your_api_key_here"},
timeout=15,
)
res.raise_for_status()
print(res.json()["data"])package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/currencyrate?currency=EUR&base=USD&hourly=true&daily=true", nil)
req.Header.Set("x-api-key", "your_api_key_here")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(string(out))
}Replace your_api_key_here with the key from your dashboard. When the inputs arrive as a list rather than one at a time, batch requests run up to 200 of them through this same API in a single call.
Authentication
Send your key in the x-api-key header. That is the only auth step — there is no token exchange and no per-endpoint scope to configure. Authentication covers creating, rotating and revoking keys.
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.
Parameters
Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them.
| Parameter | Type | Description |
|---|---|---|
currencyRequired | string | The ISO 4217 code of the currency to price (e.g. EUR) |
baseOptionalPremium | string | The currency to price it in; defaults to USD default USD |
hourlyOptionalPremium | boolean | Include the price for each of the last 24 hours |
dailyOptionalPremium | boolean | Include the daily closing price for the last 30 days |
Response
Every API returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape. Response format covers the envelope, the other output formats and how premium fields are withheld.
{
"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 |
change1dPremium | number | -0.4448 | Percent change in price since yesterday's close; null until a close from then is stored |
change7dPremium | number | -0.5707 | Percent change in price over the last 7 days; null until a close from then is stored |
change30dPremium | number | -1.9319 | Percent change in price over the last 30 days; null until a close from then is stored |
change1yPremium | number | -4.0014 | Percent change in price over the last year; null when no close from then is stored |
high24hPremium | number | 1.1222085 | Highest hourly price over the last 24 hours; null when no hours are stored |
low24hPremium | number | 1.1169153 | Lowest hourly price over the last 24 hours; null when no hours are stored |
high30dPremium | number | 1.1389042 | Highest daily close over the last 30 days; null until two days are stored |
low30dPremium | number | 1.1171949 | Lowest daily close over the last 30 days; null until two days are stored |
average30dPremium | number | 1.1237302 | Mean daily close over the last 30 days; null until two days are stored |
volatility30dPremium | number | 0.2421 | Standard deviation of the daily percent changes over the last 30 days (not annualized); null until two days are stored |
hourlyPremium | array[24] | Price for each of the last 24 hours, oldest first (when hourly=true) | |
hourPremium | number | 21 | UTC hour of day (0-23) the price was recorded in |
pricePremium | number | 1.1216899 | Value of 1 unit in the base currency at that hour |
timestampPremium | string | "2026-10-26T21:39:40.670Z" | ISO 8601 time the price was recorded |
dailyPremium | array[30] | Daily closing price for the last 30 days, oldest first; today is the live price (when daily=true) | |
datePremium | string | "2026-09-28" | UTC date of the close (YYYY-MM-DD) |
pricePremium | number | 1.1389042 | Value of 1 unit in the base currency at that close |
Errors
Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change. Error handling covers the full status list and which of them are worth retrying.
| Status | Meaning | What to do |
|---|---|---|
400 | Input was rejected | Read error; it names the parameter. |
401 | Key missing or invalid | Check the header name and the key value. |
403 | Key valid, but not permitted | A key restriction or IP allow-list; see key scoping. |
429 | Rate limited, or out of credits | Read error to tell them apart; see rate limits. |
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
Set up Currency Rate on APIVerve, or reach the same source a different way. Your APIVerve account and credits work on all of them — one key, one balance.
Related
More in Finance: