# CurrencyApi - Real-time Currency Exchange Rate API

## Product Overview

CurrencyApi.net is a comprehensive currency exchange rate API service that provides real-time and historical exchange rate data for 166 currencies, including major fiat currencies, leading cryptocurrencies, and precious metals.

The API is designed for developers, businesses, and e-commerce platforms that need accurate and reliable currency data for conversions, pricing, reporting, or financial analysis. It offers simple RESTful endpoints that return JSON responses, making integration fast and straightforward across any language or framework. CurrencyApi.net supports both live and historical rates, automatic caching for performance, and secure authentication via API keys. With tiered pricing plans — including a free plan for light usage — it’s an accessible solution for startups as well as enterprise-level applications requiring high-volume, low-latency exchange rate data.

## Key Features

- **Real-time Data**: Live currency rates updated every 1-60 minutes depending on plan
- **Historical Data**: Access to historical rates back to year 2000
- **166 Currencies**: Support for major fiat currencies, cryptocurrencies, and precious metals
- **Multiple Formats**: JSON and XML response formats
- **Global Infrastructure**: 330 edge locations worldwide for low latency
- **High Reliability**: 99.9% uptime with redundant systems
- **Fast Response**: ~50ms average response time
- **Developer-Friendly**: Comprehensive documentation and SDKs
- **Secure**: HTTPS encryption and API key authentication
- **Scalable**: Handles 50+ million monthly requests

## What CurrencyAPI Can Be Used For

- **E-commerce Applications**: Real-time currency conversion for online stores
- **Financial Dashboards**: Live currency tracking and historical analysis
- **Mobile Apps**: Currency conversion features for travel and finance apps
- **Business Intelligence**: Historical currency trend analysis
- **Payment Processing**: Multi-currency payment handling
- **Travel Applications**: Currency conversion for travelers
- **Accounting Software**: Multi-currency financial reporting
- **Cryptocurrency Platforms**: Crypto-to-fiat conversion rates
- **Investment Tools**: Portfolio valuation in multiple currencies

## Pricing Plans

### Free Plan - $0/month
- 500 monthly requests
- Updated every 60 minutes
- Includes Live Rates
- Secured using HTTPS
- Fixed base currency
- No team management
- 10 requests per minute
- Only 1 API key
- No IP whitelisting/blacklisting
- No technical support
- Personal use only

### Essential Plan - $9.99/month ($99.99/year)
- 20,000 monthly requests
- Updated every 60 minutes
- Includes Live Rates
- Includes Convert Rates
- Includes Historical Rates
- Change base currency
- No rate limits
- Secured using HTTPS
- Technical email support
- Commercial Use
- No team management
- Only 1 API key
- No IP whitelisting/blacklisting

### StartUp Plan - $34.99/month ($349.99/year) - POPULAR
- 125,000 monthly requests
- Updated every 10 minutes
- Includes Live Rates
- Includes Convert Rates
- Includes Historical Rates
- Includes Timeframe Endpoint
- Team management
- 2 API keys
- Change base currency
- No rate limits
- Secured using HTTPS
- Technical email support
- Commercial Use
- No IP whitelisting/blacklisting

### Professional Plan - $74.99/month ($749.99/year)
- 10,000,000 monthly requests
- Updated every 60 seconds
- Includes Live Rates
- Includes Convert Rates
- Includes Historical Rates
- Includes Timeframe Endpoint
- Includes OHLC Endpoint
- Team management
- 5 API keys
- IP whitelisting/blacklisting
- Change base currency
- No rate limits
- Secured using HTTPS
- Technical email support
- Commercial Use

## Technical Specifications

### Response Formats
- JSON (default)
- XML

### Authentication
- API Key based authentication
- Pass API key as query parameter: `?key=YOUR_API_KEY`


## API Endpoints

### 1. Live Rates - `/api/v2/rates`
**Purpose**: Retrieve live currency rates based on a specified base currency
**Documentation**: https://currencyapi.net/documentation/rates/
**Available on**: All Plans
**Rates Update Frequencies:**
- Free Plan: Every 60 minutes
- Essential Plan: Every 60 minutes
- StartUp Plan: Every 10 minutes
- Professional Plan: Every 60 seconds

**Example Request**:
```
GET https://currencyapi.net/api/v2/rates?key=YOUR_API_KEY&base=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "updated": 1756749004,
    "base": "USD",
    "rates": {
        "AED": 3.6724997,
        "AFN": 69.4676486,
        "ALL": 83.55401,
        "AMD": 382.61,
        "ANG": 1.78902046,
        "AOA": 917,
        "ARS": 1376.49413,
        "AUD": 1.526182,
        "AWG": 1.80244451,
        "AZN": 1.7
    }
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `base` (string, optional): The base currency for exchange rates (default: USD)
- `output` (string, optional): Response format - "json" (default) or "xml"

### 2. Convert - `/api/v2/convert`
**Purpose**: Convert specific amounts between currencies using real-time exchange rates
**Documentation**: https://currencyapi.net/documentation/convert/
**Available on**: Essential, StartUp, Professional Plans

**Example Request**:
```
GET https://currencyapi.net/api/v2/convert?key=YOUR_API_KEY&amount=100&from=GBP&to=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "updated": 1756801323,
    "conversion": {
        "amount": 100,
        "from": "GBP",
        "to": "USD",
        "result": 134.109999926763
    }
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `amount` (number, required): The amount to convert
- `from` (string, required): Source currency code (e.g., USD, EUR, GBP)
- `to` (string, required): Target currency code (e.g., USD, EUR, GBP)
- `output` (string, optional): Response format - "json" (default) or "xml"

### 3. Historical Rates - `/api/v2/history`
**Purpose**: Get historical exchange rates for a single day
**Documentation**: https://currencyapi.net/documentation/history/
**Available on**: Essential, StartUp, Professional Plans

**Example Request**:
```
GET https://currencyapi.net/api/v2/history?key=YOUR_API_KEY&date=2026-01-01&base=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "base": "USD",
    "date": "2026-01-01",
    "rates": {
        "ADA": 2.990430622,
        "AED": 3.6725,
        "AFN": 66.10613,
        "ALL": 82.46228,
        "AMD": 381.6469,
        "ANG": 1.789,
        "AOA": 917,
        "ARS": 1449.697,
        "AUD": 1.497454,
        "AWG": 1.8025,
        "AZN": 1.7
        ....
    }
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `date` (string, required): Date in YYYY-MM-DD format
- `base` (string, optional): Base currency for exchange rates (default: USD)
- `output` (string, optional): Response format - "json" (default) or "xml"

### 4. Timeframe - `/api/v2/timeframe`
**Purpose**: Get exchange rates for specific date ranges and periods
**Documentation**: https://currencyapi.net/documentation/timeframe/
**Available on**: StartUp, Professional Plans

**Example Request**:
```
GET https://currencyapi.net/api/v2/timeframe?key=YOUR_API_KEY&start_date=2026-01-01&end_date=2026-01-10&base=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "base": "USD",
    "start_date": "2026-01-01",
    "end_date": "2026-01-10",
    "rates": {
        "2026-01-01": {
            "ADA": 2.990430622,
            "AED": 3.6725,
            "AFN": 66.10613,
            "ALL": 82.46228,
            "AMD": 381.6469,
            "ANG": 1.789,
            "AOA": 917,
            "ARS": 1449.697,
            "AUD": 1.497454,
            "AWG": 1.8025,
            "AZN": 1.7,
            ...
        },
        ...
        "2026-01-10": {
            "ADA": 2.8149190711,
            "AED": 3.6729,
            "AFN": 65.5,
            "ALL": 82.275,
            "AMD": 381.2253,
            "ANG": 1.789,
            "AOA": 917,
            "ARS": 1477.20241,
            "AUD": 1.49365198,
            "AWG": 1.8012,
            "AZN": 1.7,
            ...
        }
    }
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `start_date` (string, required): Start of date range (YYYY-MM-DD format, max 1 year range)
- `end_date` (string, required): End of date range (YYYY-MM-DD format, max 1 year range)
- `base` (string, optional): Base currency for exchange rates (default: USD)
- `output` (string, optional): Response format - "json" (default) or "xml"

### 5. Currencies - `/api/v2/currencies`
**Purpose**: Get a complete list of all supported currencies, cryptocurrencies, and precious metals
**Documentation**: https://currencyapi.net/documentation/currencies/
**Available on**: All Plans

**Example Request**:
```
GET https://currencyapi.net/api/v2/currencies?key=YOUR_API_KEY
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "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"
    }
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `output` (string, optional): Response format - "json" (default) or "xml"

### 6. OHLC - `/api/v2/ohlc`
**Purpose**: Get OHLC (Open, High, Low, Close) price data for currency pairs with various time intervals for technical analysis and charting
**Documentation**: https://currencyapi.net/documentation/ohlc/
**Available on**: Professional Plan only

**Example Request**:
```
GET https://currencyapi.net/api/v2/ohlc?key=YOUR_API_KEY&currency=EUR&date=2026-01-15&base=USD&interval=5m
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "base": "USD",
    "quote": "EUR",
    "date": "2026-01-15",
    "interval": "5m",
    "ohlc": [
        {
            "start": "2026-01-15T00:00:00.000Z",
            "open": 0.8586839996,
            "high": 0.8587480022,
            "low": 0.8586839996,
            "close": 0.8587465161
        },
        {
            "start": "2026-01-15T00:05:00.000Z",
            "open": 0.8587476166,
            "high": 0.8588048873,
            "low": 0.8587476166,
            "close": 0.8588048873
        },
        ... more ohlc ...
    ]
}
```

**Request Parameters**:
- `key` (string, required): Your API key for authentication
- `currency` (string, required): Target currency code (e.g., EUR, GBP, BTC). This is the quote currency in the pair.
- `date` (string, required): Date in YYYY-MM-DD format (e.g., 2026-01-15). Must be in the past (not today or future).
- `base` (string, optional): Base currency code (e.g., USD, EUR). Defaults to USD.
- `interval` (string, optional): Time interval for OHLC. Allowed values: 5m, 15m, 30m, 1h, 4h, 12h, 1d. Defaults to 1d.
- `output` (string, optional): Response format - "json" (default) or "xml"

## Supported Currencies (166 Total)

**Fiat Currencies:**
- ADA (Cardano)
- 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 and Herzegovina Convertible Mark)
- BBD (Barbadian Dollar)
- BDT (Bangladeshi Taka)
- BGN (Bulgarian Lev)
- BHD (Bahraini Dinar)
- BIF (Burundian Franc)
- BMD (Bermudian Dollar)
- BNB (Binance Coin)
- BND (Brunei Dollar)
- BOB (Bolivian Boliviano)
- BRL (Brazilian Real)
- BSD (Bahamian Dollar)
- BTC (Bitcoin)
- BWP (Botswana Pula)
- BYN (Belarusian Ruble)
- BZD (Belize Dollar)
- CAD (Canadian Dollar)
- CDF (Congolese Franc)
- CHF (Swiss Franc)
- CLF (Chilean Unit of Account)
- CLP (Chilean Peso)
- CNY (Chinese Yuan Renminbi)
- COP (Colombian Peso)
- CRC (Costa Rican Colón)
- CUC (Cuban Convertible Peso)
- CVE (Cape Verdean Escudo)
- CZK (Czech Koruna)
- DJF (Djiboutian Franc)
- DKK (Danish Krone)
- DOGE (Dogecoin)
- DOP (Dominican Peso)
- DOT (Polkadot)
- DZD (Algerian Dinar)
- EGP (Egyptian Pound)
- ERN (Eritrean Nakfa)
- ETB (Ethiopian Birr)
- ETH (Ethereum)
- EUR (Euro)
- FJD (Fijian Dollar)
- FKP (Falkland Islands Pound)
- GBP (Pound Sterling)
- GEL (Georgian Lari)
- GGP (Guernsey Pound)
- GHS (Ghanaian Cedi)
- GIP (Gibraltar Pound)
- GMD (Gambian Dalasi)
- GNF (Guinean Franc)
- GTQ (Guatemalan Quetzal)
- GYD (Guyanese Dollar)
- HKD (Hong Kong Dollar)
- HNL (Honduran Lempira)
- HRK (Croatian Kuna)
- HTG (Haitian Gourde)
- HUF (Hungarian Forint)
- IDR (Indonesian Rupiah)
- ILS (Israeli New Shekel)
- INR (Indian Rupee)
- IQD (Iraqi Dinar)
- IRR (Iranian Rial)
- ISK (Icelandic Króna)
- JEP (Jersey Pound)
- JMD (Jamaican Dollar)
- JOD (Jordanian Dinar)
- JPY (Japanese Yen)
- KES (Kenyan Shilling)
- KGS (Kyrgyzstani Som)
- KHR (Cambodian Riel)
- KMF (Comorian Franc)
- KRW (South Korean Won)
- KWD (Kuwaiti Dinar)
- KYD (Cayman Islands Dollar)
- KZT (Kazakhstani Tenge)
- LAK (Lao Kip)
- LBP (Lebanese Pound)
- LINK (Chainlink)
- LKR (Sri Lankan Rupee)
- LRD (Liberian Dollar)
- LSL (Lesotho Loti)
- LTC (Litecoin)
- LYD (Libyan Dinar)
- MAD (Moroccan Dirham)
- MDL (Moldovan Leu)
- MGA (Malagasy Ariary)
- MKD (Macedonian Denar)
- MMK (Myanmar Kyat)
- MNT (Mongolian Tögrög)
- MOP (Macanese Pataca)
- MRO (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 Sol)
- PGK (Papua New Guinean Kina)
- PHP (Philippine Peso)
- PKR (Pakistani Rupee)
- PLN (Polish Złoty)
- PYG (Paraguayan Guaraní)
- QAR (Qatari Riyal)
- RON (Romanian Leu)
- RSD (Serbian Dinar)
- RUB (Russian Ruble)
- RWF (Rwandan Franc)
- SAR (Saudi Arabian Riyal)
- SCR (Seychellois Rupee)
- SDG (Sudanese Pound)
- SEK (Swedish Krona)
- SGD (Singapore Dollar)
- SHP (Saint Helena Pound)
- SLL (Sierra Leonean Leone)
- SOL (Solana)
- SOS (Somali Shilling)
- SRD (Surinamese Dollar)
- STN (São Tomé and Príncipe Dobra)
- SVC (Salvadoran Colón)
- SYP (Syrian Pound)
- SZL (Swazi Lilangeni)
- THB (Thai Baht)
- TJS (Tajikistani Somoni)
- TMT (Turkmen 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)
- USDC (USD Coin)
- USDT (Tether)
- UYU (Uruguayan Peso)
- UZS (Uzbekistani Som)
- VES (Venezuelan Bolívar)
- VND (Vietnamese Đồng)
- VUV (Vanuatu Vatu)
- XAF (Central African CFA Franc)
- XAG (Silver)
- XAU (Gold)
- XCD (East Caribbean Dollar)
- XCG (Caribbean guilder)
- XOF (West African CFA Franc)
- XPF (CFP Franc)
- XRP (Ripple)
- YER (Yemeni Rial)
- ZAR (South African Rand)
- ZMW (Zambian Kwacha)

**Cryptocurrencies:**
- ADA (Cardano)
- BNB (Binance Coin)
- BTC (Bitcoin)
- DOGE (Dogecoin)
- DOT (Polkadot)
- ETH (Ethereum)
- LINK (Chainlink)
- LTC (Litecoin)
- SOL (Solana)
- USDC (USD Coin)
- USDT (Tether)
- XRP (Ripple)

**Precious Metals:**
- XAU (Gold)
- XAG (Silver)

Full list available at: https://currencyapi.net/currency-list/

## SDKs Available

### Python SDK
- **Documentation**: https://currencyapi.net/sdk/python/
- **Description**: Integrate our Currency API into your Python applications
- **Example**: Get Python Live Rates

### GoLang SDK
- **Documentation**: https://currencyapi.net/sdk/golang/
- **Description**: Integrate our API seamlessly into your Go projects
- **Example**: Convert currencies with Go

### Node.js SDK
- **Documentation**: https://currencyapi.net/sdk/nodejs/
- **Description**: Enhance your Node applications with real-time exchange rates
- **Example**: Use NodeJs SDK

### PHP SDK
- **Documentation**: https://currencyapi.net/sdk/php/
- **Description**: Integrate our API into your PHP applications effortlessly
- **Example**: Historical Rates with PHP

## Popular Pages and Resources

### Main Pages
- **Homepage**: https://currencyapi.net/
- **Pricing**: https://currencyapi.net/pricing/
- **Documentation**: https://currencyapi.net/documentation/
- **Currency List**: https://currencyapi.net/currency-list/
- **About Us**: https://currencyapi.net/about-us/
- **Contact**: https://currencyapi.net/contact/

### API Documentation
- **Overview**: https://currencyapi.net/documentation/
- **Quickstart**: https://currencyapi.net/documentation/quickstart/
- **Authentication**: https://currencyapi.net/documentation/authentication/
- **Rates Endpoint**: https://currencyapi.net/documentation/rates/
- **Convert Endpoint**: https://currencyapi.net/documentation/convert/
- **History Endpoint**: https://currencyapi.net/documentation/history/
- **Timeframe Endpoint**: https://currencyapi.net/documentation/timeframe/
- **Currencies Endpoint**: https://currencyapi.net/documentation/currencies/
- **OHLC Endpoint**: https://currencyapi.net/documentation/ohlc/
- **Error Codes**: https://currencyapi.net/documentation/error-codes/
- **Changelog**: https://currencyapi.net/documentation/changelog/
- **Migration Guide**: https://currencyapi.net/documentation/migration/

### Tools
- **Currency Converter**: https://currencyapi.net/currency-converter/
- **Exchange Rate API**: https://currencyapi.net/exchange-rate-api/
- **Free Exchange Rate API**: https://currencyapi.net/free-exchange-rate-api/
- **Forex API**: https://currencyapi.net/forex-api/
- **Currency Exchange API**: https://currencyapi.net/currency-exchange-api/
- **FX Rates API**: https://currencyapi.net/fx-rates-api/

### SDKs
- **All SDKs**: https://currencyapi.net/sdk/
- **Python SDK**: https://currencyapi.net/sdk/python/
- **GoLang SDK**: https://currencyapi.net/sdk/golang/
- **Node.js SDK**: https://currencyapi.net/sdk/nodejs/
- **PHP SDK**: https://currencyapi.net/sdk/php/

### Extensions & Plugins
- **Magento**: https://currencyapi.net/magento/
- **Magento Installation Guide**: https://currencyapi.net/extensions/magento/

### Language Specific Pages
- **Python Currency API**: https://currencyapi.net/python-currency-api/
- **Description**: Get live exchange rates in Python. Quickstart guide with code examples for Python developers.
- **Golang Currency API**: https://currencyapi.net/golang-currency-api/
- **Description**: Get live exchange rates in Go. Quickstart guide with code examples for Go developers.
- **Node.js Currency API**: https://currencyapi.net/nodejs-currency-api/
- **Description**: Get live exchange rates in Node.js. Quickstart guide with code examples for JavaScript developers.
- **PHP Currency API**: https://currencyapi.net/php-currency-api/
- **Description**: Get live exchange rates in PHP. Quickstart guide with code examples for PHP developers.
- **Ruby Currency API**: https://currencyapi.net/ruby-currency-api/
- **Description**: Get live exchange rates in Ruby. Quickstart guide with code examples for Ruby developers.
- **Java Currency API**: https://currencyapi.net/java-currency-api/
- **Description**: Get live exchange rates in Java. Quickstart guide with code examples for Java developers.
- **cURL Currency API**: https://currencyapi.net/curl-currency-api/
- **Description**: Get live exchange rates with cURL. Quickstart guide with code examples for command-line tools.


### Legal
- **Terms of Use**: https://currencyapi.net/terms/
- **Website Terms**: https://currencyapi.net/webterms/
- **Privacy Policy**: https://currencyapi.net/privacy-policy/
- **Cookie Policy**: https://currencyapi.net/cookie-policy/

## Company Information

- **Company Name**: House of APIs LTD
- **Founded**: 2019
- **Location**: London, UK
- **Company Number**: 12382069
- **Founder**: Oli Girling
- **LinkedIn**: https://www.linkedin.com/company/currencyapi
- **Twitter**: https://x.com/currencyapi_net

## Support and Contact

- **Technical Support**: Email support for paid plans
- **Status Page**: https://stats.uptimerobot.com/y67MRHrjyx
- **Contact Form**: https://currencyapi.net/contact/
- **Documentation**: https://currencyapi.net/documentation/

## Getting Started

1. Sign up for a free account at https://currencyapi.net/pricing/
2. Get your API key from the dashboard
3. Start making requests to our endpoints
4. Upgrade to a paid plan for commercial use and higher limits

For more information, visit https://currencyapi.net or check our comprehensive documentation at https://currencyapi.net/documentation/.