FXRatesAPI

https://fxratesapi.com/docs
Admin
FXRatesAPI is a lightweight exchange rates API that provides real-time and historical currency...
Tokens:9,576
Snippets:48
Trust Score:5.9
Update:6 months ago
Show doc for...
Tokens:
Raw
### NodeJS (axios) Authentication Example

Source: https://fxratesapi.com/docs/authentication

Example of how to make an authenticated API request using NodeJS and the axios library, passing the API key as a query parameter.

```APIDOC
## GET /latest

### Description
Retrieves the latest foreign exchange rates.

### Method
GET

### Endpoint
`/latest`

### Query Parameters
- **api_key** (string) - Required - Your secret API key for authentication.

### Request Example
```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/latest?api_key=fxr_demo_lmasdg193"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

### Response
#### Success Response (200)
- **rates** (object) - An object containing currency codes as keys and their corresponding exchange rates as values.
- **date** (string) - The date for which the rates are provided.

#### Response Example
```json
{
  "rates": {
    "USD": 1.1234,
    "EUR": 1.0000,
    "GBP": 0.8500
  },
  "date": "2023-10-27"
}
```
```

--------------------------------

### Node.js Authentication Example (axios)

Source: https://fxratesapi.com/docs/authentication

Use this Node.js snippet with axios to authenticate API requests by including your secret key as a query parameter. Ensure you have axios installed.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/latest?api_key=fxr_demo_lmasdg193"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### Latest Exchange Rates Response Example

Source: https://fxratesapi.com/docs/endpoints/latest-exchange-rates

This is an example of the JSON response structure for the latest exchange rates. It includes the success status, API terms and privacy policy links, timestamp, date, base currency, and a detailed object of currency rates.

```json
{
            "success": true,
            "terms": "https://fxratesapi.com/legal/terms-conditions",
            "privacy": "https://fxratesapi.com/legal/privacy-policy",
            "timestamp": 1698061860,
            "date": "2023-10-23T11:51:00.000Z",
            "base": "USD",
            "rates": {
                "ADA": 3.7711920503,
                "AED": 3.6722803783,
                "AFN": 75.2606421089,
                "ALL": 99.5053794544,
                "AMD": 399.6574291132,
                "ANG": 1.7832103315,
                "AOA": 823.4652278036,
                "ARB": 1.188943296,
                "ARS": 348.9770899442,
                ....
                "XPF": 112.425249221,
                "XPT": 0.0011152611,
                "XRP": 1.8877988713,
                "YER": 249.3443582949,
                "ZAR": 19.0720122381,
                "ZMK": 9001.2,
                "ZMW": 21.7140836883,
                "ZWL": 5779.9435068617
            }
}
```

--------------------------------

### Time-Series Response Example

Source: https://fxratesapi.com/docs/endpoints/time-series-exchange-rates

This is an example of the JSON response structure for the Time-Series endpoint. The 'rates' object contains nested objects keyed by timestamp, each holding exchange rates for that day.

```json
{
"success": true,
"terms": "https://fxratesapi.com/legal/terms-conditions",
"privacy": "https://fxratesapi.com/legal/privacy-policy",
"base": "USD",
"start_date": "2023-10-09T12:30:21.680Z",
"end_date": "2023-10-23T12:30:21.680Z",
"rates": {
    "2023-10-22T23:59:00.000Z": {
          "ADA": 3.7905190297,
          "AED": 3.6718107085,
          "AFN": 75.3992018529,
          "ALL": 99.5634557448,
          "AMD": 399.8906994231,
          ....
          "ZAR": 18.9690332353,
          "ZMK": 9001.2,
          "ZMW": 21.6915623285,
          "ZWL": 5654.7350907625
    },
    "2023-10-21T23:59:00.000Z": {
          "ADA": 3.8626098689,
          "AED": 3.6741306151,
          "AFN": 75.4264880574,
          "ALL": 99.5994819126,
          "AMD": 400.0354160846,
          ....
          "ZAR": 18.9632332045,
          "ZMK": 9001.2,
          "ZMW": 21.6994122852,
          "ZWL": 5659.6622619645
    },
    "2023-10-20T23:59:00.000Z": {
          "ADA": 3.981834192,
          "AED": 3.6741304968,
          "AFN": 75.4264909934,
          "ALL": 99.5994879682,
          "AMD": 400.0354177099,
          ....
          "ZAR": 18.9632335687,
          "ZMK": 9001.2,
          "ZMW": 21.6994129827,
          "ZWL": 5659.6646967676
    },
    ....
  }
}
}
```

--------------------------------

### Get Historical Exchange Rates with Node.js (axios)

Source: https://fxratesapi.com/docs/endpoints/historical-rates

Use this snippet to fetch historical exchange rates. Ensure you have the 'axios' library installed. The API key is required for the request.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/historical?api_key=fxr_demo_asdiksd21&date=2020-01-01&base=USD&currencies=EUR,GBP,JPY&resolution=1m&amount=1&places=6&format=json"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### GET /convert

Source: https://fxratesapi.com/docs/endpoints/convert-currency

The Conversion Endpoint allows you to swiftly and accurately convert one currency into another using historical or current exchange rate data.

```APIDOC
## GET /convert

### Description
The Conversion Endpoint allows you to swiftly and accurately convert one currency into another. By specifying the source currency, target currency, the amount to convert, and optionally, a specific date, you can obtain the precise converted amount.

### Method
GET

### Endpoint
https://api.fxratesapi.com/convert

### Parameters
#### Query Parameters
- **from** (string) - Required - The currency of the amount you are converting from.
- **to** (string) - Required - The currency you want to have the amount converted to.
- **date** (string) - Optional - The date for which you want to get the exchange rates (YYYY-MM-DD format). Defaults to current date.
- **amount** (number) - Optional - The amount of base currency you want to convert. Defaults to 1.
- **places** (number) - Optional - The amount of decimal places you want to get.
- **format** (string) - Optional - The format of the response (json, xml, tsv). Defaults to json.

### Request Example
GET https://api.fxratesapi.com/convert?from=GBP&to=EUR&date=2012-06-24&amount=234.12&format=json

### Response
#### Success Response (200)
- **success** (boolean) - Indicates whether the request was successful.
- **query** (object) - The query parameters passed in.
- **info** (object) - The exchange rate used for the conversion.
- **result** (number) - The converted amount.
- **timestamp** (number) - The UNIX timestamp of the day the rates are from.
- **date** (string) - The ISO date the rates are from.

#### Response Example
{
  "success": true,
  "query": {
    "from": "GBP",
    "to": "EUR",
    "amount": 234.12
  },
  "info": {
    "rate": 1.245775108
  },
  "historical": false,
  "date": "2012-06-24T23:59:00.000Z",
  "timestamp": 1340582340,
  "result": 291.660868285
}
```

--------------------------------

### Example Error Response

Source: https://fxratesapi.com/docs/error-codes

The structure of a failed API request, including the error code and support information.

```json
{
    "request_id": "ad67fee1-df63-4453-9dcf-020f457a6178",
    "success": false,
    "billed": false,
    "billed_units": 0,
    "error": {
        "code": "PE-A003",
        "status": 403,
        "message": "Provided token is invalid or expired",
        "description": "Make sure you have copied the token correctly from the dashboard.",
        "link": null,
        "support_email": "support@fxratesapi.com"
    }
}
```

--------------------------------

### GET /usage

Source: https://fxratesapi.com/docs/endpoints/usage

Retrieves the latest exchange rates for all currencies or a specific currency pair based on the provided parameters.

```APIDOC
## GET /usage

### Description
Returns the latest exchange rates for all currencies or a specific currency pair. Results are returned in a JSON object where keys are currency codes and values are the exchange rates.

### Method
GET

### Endpoint
https://api.fxratesapi.com/usage

### Parameters
#### Query Parameters
- **resolution** (string) - Optional - The update interval: 1d (daily), 1h (hourly), 10m (every 10 minutes), or 1m (every 60 seconds).
- **currencies** (string) - Optional - Comma-separated list of currency codes to retrieve.
- **base** (string) - Optional - The base currency for exchange rate quotes (default: USD).

### Request Example
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/usage"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

### Response
#### Success Response (200)
- **rates** (object) - Contains exchange rates where keys are currency codes and values are rates.
- **timestamp** (string) - The UTC ISO timestamp of the last update.
```

--------------------------------

### Conversion API Response Structure

Source: https://fxratesapi.com/docs/endpoints/convert-currency

Example of a successful JSON response returned by the conversion endpoint.

```json
{
            "success": true,
            "query": {
                "from": "GBP",
                "to": "EUR",
                "amount": 234.12
            },
            "info": {
                "rate": 1.245775108
            },
            "historical": false,
            "date": "2012-06-24T23:59:00.000Z",
            "timestamp": 1340582340,
            "result": 291.660868285
}
```

--------------------------------

### GET /time-series

Source: https://fxratesapi.com/docs/endpoints/time-series-exchange-rates

Retrieves historical exchange rate data for a specified period.

```APIDOC
## GET /time-series

### Description
Retrieves a series of exchange rates over a specified time range.

### Method
GET

### Endpoint
/time-series

### Query Parameters
- **start_date** (string) - Required - The start date of the time series (YYYY-MM-DD).
- **end_date** (string) - Required - The end date of the time series (YYYY-MM-DD).
- **base** (string) - Optional - The base currency code.
- **symbols** (string) - Optional - Comma-separated list of currency codes to retrieve.

### Response
#### Success Response (200)
- **rates** (object) - A map of dates to exchange rate objects.
- **base** (string) - The base currency used for the rates.
- **start_date** (string) - The start date of the requested range.
- **end_date** (string) - The end date of the requested range.

#### Response Example
{
  "base": "USD",
  "start_date": "2023-01-01",
  "end_date": "2023-01-03",
  "rates": {
    "2023-01-01": { "EUR": 0.94 },
    "2023-01-02": { "EUR": 0.95 },
    "2023-01-03": { "EUR": 0.94 }
  }
}
```

--------------------------------

### GET /timeseries

Source: https://fxratesapi.com/docs/endpoints/time-series-exchange-rates

Retrieves a series of exchange rates over a specified time period. Supports daily, hourly, and minute-level intervals.

```APIDOC
## GET /timeseries

### Description
Retrieves a series of exchange rates over a specified time period. Time-series data is available in multiple resolutions, from daily down to one-minute intervals. Dates are stored in UTC, and ISO 8601 format is recommended.

### Method
GET

### Endpoint
/timeseries

### Query Parameters
- **start_date** (string) - Required - The start date for exchange rates. Format: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.
- **end_date** (string) - Required - The end date for exchange rates. Format: YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss.
- **accuracy** (string) - Optional - Specifies the interval length of the time-series. Options: 'day' (daily, last 365 days), 'hours' (hourly, last 90 days), '15m' (every 15 minutes, last 7 days), '10m' (every 10 minutes, last 7 days), '5m' (every 5 minutes, last 7 days), '1m' (every 60 seconds, last 7 days). Default: 'day'.
- **currencies** (string) - Optional - Comma-separated list of currencies to get exchange rates for. Default: 'all available currencies'.
- **base** (string) - Optional - The base currency for exchange rates. Default: 'USD'.
- **amount** (number) - Optional - The amount of the base currency to convert. Default: 1.
- **places** (integer) - Optional - The number of decimal places to return. Default: 'all available decimals'.
- **format** (string) - Optional - The format of the response. Options: 'json', 'xml', 'tsv'. Default: 'json'.

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **terms** (string) - URL to the terms and conditions.
- **privacy** (string) - URL to the privacy policy.
- **base** (string) - The base currency used for the exchange rates.
- **start_date** (string) - The start date of the returned time-series data.
- **end_date** (string) - The end date of the returned time-series data.
- **rates** (object) - A nested object where keys are timestamps and values are exchange rate objects for that timestamp. Each inner object contains currency codes as keys and their corresponding exchange rates as values.

#### Response Example
```json
{
  "success": true,
  "terms": "https://fxratesapi.com/legal/terms-conditions",
  "privacy": "https://fxratesapi.com/legal/privacy-policy",
  "base": "USD",
  "start_date": "2023-10-09T12:30:21.680Z",
  "end_date": "2023-10-23T12:30:21.680Z",
  "rates": {
    "2023-10-22T23:59:00.000Z": {
      "ADA": 3.7905190297,
      "AED": 3.6718107085,
      "AFN": 75.3992018529,
      "ALL": 99.5634557448,
      "AMD": 399.8906994231,
      "ZAR": 18.9690332353,
      "ZMK": 9001.2,
      "ZMW": 21.6915623285,
      "ZWL": 5654.7350907625
    },
    "2023-10-21T23:59:00.000Z": {
      "ADA": 3.8626098689,
      "AED": 3.6741306151,
      "AFN": 75.4264880574,
      "ALL": 99.5994819126,
      "AMD": 400.0354160846,
      "ZAR": 18.9632332045,
      "ZMK": 9001.2,
      "ZMW": 21.6994122852,
      "ZWL": 5659.6622619645
    }
  }
}
```
```

--------------------------------

### GET /historical

Source: https://fxratesapi.com/docs/endpoints/historical-rates

Retrieve historical exchange rates for a given date. The default date is the current date. Dates must be in YYYY-MM-DD format.

```APIDOC
## GET /historical

### Description
This endpoint allows you to get the historical exchange rates for a date of your choice. The default value is the current date. The date must be specified in the YYYY-MM-DD format.

### Method
GET

### Endpoint
https://api.fxratesapi.com/historical

### Query Parameters
- **api_key** (string) - Required - Your API key.
- **date** (string) - Optional - The date for which you want to get the exchange rates. Format: YYYY-MM-DD. Defaults to the current date.
- **base** (string) - Optional - The base currency for the exchange rates. Defaults to USD.
- **currencies** (string) - Optional - A comma-separated list of currency codes to get rates for. Defaults to all available currencies.
- **amount** (number) - Optional - The amount of the base currency to convert. Defaults to 1.
- **places** (integer) - Optional - The number of decimal places to return. Defaults to the most available decimals for the currency.
- **format** (string) - Optional - The format of the response. Available formats: json, xml, tsv. Defaults to json.

### Request Example
```json
{
  "method": "GET",
  "url": "https://api.fxratesapi.com/historical?api_key=fxr_demo_asdiksd21&date=2020-01-01&base=USD&currencies=EUR,GBP,JPY&resolution=1m&amount=1&places=6&format=json"
}
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates if the request was successful.
- **rates** (object) - Contains exchange rates. Keys are currency codes, values are rates.
- **timestamp** (integer) - The UNIX timestamp of the day the rates are from.
- **date** (string) - The ISO date the rates are from.
- **base** (string) - The base currency of the exchange rates.

#### Response Example
```json
{
    "success": true,
    "terms": "https://fxratesapi.com/legal/terms-conditions",
    "privacy": "https://fxratesapi.com/legal/privacy-policy",
    "timestamp": 1698061860,
    "date": "2023-10-23T11:51:00.000Z",
    "base": "USD",
    "rates": {
        "ADA": 3.7711920503,
        "AED": 3.6722803783,
        "AFN": 75.2606421089,
        "ALL": 99.5053794544,
        "AMD": 399.6574291132,
        "ANG": 1.7832103315,
        "AOA": 823.4652278036,
        "ARB": 1.188943296,
        "ARS": 348.9770899442,
        "XPF": 112.425249221,
        "XPT": 0.0011152611,
        "XRP": 1.8877988713,
        "YER": 249.3443582949,
        "ZAR": 19.0720122381,
        "ZMK": 9001.2,
        "ZMW": 21.7140836883,
        "ZWL": 5779.9435068617
    }
}
```
```

--------------------------------

### Fetch Latest Exchange Rates (Node.js)

Source: https://fxratesapi.com/docs/endpoints/latest-exchange-rates

Use this snippet to retrieve the latest exchange rates for specified currency pairs. Ensure you have the 'axios' library installed. The response includes success status, terms, privacy policy, timestamp, date, base currency, and a rates object.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/latest?base=USD&currencies=EUR,GBP,JPY&resolution=1m&amount=1&places=6&format=json"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### Make Your First API Request

Source: https://fxratesapi.com/docs

Use this URL to retrieve the most recent exchange rates. Replace YOUR_ACCESS_TOKEN with your actual API key. The base currency defaults to USD.

```HTTP
https://api.fxratesapi.com/latest?api_key=YOUR_ACCESS_TOKEN
```

--------------------------------

### List All Available Currencies (Node.js)

Source: https://fxratesapi.com/docs/endpoints/list-available-currencies

Use this snippet to fetch a list of all supported currencies, including cryptocurrencies, from the FXRatesAPI. Requires the axios library for making HTTP requests.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/currencies"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### List all available currencies

Source: https://fxratesapi.com/docs/endpoints/list-available-currencies

Returns a list of all available currencies, including cryptocurrencies.

```APIDOC
## GET /currencies

### Description
Returns a list of all available currencies, including cryptocurrencies.

### Method
GET

### Endpoint
https://api.fxratesapi.com/currencies

### Request Example
```json
{}
```

### Response
#### Success Response (200)
- **currencies** (object) - A dictionary where keys are currency codes and values are currency names.

#### Response Example
```json
{
  "currencies": {
    "AED": "United Arab Emirates Dirham",
    "AFN": "Afghan Afghani",
    "ALL": "Albanian Lek",
    "AMD": "Armenian Dram",
    "ANG": "Netherlands Antillean Guilder",
    "AOA": "Angolan Kwanza",
    "ARS": "Argentine Peso",
    "AUD": "Australian Dollar",
    "AWG": "Aruban Florin",
    "AZN": "Azerbaijani Manat",
    "BAM": "Bosnia-Herzegovina Convertible Mark",
    "BBD": "Barbadian Dollar",
    "BDT": "Bangladeshi Taka",
    "BGN": "Bulgarian Lev",
    "BHD": "Bahraini Dinar",
    "BIF": "Burundian Franc",
    "BMD": "Bermudan Dollar",
    "BND": "Brunei Dollar",
    "BOB": "Bolivian Boliviano",
    "BRL": "Brazilian Real",
    "BSD": "Bahamian Dollar",
    "BTC": "Bitcoin",
    "BTN": "Bhutanese Ngultrum",
    "BWP": "Botswanan Pula",
    "BYN": "Belarusian Ruble",
    "BYR": "Belarusian Ruble",
    "BZD": "Belize Dollar",
    "CAD": "Canadian Dollar",
    "CDF": "Congolese Franc",
    "CHF": "Swiss Franc",
    "CLF": "Chilean Unit of Account (UF)",
    "CLP": "Chilean Peso",
    "CNY": "Chinese Yuan",
    "COP": "Colombian Peso",
    "CRC": "Costa Rican Colón",
    "CUC": "Cuban Convertible Peso",
    "CUP": "Cuban Peso",
    "CVE": "Cape Verdean Escudo",
    "CZK": "Czech Republic Koruna",
    "DJF": "Djiboutian Franc",
    "DKK": "Danish Krone",
    "DOP": "Dominican Peso",
    "DZD": "Algerian Dinar",
    "EGP": "Egyptian Pound",
    "ERN": "Eritrean Nakfa",
    "ETB": "Ethiopian Birr",
    "EUR": "Euro",
    "FJD": "Fijian Dollar",
    "FKP": "Falkland Islands Pound",
    "GBP": "British Pound Sterling",
    "GEL": "Georgian Lari",
    "GGP": "Guernsey Pound",
    "GHS": "Ghanaian Cedi",
    "GIP": "Gibraltar Pound",
    "GMD": "Gambian Dalasi",
    "GNF": "Guinean Franc",
    "GTQ": "Guatemalan Quetzal",
    "GYD": "Guyanaese Dollar",
    "HKD": "Hong Kong Dollar",
    "HNL": "Honduran Lempira",
    "HRK": "Croatian Kuna",
    "HTG": "Haitian Gourde",
    "HUF": "Hungarian Forint",
    "IDR": "Indonesian Rupiah",
    "ILS": "Israeli New Sheqel",
    "IMP": "Manx pound",
    "INR": "Indian Rupee",
    "IQD": "Iraqi Dinar",
    "IRR": "Iranian Rial",
    "ISK": "Icelandic Króna",
    "JMD": "Jamaican Dollar",
    "JOD": "Jordanian Dinar",
    "JPY": "Japanese Yen",
    "KES": "Kenyan Shilling",
    "KGS": "Kyrgystani Som",
    "KHR": "Cambodian Riel",
    "KMF": "Comorian Franc",
    "KPW": "North Korean Won",
    "KRW": "South Korean Won",
    "KWD": "Kuwaiti Dinar",
    "KYD": "Cayman Islands Dollar",
    "KZT": "Kazakhstani Tenge",
    "LAK": "Laotian Kip",
    "LBP": "Lebanese Pound",
    "LKR": "Sri Lankan Rupee",
    "LRD": "Liberian Dollar",
    "LSL": "Lesotho Loti",
    "LTL": "Lithuanian Litas",
    "LVL": "Latvian Lats",
    "LYD": "Libyan Dinar",
    "MAD": "Moroccan Dirham",
    "MDL": "Moldovan Leu",
    "MGA": "Malagasy Ariary",
    "MKD": "Macedonian Denar",
    "MMK": "Myanma Kyat",
    "MNT": "Mongolian Tugrik",
    "MOP": "Macanese Pataca",
    "MRO": "Mauritanian Ouguiya",
    "MRU": "Mauritanian Ouguiya",
    "MUR": "Mauritian Rupee",
    "MVR": "Maldivian Rufiyaa",
    "MWK": "Malawian Kwacha",
    "MXN": "Mexican Peso",
    "MYR": "Malaysian Ringgit",
    "MZN": "Mozambican Metical",
    "NAD": "Namibian Dollar",
    "NGN": "Nigerian Naira",
    "NIO": "Nicaraguan Córdoba",
    "NOK": "Norwegian Krone",
    "NPR": "Nepalese Rupee",
    "NZD": "New Zealand Dollar",
    "OMR": "Omani Rial",
    "PAB": "Panamanian Balboa",
    "PEN": "Peruvian Nuevo Sol",
    "PGK": "Papua New Guinean Kina",
    "PHP": "Philippine Peso",
    "PKR": "Pakistani Rupee",
    "PLN": "Polish Zloty",
    "PYG": "Paraguayan Guarani",
    "QAR": "Qatari Rial",
    "RON": "Romanian Leu",
    "RSD": "Serbian Dinar",
    "RUB": "Russian Ruble",
    "RWF": "Rwandan Franc",
    "SAR": "Saudi Riyal",
    "SBD": "Solomon Islands Dollar",
    "SCR": "Seychellois Rupee",
    "SDG": "Sudanese Pound",
    "SEK": "Swedish Krona",
    "SGD": "Singapore Dollar",
    "SHP": "Saint Helena Pound",
    "SLL": "Sierra Leonean Leone",
    "SOS": "Somali Shilling",
    "SRD": "Surinamese Dollar",
    "STD": "São Tomé and Príncipe Dobra",
    "SVC": "Salvadoran Colón",
    "SYP": "Syrian Pound",
    "SZL": "Swazi Lilangeni",
    "THB": "Thai Baht",
    "TJS": "Tajikistani Somoni",
    "TMT": "Turkmenistani Manat",
    "TND": "Tunisian Dinar",
    "TOP": "Tongan Paʻanga",
    "TRY": "Turkish Lira",
    "TTD": "Trinidad and Tobago Dollar",
    "TWD": "New Taiwan Dollar",
    "TZS": "Tanzanian Shilling",
    "UAH": "Ukrainian Hryvnia",
    "UGX": "Ugandan Shilling",
    "USD": "United States Dollar",
    "UYU": "Uruguayan Peso",
    "UZS": "Uzbekistan Som",
    "VEF": "Venezuelan Bolívar Fuerte",
    "VES": "Venezuelan Bolívar",
    "VND": "Vietnamese Dong",
    "VUV": "Vanuatu Vatu",
    "WST": "Samoan Tala",
    "XAF": "CFA Franc BEAC",
    "XAG": "Silver (troy ounce)",
    "XAU": "Gold (troy ounce)",
    "XCD": "East Caribbean Dollar",
    "XDR": "Special Drawing Rights",
    "XOF": "CFA Franc BCEAO",
    "XPD": "Palladium (troy ounce)",
    "XPF": "CFP Franc",
    "XPT": "Platinum (troy ounce)",
    "YER": "Yemeni Rial",
    "ZAR": "South African Rand",
    "ZMW": "Zambian Kwacha",
    "ZWL": "Zimbabwean Dollar"
  }
}
```

--------------------------------

### Convert Currency with Axios

Source: https://fxratesapi.com/docs/endpoints/convert-currency

Perform a currency conversion request using the Axios library in Node.js.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/convert?from=GBP&to=EUR&date=2012-06-24&amount=234.12&format=json"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### Authentication Methods

Source: https://fxratesapi.com/docs/authentication

Learn how to authenticate your API requests using your secret key. You can pass the key as a query parameter or in the HTTP headers.

```APIDOC
## Authentication

Authenticate your account by including your secret key in API requests. You can manage your API keys on the Dashboard after you have signed up.

We offer two ways to authenticate your requests:
  * **Query Paramters** - Pass your secret key as a `api_key` parameter with the request url (?api_key=YOUR_ACCESS_TOKEN).
  * **HTTP Bearer Auth** - add a field to your request headers with 'Authorization' as the key and 'Bearer YOUR_ACCESS_TOKEN' as the value.
```

--------------------------------

### Fetch Time-Series Exchange Rates (Node.js)

Source: https://fxratesapi.com/docs/endpoints/time-series-exchange-rates

Use this snippet to retrieve a series of exchange rates over a specified date range using the axios library. Ensure dates are in ISO 8601 format.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/timeseries?start_date=2026-03-26T01:02:02.443Z&end_date=2026-04-09T01:02:02.443Z"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### Retrieve API usage with Axios

Source: https://fxratesapi.com/docs/endpoints/usage

Fetches API usage data using the Axios library in a Node.js environment.

```javascript
const axios = require("axios");

const options = {
	"method": "GET",
	"url": "https://api.fxratesapi.com/usage"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

--------------------------------

### Latest Exchange Rates API

Source: https://fxratesapi.com/docs/endpoints/latest-exchange-rates

Retrieves the latest exchange rates for all currencies or a specific currency pair. All results are returned in a JSON object where every key is a currency code and every value is the exchange rate for that currency. Currencies are labeled by their international-standard 3-letter ISO currency codes.

```APIDOC
## GET /latest

### Description
This is the most basic endpoint and also the most used one. It returns the latest exchange rates for all currencies or a specific currency pair.

### Method
GET

### Endpoint
/latest

### Query Parameters
- **resolution** (string) - Optional - The resolution parameter specifies the update interval of the exchange rates. Available resolutions are: 1d (daily), 1h (hourly), 10m (every 10 minutes), 1m (every 60 seconds). Defaults to most current available rates for your subscription plan.
- **currencies** (string) - Optional - The currencies parameter specifies the currencies you want to get the exchange rates for. You can specify multiple currencies by separating them with a comma. Defaults to all available currencies.
- **base** (string) - Optional - The base parameter sets the currency in which exchange rates are quoted. All exchange rates are relative to the base currency. Defaults to USD.
- **amount** (number) - Optional - The amount parameter allows you to specify the amount of the base currency you want to convert. Defaults to 1.
- **places** (integer) - Optional - The places parameter allows you to specify the amount of decimal places you want to get. Defaults to most available decimal places.
- **format** (string) - Optional - The format parameter allows you to specify the format of the response. Available formats are: json, xml, tsv. Defaults to JSON.

### Request Example
```javascript
const axios = require("axios");

const options = {
  "method": "GET",
  "url": "https://api.fxratesapi.com/latest?base=USD&currencies=EUR,GBP,JPY&resolution=1m&amount=1&places=6&format=json"
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});
```

### Response
#### Success Response (200)
- **success** (boolean) - Indicates whether or not the request was successful.
- **rates** (object) - Contains all the exchange rates for the given base currency. The keys are the currency codes and the values are the exchange rates.
- **timestamp** (integer) - The UNIX timestamp of the day the rates are from.
- **date** (string) - The ISO date the rates are from.
- **base** (string) - The base currency of the exchange rates.

#### Response Example
```json
{
    "success": true,
    "terms": "https://fxratesapi.com/legal/terms-conditions",
    "privacy": "https://fxratesapi.com/legal/privacy-policy",
    "timestamp": 1698061860,
    "date": "2023-10-23T11:51:00.000Z",
    "base": "USD",
    "rates": {
        "ADA": 3.7711920503,
        "AED": 3.6722803783,
        "AFN": 75.2606421089,
        "ALL": 99.5053794544,
        "AMD": 399.6574291132,
        "ANG": 1.7832103315,
        "AOA": 823.4652278036,
        "ARB": 1.188943296,
        "ARS": 348.9770899442,
        "XPF": 112.425249221,
        "XPT": 0.0011152611,
        "XRP": 1.8877988713,
        "YER": 249.3443582949,
        "ZAR": 19.0720122381,
        "ZMK": 9001.2,
        "ZMW": 21.7140836883,
        "ZWL": 5779.9435068617
    }
}
```
```
Tokens:
Raw