API Freaks logo

Currency Fluctuation API - Get Currency Fluctuations Over a Time Period

Use the Currency Fluctuation API to track fluctuations in currency values for specified currencies over a chosen base currency and duration, aiding in informed financial decisions. Ideal for financial professionals, businesses, and developers, this API allows you to specify custom date ranges, giving you the flexibility to analyze short-term currency volatility or long-term trends. The api provides detailed metrics like start rate, end rate, absolute change, and percentage change, empowering you to make data-driven decisions and optimize your financial strategies.

10K Free Credits, No Credit Card Required

Features

Precise Fluctuation Analysis

Track currency value changes over your chosen time period. With the ability to specify start and end dates, you can analyze fluctuations with precision, helping you understand market dynamics and make informed financial decisions.

Multi-Currency Fluctuation Data

Compare the fluctuation rates of multiple currencies in a single request. Get a clear view of how different currencies have moved against your selected base currency, enabling comprehensive market analysis.

Detailed Fluctuation Metrics

Gain in-depth insights into currency fluctuations with key metrics such as start rate, end rate, absolute change, and percentage change. This detailed information helps you evaluate exchange rate volatility and its impact on your financial strategies.

Filtered Currency Rates

Retrieve exchange rates only for the currencies you need. Our api allows you to get targeted data, reducing unnecessary information so you can focus on what matters most to you.

Documentation

API Endpoint

GET

https://api.apifreaks.com/v1.0/currency/fluctuation

Test
LANGUAGE
Python
PHP
Java
Node
Ruby
$ pip install requests

API Request

ParameterRequiredTypeDefaultDescription
startDateYesString
Start date (format YYYY-MM-DD) of the preferred time frame
endDateNoStringDay before current date
End date (format YYYY-MM-DD) of the preferred time frame
baseNoStringUSD
Base currency
symbolsNoArray
comma separated list of desired currencies/ commodities symbols

API Response

FieldTypeRequirementDescription
startDateStringMandatory
It is the starting date of interval. It is provided via input.
endDateStringMandatory
It is the ending date of interval. It is provided via input.
baseStringMandatory
It is the base currency with respect to which all rates will be calculated. It can be provided via input.
rateFluctuationsMapMandatory

It is the map that will contain fluctuations of symbol currencies. Each Individual currency symbol object contains following fields:

FieldTypeRequirementDescription
startRateStringMandatory
It is the starting rate of currency which will be present in database within interval
endRateStringMandatory
It is end rate of currency which will be present in database within interval
changeStringMandatory
it is change between starting rate and ending rate of currency at start and end of interval. It could be positive or negative
perecentChangeStringMandatory
It is the percentage by which rate has increased or decreased from start of interval at the end of interval.

HTTP Error Codes

HTTP StatusReasons
400
Starting date cannot be after current date or ending date.
400
Provided Dates are in Invalid Format. Dates must be in a valid format YYYY-MM-DD!
404
Rates of provided base and symbols are not found for given intervals.

How-To-Guides

Currency Fluctuation Rate Between Two Dates

Call the endpoint with the startDate and endDate query parameters to get the fluctuation rate of the provided currencies with respect to the base currency during the interval. End date if not provided will be equal to the day before the current date. The default base currency is USD. Provide the currencies whose fluctuation rate is to be found in the symbols query parameter.

$ curl 'https://api.currencyfreaks.com/v2.0/fluctuation?apikey=YOUR_APIKEY&startDate=2022-10-01&endDate=2022-10-15&symbols=PKR&base=GBP'
# Response
{
    "startDate": "2022-10-01",
    "endDate": "2022-10-15",
    "base": "GBP",
    "rateFluctuations": {
        "PKR": {
            "startRate": "254.331",
            "endRate": "243.874",
            "change": "10.457",
            "percentChange": "4.11"
        }
    }
}

Pricing

To use the Currency Fluctuation API, 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.

For each successful request, 3 credits will be charged to access currency fluctuation data. 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.

Price Estimation Calculator