# 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 152 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
- **152 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
- 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/v1/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/v1/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/v1/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/v1/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/v1/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/v1/history?key=YOUR_API_KEY&date=2020-01-01&base=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "base": "USD",
    "date": "2020-01-01",
    "rates": {
        "AED": 3.6732,
        "AFN": 78.10229,
        "ALL": 109.153557,
        "AMD": 481.455326,
        "ANG": 1.693657,
        "AOA": 482.227,
        "ARS": 59.927532,
        "AUD": 1.424502,
        "AWG": 1.8,
        "AZN": 1.7025
    }
}
```

**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/v1/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/v1/timeframe?key=YOUR_API_KEY&start_date=2017-12-25&end_date=2018-01-10&base=USD
```

**Example Response (JSON)**:
```json
{
    "valid": true,
    "base": "USD",
    "start_date": "2017-12-25",
    "end_date": "2018-01-10",
    "rates": {
        "2017-12-25": {
            "AED": 3.672611,
            "AFN": 69.428,
            "ALL": 112.01884,
            "AMD": 480.27899,
            "ANG": 1.781904,
            "AOA": 165.9235,
            "ARS": 17.9045,
            "AUD": 1.294815,
            "AWG": 1.790501,
            "AZN": 1.7
        },
        "2017-12-26": {
            "AED": 3.672494,
            "AFN": 69.5115,
            "ALL": 112.151679,
            "AMD": 481.726304,
            "ANG": 1.784051,
            "AOA": 165.9235,
            "ARS": 18.326884,
            "AUD": 1.2938,
            "AWG": 1.791501,
            "AZN": 1.69
        }
    }
}
```

**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/v1/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/v1/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"

## Supported Currencies (152 Total)

**Fiat 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)
- BWP (Botswanan Pula)
- BZD (Belize Dollar)
- CAD (Canadian Dollar)
- CDF (Congolese Franc)
- CHF (Swiss Franc)
- CLP (Chilean Peso)
- CNH (Chinese Yuan offshore)
- 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)
- ETB (Ethiopian Birr)
- EUR (Euro)
- FJD (Fijian Dollar)
- GBP (British Pound Sterling)
- GEL (Georgian Lari)
- 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)
- 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)
- 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)
- LYD (Libyan Dinar)
- MAD (Moroccan Dirham)
- MDL (Moldovan Leu)
- MKD (Macedonian Denar)
- MMK (Myanma Kyat)
- MOP (Macanese Pataca)
- 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)
- SLL (Sierra Leonean Leone)
- SOS (Somali Shilling)
- SRD (Surinamese Dollar)
- SVC (Salvadoran Colón)
- 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)
- VND (Vietnamese Dong)
- XAF (CFA Franc BEAC)
- XCD (East Caribbean Dollar)
- XOF (CFA Franc BCEAO)
- YER (Yemeni Rial)
- ZAR (South African Rand)
- ZMW (Zambian Kwacha)

**Cryptocurrencies:**
- BTC (Bitcoin)
- ETH (Ethereum)
- LTC (Litecoin)
- XRP (Ripple)
- BCH (Bitcoin Cash)
- BTG (Bitcoin Gold)
- DASH (DASH)
- EOS (EOS)
- XLM (Stellar Lumens)

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

*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
- **Error Codes**: https://currencyapi.net/documentation/error-codes

### Tools
- **Currency Converter**: https://currencyapi.net/currency-converter
- **Exchange Rate API**: https://currencyapi.net/exchange-rate-api
- **Forex API**: https://currencyapi.net/forex-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

### 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.