Name: Currency Converter API | Live Exchange Rates for 160+ Currency
Brand: viv-data
SKU: api-viv-data-currency-converter
Availability: InStock
Author: API Market

gia ly bui

# Currency Converter — Live Exchange Rates, 160+ Currencies

## Overview

The Currency Converter API provides developers with real-time access to exchange rates for over 160 world currencies. This robust API enables seamless conversion of amounts between various global currencies, making it an indispensable tool for financial applications, e-commerce platforms, and international business operations. Powered by open exchange rate data, the API offers live rates, ensures data accuracy, and supports all major currencies, including USD, EUR, CNY, JPY, GBP, AUD, and CAD. A free tier is available, allowing developers to integrate currency conversion capabilities without an immediate API key requirement (for the free tier of the original service, but API.market requires a key).

## Features

*   **Extensive Currency Support:** Convert between 160+ world currencies.
*   **Live Exchange Rates:** Access up-to-date exchange rates for accurate conversions.
*   **Major Currency Coverage:** Includes popular currencies like USD, EUR, GBP, JPY, CNY, AUD, CAD, and more.
*   **Direct Conversion:** A dedicated endpoint for converting a specific amount from one currency to another.
*   **Comprehensive Rates List:** An endpoint to retrieve all exchange rates relative to USD.
*   **Free Tier:** Get started with 1,000 requests per month at no cost.
*   **Cached Data:** Exchange rates are cached for 1 hour, balancing freshness with performance and reliability.

## Use Cases

*   **E-commerce & Global Retail:** Dynamically display product prices in a customer's local currency, improving conversion rates for international shoppers.
*   **Financial Applications:** Integrate live currency conversion into banking apps, investment platforms, or cryptocurrency exchanges for real-time portfolio valuation and transaction processing.
*   **Travel & Tourism:** Develop travel budgeting tools or apps that help users understand costs in foreign currencies, making international trips easier to plan.
*   **Accounting & Expense Management:** Automate the conversion of international expenses and invoices to a standard reporting currency for accurate financial tracking and reconciliation.
*   **Data Analysis & Reporting:** Incorporate live exchange rate data into business intelligence dashboards and reporting tools to analyze global market trends and financial performance.

## Visual Examples

This API provides currency conversion data in JSON format and does not generate visual outputs like images or videos. Therefore, no visual examples are included in this section. For examples of API request and response formats, please refer to the Endpoints section.

## Pricing

The Currency Converter API offers flexible pricing tiers designed to accommodate various usage volumes:

*   **Free:** 1,000 requests per month
*   **Pro:** $19.99 for 10,000 requests per month

Each successful API request to `/convert` or `/rates` counts as one API unit. Different pricing tiers are available based on usage volume, allowing you to scale your consumption as needed.

## API Documentation

### Base URL

All API requests should be made to the following base URL:

`https://prod.api.market/api/v1/viv-data/currency-converter`

### Authentication

Authentication for the Currency Converter API is handled via an API key. You must include your API key in the `x-api-market-key` header for all requests.

```
x-api-market-key: YOUR_API_MARKET_KEY
```

Replace `YOUR_API_MARKET_KEY` with your actual API key obtained from API.market.


### Endpoints

#### GET /api/v1/viv-data/currency-converter/convert

This endpoint allows you to convert a specified amount from one currency to another using live exchange rates.

**Summary:** Convert an amount from one currency to another.

**Parameters:**

*   `from_currency` (query, string, optional): The three-letter ISO currency code of the source currency, e.g., `USD`. Defaults to `USD`.
*   `to` (query, string, required): The three-letter ISO currency code of the target currency, e.g., `CNY`.
*   `amount` (query, number, optional): The amount to convert. Must be at least `0.01`. Defaults to `1`.

**Request Example (cURL):**

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/currency-converter/convert?from_currency=USD&to=CNY&amount=100" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (JSON):**

```json
{
  "from_currency": "USD",
  "to_currency": "CNY",
  "amount": 100,
  "result": 724.50,
  "rate": 7.245,
  "last_updated": "2023-10-27T10:30:00Z"
}
```

#### GET /api/v1/viv-data/currency-converter/rates

This endpoint provides a list of all available exchange rates, with USD as the base currency.

**Summary:** Get all exchange rates relative to USD.

**Parameters:** None

**Request Example (cURL):**

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/currency-converter/rates" \
     -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Response Example (JSON):**

```json
{
  "base_currency": "USD",
  "rates": {
    "AED": 3.67298,
    "AFN": 70.81469,
    "ALL": 96.53696,
    "AMD": 395.06834,
    "ANG": 1.79000,
    "AOA": 830.40000,
    "ARS": 350.00000,
    "AUD": 1.57945,
    "AWG": 1.79000,
    "AZN": 1.70000,
    "BAM": 1.83400,
    "BBD": 2.00000,
    "BDT": 110.00000,
    "BGN": 1.83400,
    "BHD": 0.37697,
    "BIF": 2814.77000,
    "BMD": 1.00000,
    "BND": 1.36531,
    "BOB": 6.90300,
    "BRL": 4.98595,
    "BSD": 1.00000,
    "BTN": 83.27961,
    "BWP": 13.56150,
    "BYN": 3.25000,
    "BZD": 2.00000,
    "CAD": 1.37880,
    "CDF": 2772.50000,
    "CHF": 0.90325,
    "CLP": 941.15000,
    "CNY": 7.24500,
    "COP": 4057.25000,
    "CRC": 526.00000,
    "CUP": 25.75000,
    "CVE": 100.27916,
    "CZK": 23.36100,
    "DJF": 178.00000,
    "DKK": 7.02520,
    "DOP": 56.63000,
    "DZD": 135.07600,
    "EGP": 30.90000,
    "ERN": 15.00000,
    "ETB": 55.48000,
    "EUR": 0.94723,
    "FJD": 2.22744,
    "FKP": 0.82424,
    "GBP": 0.82424,
    "GEL": 2.70000,
    "GGP": 0.82424,
    "GHS": 11.83000,
    "GIP": 0.82424,
    "GMD": 66.00000,
    "GNF": 8585.00000,
    "GTQ": 7.82000,
    "GYD": 208.79000,
    "HKD": 7.81050,
    "HNL": 24.64000,
    "HRK": 7.14000,
    "HTG": 133.00000,
    "HUF": 365.48000,
    "IDR": 15795.00000,
    "ILS": 3.99260,
    "IMP": 0.82424,
    "INR": 83.27961,
    "IQD": 1310.00000,
    "IRR": 42000.00000,
    "ISK": 138.80000,
    "JEP": 0.82424,
    "JMD": 155.00000,
    "JOD": 0.70900,
    "JPY": 150.39000,
    "KES": 149.00000,
    "KGS": 88.80000,
    "KHR": 4106.00000,
    "KMF": 465.98000,
    "KPW": 900.00000,
    "KRW": 1356.90000,
    "KWD": 0.30825,
    "KYD": 0.83333,
    "KZT": 472.50000,
    "LAK": 19485.00000,
    "LBP": 15000.00000,
    "LKR": 326.50000,
    "LRD": 184.00000,
    "LSL": 19.00000,
    "LYD": 4.80500,
    "MAD": 10.29000,
    "MDL": 17.90000,
    "MGA": 4530.00000,
    "MKD": 58.27000,
    "MMK": 2100.00000,
    "MNT": 3445.00000,
    "MOP": 8.08000,
    "MRU": 358.00000,
    "MUR": 44.50000,
    "MVR": 15.36000,
    "MWK": 1100.00000,
    "MXN": 18.06710,
    "MYR": 4.78000,
    "MZN": 63.80000,
    "NAD": 19.00000,
    "NGN": 800.00000,
    "NIO": 36.60000,
    "NOK": 11.05000,
    "NPR": 133.24734,
    "NZD": 1.73715,
    "OMR": 0.38499,
    "PAB": 1.00000,
    "PEN": 3.79000,
    "PGK": 3.65000,
    "PHP": 56.63000,
    "PKR": 279.00000,
    "PLN": 4.25050,
    "PYG": 7320.00000,
    "QAR": 3.64000,
    "RON": 4.70000,
    "RSD": 110.98000,
    "RUB": 93.60000,
    "RWF": 1250.00000,
    "SAR": 3.75000,
    "SBD": 8.35000,
    "SCR": 13.90000,
    "SDG": 597.00000,
    "SEK": 11.09600,
    "SGD": 1.36531,
    "SHP": 0.82424,
    "SLL": 21500.00000,
    "SOS": 570.00000,
    "SRD": 37.00000,
    "SSP": 1000.00000,
    "STN": 23.00000,
    "SYP": 13200.00000,
    "SZL": 19.00000,
    "THB": 36.10000,
    "TJS": 10.95000,
    "TMT": 3.50000,
    "TND": 3.10000,
    "TOP": 2.37000,
    "TRY": 28.00000,
    "TTD": 6.78000,
    "TVD": 1.57945,
    "TWD": 32.30000,
    "TZS": 2500.00000,
    "UAH": 36.75000,
    "UGX": 3765.00000,
    "UYU": 39.00000,
    "UZS": 12200.00000,
    "VES": 35.00000,
    "VND": 24460.00000,
    "VUV": 119.50000,
    "WST": 2.70000,
    "XAF": 621.00000,
    "XCD": 2.70000,
    "XDR": 0.75000,
    "XOF": 621.00000,
    "XPF": 113.00000,
    "YER": 250.00000,
    "ZAR": 19.00000,
    "ZMW": 24.50000,
    "ZWL": 322.00000
  },
  "last_updated": "2023-10-27T10:30:00Z"
}
```

## Status Codes

Understanding HTTP status codes is crucial for effective API integration:

*   **200 OK**: Request successful. The requested data (e.g., currency conversion result or exchange rates) is returned in the response body.
*   **400 Bad Request**: The request was malformed or contained invalid input parameters. This could be due to missing required query parameters (`to` for `/convert`), invalid currency codes, or an `amount` less than `0.01`. Review your request parameters against the endpoint documentation.
*   **401 Unauthorized**: Missing or invalid `x-api-market-key` header. Ensure your API key is correctly included and is active.
*   **403 Forbidden**: Your API key is valid, but you do not have sufficient permissions to access the requested resource, or your account might be restricted.
*   **404 Not Found**: The requested API endpoint or resource does not exist. Double-check the URL path.
*   **429 Too Many Requests**: You have exceeded your API rate limit. See the Rate Limits section for more information.
*   **500 Internal Server Error**: A generic error indicating an unexpected condition on the server. This is typically a server-side issue.
*   **503 Service Unavailable**: The service is temporarily unable to handle the request, possibly due to maintenance or overload. This is usually a transient error.



## Implementation Guide

This section provides code examples for integrating with the Currency Converter API in various programming languages. As this is a synchronous API, all examples make a single request and directly parse the result.

### Example Code

Replace `YOUR_API_MARKET_KEY` with your actual API key.

#### JavaScript

```javascript
// JavaScript example for synchronous API calls
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/viv-data/currency-converter";

async function convertCurrency(fromCurrency, toCurrency, amount) {
  try {
    const url = new URL(`${baseUrl}/convert`);
    url.searchParams.append("from_currency", fromCurrency);
    url.searchParams.append("to", toCurrency);
    url.searchParams.append("amount", amount);

    // Set a client-side timeout for the request (e.g., 30 seconds)
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 30000); // 30 seconds

    const response = await fetch(url.toString(), {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey
      },
      signal: controller.signal // Link the abort controller to the request
    });

    clearTimeout(timeoutId); // Clear timeout if request completes before timeout

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
    }

    const result = await response.json();
    return result;
  } catch (error) {
    if (error.name === 'AbortError') {
        console.error("Request timed out:", error);
        throw new Error("API request timed out.");
    }
    console.error("Error converting currency:", error);
    throw error;
  }
}

async function getExchangeRates() {
  try {
    // Set a client-side timeout for the request (e.g., 30 seconds)
    const controller = new AbortController();
    const timeoutId = setTimeout(() => controller.abort(), 30000); // 30 seconds

    const response = await fetch(`${baseUrl}/rates`, {
      method: "GET",
      headers: {
        "x-api-market-key": apiKey
      },
      signal: controller.signal // Link the abort controller to the request
    });

    clearTimeout(timeoutId); // Clear timeout if request completes before timeout

    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${JSON.stringify(errorData)}`);
    }

    const result = await response.json();
    return result;
  } catch (error) {
    if (error.name === 'AbortError') {
        console.error("Request timed out:", error);
        throw new Error("API request timed out.");
    }
    console.error("Error fetching rates:", error);
    throw error;
  }
}

// Example Usage:
(async () => {
  try {
    console.log("Converting 100 USD to CNY:");
    const conversionResult = await convertCurrency("USD", "CNY", 100);
    console.log(conversionResult);

    console.log("\nGetting all exchange rates relative to USD:");
    const ratesResult = await getExchangeRates();
    console.log(ratesResult.rates.EUR); // Access specific rate
    console.log(ratesResult.last_updated); // Access last updated time
  } catch (error) {
    console.error("Operation failed:", error.message);
  }
})();
```

#### Python

```python
# Python example for synchronous API calls
import requests
import time

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/viv-data/currency-converter"

def convert_currency(from_currency: str, to_currency: str, amount: float = 1.0):
    """
    Converts an amount from one currency to another.
    """
    headers = {
        "x-api-market-key": API_KEY
    }
    params = {
        "from_currency": from_currency,
        "to": to_currency,
        "amount": amount
    }
    
    try:
        # Set a client-side timeout for the request (e.g., 30 seconds)
        response = requests.get(f"{BASE_URL}/convert", headers=headers, params=params, timeout=30)
        response.raise_for_status()  # Raise an exception for HTTP errors (4xx or 5xx)
        return response.json()
    except requests.exceptions.Timeout:
        raise Exception("API request timed out after 30 seconds.")
    except requests.exceptions.RequestException as e:
        error_message = f"API error: {e}"
        if e.response is not None:
            error_message += f" - {e.response.status_code} {e.response.text}"
        raise Exception(error_message)

def get_exchange_rates():
    """
    Gets all exchange rates relative to USD.
    """
    headers = {
        "x-api-market-key": API_KEY
    }
    
    try:
        # Set a client-side timeout for the request (e.g., 30 seconds)
        response = requests.get(f"{BASE_URL}/rates", headers=headers, timeout=30)
        response.raise_for_status()  # Raise an exception for HTTP errors (4xx or 5xx)
        return response.json()
    except requests.exceptions.Timeout:
        raise Exception("API request timed out after 30 seconds.")
    except requests.exceptions.RequestException as e:
        error_message = f"API error: {e}"
        if e.response is not None:
            error_message += f" - {e.response.status_code} {e.response.text}"
        raise Exception(error_message)

# Example Usage:
if __name__ == "__main__":
    try:
        print("Converting 100 USD to CNY:")
        conversion_result = convert_currency("USD", "CNY", 100)
        print(conversion_result)

        print("\nGetting all exchange rates relative to USD:")
        rates_result = get_exchange_rates()
        print(f"1 USD to EUR: {rates_result['rates']['EUR']}")
        print(f"Last updated: {rates_result['last_updated']}")
    except Exception as e:
        print(f"Operation failed: {e}")
```

## cURL

### Convert one currency to another

The following example converts **100 USD** to **CNY**.

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/currency-converter/convert?from_currency=USD&to=CNY&amount=100" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response**

```json
{
  "from_currency": "USD",
  "to_currency": "CNY",
  "amount": 100,
  "result": 724.50,
  "rate": 7.245,
  "last_updated": "2023-10-27T10:30:00Z"
}
```

---

### Get all exchange rates

Retrieve the latest exchange rates relative to the default base currency.

```bash
curl -X GET "https://prod.api.market/api/v1/viv-data/currency-converter/rates" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

**Example Response**

```json
{
  "base_currency": "USD",
  "rates": {
    "AED": 3.67298,
    "AFN": 70.81469,
    "...": "...",
    "ZWL": 322.00000
  },
  "last_updated": "2023-10-27T10:30:00Z"
}
```

## FAQ

**Q: How many currencies does the API support?**

A: The API supports conversion between over 160 world currencies.

**Q: Are the exchange rates live? How often are they updated?**

A: Yes, the API provides live exchange rates. The underlying data source is updated frequently, and the API itself caches these rates for 1 hour to balance freshness with performance.

**Q: Is an API key required to use this service?**

A: Yes, all requests to the Currency Converter API on API.market require an `x-api-market-key` header for authentication, even when using the free tier.

**Q: What is the free tier usage limit?**

A: The free tier allows for 1,000 API requests per month.

**Q: What happens if I exceed my rate limit?**

A: If you exceed your monthly request limit, your API requests will return a `429 Too Many Requests` HTTP status code. You would need to upgrade your plan to continue using the API.

**Q: Where does the exchange rate data come from?**

A: Exchange rates are sourced from open.er-api.com.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Access the Currency Converter API for real-time exchange rates across 160+ global currencies. Easily convert amounts, retrieve live exchange rates, and integrate reliable financial data into your applications.