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. |
Supported Currencies
170+ world currencies supported including fiat currencies, cryptocurrencies, and precious metals.
| Code | Currency | Region |
|---|---|---|
AED | UAE Dirham | United Arab Emirates |
AFN | Afghan Afghani | Afghanistan |
ALL | Albanian Lek | Albania |
AMD | Armenian Dram | Armenia |
ANG | Netherlands Antillean Guilder | Curaçao |
AOA | Angolan Kwanza | Angola |
ARS | Argentine Peso | Argentina |
AUD | Australian Dollar | Australia |
AWG | Aruban Florin | Aruba |
AZN | Azerbaijani Manat | Azerbaijan |
BAM | Bosnia-Herzegovina Convertible Mark | Bosnia and Herzegovina |
BBD | Barbadian Dollar | Barbados |
BDT | Bangladeshi Taka | Bangladesh |
BGN | Bulgarian Lev | Bulgaria |
BHD | Bahraini Dinar | Bahrain |
BIF | Burundian Franc | Burundi |
BMD | Bermudan Dollar | Bermuda |
BND | Brunei Dollar | Brunei |
BOB | Bolivian Boliviano | Bolivia |
BRL | Brazilian Real | Brazil |
BSD | Bahamian Dollar | Bahamas |
BTC | Bitcoin | Cryptocurrency |
BTN | Bhutanese Ngultrum | Bhutan |
BWP | Botswanan Pula | Botswana |
BYN | Belarusian Ruble | Belarus |
BZD | Belize Dollar | Belize |
CAD | Canadian Dollar | Canada |
CDF | Congolese Franc | Democratic Republic of the Congo |
CHF | Swiss Franc | Switzerland |
CLF | Chilean Unit of Account (UF) | Chile |
CLP | Chilean Peso | Chile |
CNH | Chinese Yuan (Offshore) | China |
CNY | Chinese Yuan | China |
COP | Colombian Peso | Colombia |
CRC | Costa Rican Colón | Costa Rica |
CUC | Cuban Convertible Peso | Cuba |
CUP | Cuban Peso | Cuba |
CVE | Cape Verdean Escudo | Cape Verde |
CZK | Czech Koruna | Czech Republic |
DJF | Djiboutian Franc | Djibouti |
DKK | Danish Krone | Denmark |
DOP | Dominican Peso | Dominican Republic |
DZD | Algerian Dinar | Algeria |
EGP | Egyptian Pound | Egypt |
ERN | Eritrean Nakfa | Eritrea |
ETB | Ethiopian Birr | Ethiopia |
EUR | Euro | European Union |
FJD | Fijian Dollar | Fiji |
FKP | Falkland Islands Pound | Falkland Islands |
GBP | British Pound Sterling | United Kingdom |
GEL | Georgian Lari | Georgia |
GGP | Guernsey Pound | Guernsey |
GHS | Ghanaian Cedi | Ghana |
GIP | Gibraltar Pound | Gibraltar |
GMD | Gambian Dalasi | Gambia |
GNF | Guinean Franc | Guinea |
GTQ | Guatemalan Quetzal | Guatemala |
GYD | Guyanaese Dollar | Guyana |
HKD | Hong Kong Dollar | Hong Kong |
HNL | Honduran Lempira | Honduras |
HRK | Croatian Kuna | Croatia |
HTG | Haitian Gourde | Haiti |
HUF | Hungarian Forint | Hungary |
IDR | Indonesian Rupiah | Indonesia |
ILS | Israeli New Shekel | Israel |
IMP | Isle of Man Pound | Isle of Man |
INR | Indian Rupee | India |
IQD | Iraqi Dinar | Iraq |
IRR | Iranian Rial | Iran |
ISK | Icelandic Króna | Iceland |
JEP | Jersey Pound | Jersey |
JMD | Jamaican Dollar | Jamaica |
JOD | Jordanian Dinar | Jordan |
JPY | Japanese Yen | Japan |
KES | Kenyan Shilling | Kenya |
KGS | Kyrgystani Som | Kyrgyzstan |
KHR | Cambodian Riel | Cambodia |
KMF | Comorian Franc | Comoros |
KPW | North Korean Won | North Korea |
KRW | South Korean Won | South Korea |
KWD | Kuwaiti Dinar | Kuwait |
KYD | Cayman Islands Dollar | Cayman Islands |
KZT | Kazakhstani Tenge | Kazakhstan |
LAK | Laotian Kip | Laos |
LBP | Lebanese Pound | Lebanon |
LKR | Sri Lankan Rupee | Sri Lanka |
LRD | Liberian Dollar | Liberia |
LSL | Lesotho Loti | Lesotho |
LYD | Libyan Dinar | Libya |
MAD | Moroccan Dirham | Morocco |
MDL | Moldovan Leu | Moldova |
MGA | Malagasy Ariary | Madagascar |
MKD | Macedonian Denar | North Macedonia |
MMK | Myanmar Kyat | Myanmar |
MNT | Mongolian Tugrik | Mongolia |
MOP | Macanese Pataca | Macau |
MRU | Mauritanian Ouguiya | Mauritania |
MUR | Mauritian Rupee | Mauritius |
MVR | Maldivian Rufiyaa | Maldives |
MWK | Malawian Kwacha | Malawi |
MXN | Mexican Peso | Mexico |
MYR | Malaysian Ringgit | Malaysia |
MZN | Mozambican Metical | Mozambique |
NAD | Namibian Dollar | Namibia |
NGN | Nigerian Naira | Nigeria |
NIO | Nicaraguan Córdoba | Nicaragua |
NOK | Norwegian Krone | Norway |
NPR | Nepalese Rupee | Nepal |
NZD | New Zealand Dollar | New Zealand |
OMR | Omani Rial | Oman |
PAB | Panamanian Balboa | Panama |
PEN | Peruvian Sol | Peru |
PGK | Papua New Guinean Kina | Papua New Guinea |
PHP | Philippine Peso | Philippines |
PKR | Pakistani Rupee | Pakistan |
PLN | Polish Zloty | Poland |
PYG | Paraguayan Guarani | Paraguay |
QAR | Qatari Rial | Qatar |
RON | Romanian Leu | Romania |
RSD | Serbian Dinar | Serbia |
RUB | Russian Ruble | Russia |
RWF | Rwandan Franc | Rwanda |
SAR | Saudi Riyal | Saudi Arabia |
SBD | Solomon Islands Dollar | Solomon Islands |
SCR | Seychellois Rupee | Seychelles |
SDG | Sudanese Pound | Sudan |
SEK | Swedish Krona | Sweden |
SGD | Singapore Dollar | Singapore |
SHP | Saint Helena Pound | Saint Helena |
SLE | Sierra Leonean Leone (new) | Sierra Leone |
SLL | Sierra Leonean Leone (old) | Sierra Leone |
SOS | Somali Shilling | Somalia |
SRD | Surinamese Dollar | Suriname |
SSP | South Sudanese Pound | South Sudan |
STD | São Tomé and Príncipe Dobra (old) | São Tomé and Príncipe |
STN | São Tomé and Príncipe Dobra | São Tomé and Príncipe |
SVC | Salvadoran Colón | El Salvador |
SYP | Syrian Pound | Syria |
SZL | Swazi Lilangeni | Eswatini |
THB | Thai Baht | Thailand |
TJS | Tajikistani Somoni | Tajikistan |
TMT | Turkmenistani Manat | Turkmenistan |
TND | Tunisian Dinar | Tunisia |
TOP | Tongan Paʻanga | Tonga |
TRY | Turkish Lira | Turkey |
TTD | Trinidad and Tobago Dollar | Trinidad and Tobago |
TWD | New Taiwan Dollar | Taiwan |
TZS | Tanzanian Shilling | Tanzania |
UAH | Ukrainian Hryvnia | Ukraine |
UGX | Ugandan Shilling | Uganda |
USD | United States Dollar | United States |
UYU | Uruguayan Peso | Uruguay |
UZS | Uzbekistani Som | Uzbekistan |
VES | Venezuelan Bolívar Soberano | Venezuela |
VND | Vietnamese Dong | Vietnam |
VUV | Vanuatu Vatu | Vanuatu |
WST | Samoan Tala | Samoa |
XAF | Central African CFA Franc | Central Africa |
XAG | Silver (troy ounce) | Precious Metal |
XAU | Gold (troy ounce) | Precious Metal |
XCD | East Caribbean Dollar | Eastern Caribbean |
XCG | Caribbean Guilder | Caribbean |
XDR | Special Drawing Rights | International Monetary Fund |
XOF | West African CFA Franc | West Africa |
XPD | Palladium (troy ounce) | Precious Metal |
XPF | CFP Franc | French Pacific Territories |
XPT | Platinum (troy ounce) | Precious Metal |
YER | Yemeni Rial | Yemen |
ZAR | South African Rand | South Africa |
ZMW | Zambian Kwacha | Zambia |
ZWG | Zimbabwean Gold | Zimbabwe |
ZWL | Zimbabwean Dollar | Zimbabwe |
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: