CTRL+K
Loading
The APIFreaks Currency Converter API is a high-performance, developer-first REST interface designed to handle complex financial conversions in milliseconds. By aggregating data from top-tier commercial banks and digital asset exchanges, we provide a single source of truth for 970+ global currencies.
Whether you are building a multi-currency e-commerce checkout, a crypto portfolio tracker, or a fintech SaaS, our API delivers the precision and uptime your application demands.
Access 170+ fiat currencies and 800+ cryptocurrencies (including BTC, ETH, and altcoins) through a single endpoint. Eliminate the cost of maintaining multiple financial data providers.
Engineered for performance. Our JSON-based RESTful endpoints deliver conversion results in under 200ms, ensuring your fintech or e-commerce application remains responsive.
Optimize for cost or precision. Unlike rigid competitors, you can specify rate freshness intervals: 1 minute, 10 minutes, 1 hour, or daily updates to suit your specific use case.
Convert any amount based on validated market rates from a specific past date. Ideal for financial auditing, tax reporting, and analyzing historical crypto-to-fiat trends.
Built for high-volume requests with 99.9% uptime and 256-bit HTTPS encryption. Your data is delivered over a secure, reliable architecture designed for 24/7 availability.
$ pip install requests
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| from | Yes | String | - | From currency symbol |
| to | Yes | String | - | To currency symbol |
| amount | No | Integer | 1 | The amount to be converted |
| updates | No | String | 1m | Exchange rates update period. Possible values are: (1) 1d - daily update (2) 1h - hourly update (3) 10m - 10 minute update (4) 1m - 1 minute update |
$ pip install requests
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| from | Yes | String | - | From currency symbol |
| to | Yes | String | - | To currency symbol |
| amount | No | Integer | 1 | The amount to be converted |
| date | Yes | String | - | specific date (format YYYY-MM-DD) of which exchange rates is used. |
Explore detailed response fields including field names, data types, requirements, and descriptions in the interactive Response Tables. For Latest Rates Currency Converter click here, and for Historical Rates Currency Converter click here.
| HTTP Status | Reasons |
|---|---|
| 400 | Invalid Amount. Please provide amount in decimal format and greater than 0! |
| 404 | Rates of provided currency [CURRENCY_CODE] are not available in our database! |
| HTTP Status | Reasons |
|---|---|
| 400 | Provided Date [DATE] is in invalid format. It should be like YYYY-MM-DD! |
| 400 | Invalid Amount. Please provide amount in decimal format and greater than 0! |
| 404 | Rates of provided currency [CURRENCY_CODE] are not available in our database! |
| 404 | Rates of provided currency [DATE] are not available in our database! |
| 404 | Rates of provided currency [CURRENCYCODE] are available from [AVAILABLEFROMDATE] to [AVAILABLEUNTIL_DATE] in our database! |
Convert any amount from one currency to another currency using the real-time exchange rate. Provide the from query parameter to provide the currency to convert, to query parameter to provide currency to convert to and amount query parameter to provide the amount to convert. The amount parameter is optional with default value as 1.
# Convert the amount 500 from usd to pkr# Response { "date": "2023-03-21 15:22:00+00", "from": "USD", "to": "PKR", "rate": "281.683", "givenAmount": "500.0", "convertedAmount": "140841.475" }$ curl -X 'GET' 'https://api.apifreaks.com/v1.0/currency/converter/latest/prices?apiKey=API-KEY&from=USD&to=PKR&amount=500'
For the latest rate conversion endpoint, pass the updates query parameter to get the conversion according to exchange rates that are updated after a specific period. The possible values are 1d, 1h, 10m, and 1m which will return the converted currencies that get updated every 1 day, 1 hour, 10 minutes and 1 minute respectively.
# Get currency conversion with exchange rates updated every 10 minutes.# Response { "date": "2023-03-21 15:22:00+00", "from": "USD", "to": "PKR", "rate": "281.683", "givenAmount": "500.0", "convertedAmount": "140841.475" }$ curl -X 'GET' 'https://api.apifreaks.com/v1.0/currency/converter/latest/prices?apiKey=API-KEY&from=USD&to=PKR&amount=500&updates=10m'
Convert amount from one currency to another according to any past date. Provide the date query parameter to perform the conversion using the exchange rates for that date.
# Response { "date": "2022-01-10", "from": "USD", "to": "PKR", "rate": "176.750", "givenAmount": "500.0", "convertedAmount": "88375.000" }$ curl -X 'GET' 'https://api.apifreaks.com/v1.0/currency/converter/historical/prices?apiKey=API-KEY&date=2022-01-10&from=USD&to=PKR&amount=500'
To use the Currency Converter APIs, API credits are required. Charges are applied only for successful queries, indicated by a 2xx status code. If a request results in a 4xx or 5xx status code, no credits will be deducted, and any credits already charged will be promptly refunded.
| Service | Credits |
|---|---|
| Latest Rates Currency Converter | 4 credits |
| Historical Rates Currency Converter | 3 credits |
Utilize the Credits Usage API to efficiently monitor your recent consumption of both one-off and subscription credits. This API provides a streamlined way to track and manage your credit usage, ensuring you stay informed about your remaining balance and can optimize your resource allocation effectively.