Frequently Asked Questions

View the most common questions people ask about Exchangerate.host

Any questions? Our team is here to help!

Contact Support

Frequently Asked Questions

What is exchangerates.host?

Exchangerates.host is a REST API that is a service for current and historical foreign exchange rates and crypto exchange rates.

Who runs the API?

Exchangerates.host is a product built and maintained by APILayer, a technology company that provides a variety of reliable and essential APIs for developers. APILayer’s APIs are affordable for both startups and larger companies. APILayer GmbH is headquartered in Vienna, Austria.

What is the API’s uptime?

The API's system status is closely monitored around the clock. Every effort is made to ensure the highest possible level of availability and consistency, and we are proud to have an average uptime rate of nearly 100% (99.9%) throughout the last 12 months.

Error responses

If your query fails, the API will return false in the success parameter, also HTTP header code 404 Not Found or HTTP 521 Timeout.

Which type of historical rates does the API offer?

The API delivers EOD / End of Day historical exchange rates, which become available at 00:05 am GMT for the previous day and are time stamped at one second before midnight.

Rate Limits

API requests made by a throttled user or app will fail. All API requests are subject to rate limits. Real time rate limit usage statistics are described in headers that are included with most API responses once enough calls have been made to an endpoint.

Response showing old date

API requests are cached by default. You can try to add an additional parameter &v=_actual_date_ in the query, where _actual_date_ enter the day in the format for example Y-m-d (or you can add only hour value).

What happens if my allowed volume is exceeded?

Users exceeding their monthly API request limit receive automated email and dashboard notifications at 75%, 90%, and 100%. After reaching 100% of the allowance, overages fees will apply so we make sure you won’t experience any disruptions and your website/application will keep running smoothly. You can learn more about overages billing here.

How do I cancel/downgrade?

You can initiate a cancellation or downgrade by selecting a new plan and providing at least one reason for your decision. The customer service team will cancel or downgrade your plan. Downgrades are not effective immediately; your premium subscription will remain active until the end of the current billing period.

How do I change between monthly and yearly billing?

To change your subscription from monthly to yearly billing, submit a request on the Contact Us page on the website following these steps:

Step 1: Sign in to your account

Step 2: Go to Contact Us page

Step 3: Fill out the form and choose the “Sales” category for this request.

Step 4: In the text box, include your specific request for example “Change from Monthly to Yearly subscription.”

Platinum Support

What is included in Platinum Support?

Platinum Support includes dedicated account management, priority bug fixes, and access to exclusive support resources. It ensures you receive top-tier assistance for any issues you encounter, helping you maintain and optimize your system performance.

How much does Platinum Support cost?

The cost of Platinum Support varies depending on your subscription plan:
- Standard Plan: $479.88 billed annually
- Professional Plan: $599.88 billed annually
- Professional Plus Plan: $719.88 billed annually
- Enterprise Plan: Custom pricing billed annually

How do I select Platinum Support when purchasing a plan?

When you select a pricing plan, the Platinum Support option is automatically checked. You will see a checkbox next to “Include Platinum Support” with the corresponding annual price. You can uncheck this box if you do not wish to include Platinum Support.

How does Platinum Support appear on my invoice?

When you select Platinum Support, your invoice will display “Selected: [Your Plan] + Platinum Support.” The total amount charged will include the cost of your chosen plan and the annual fee for Platinum Support. For example, if you select the Professional Plan, your invoice will read “$59.99/month + $599.88/year for Platinum Support.”

Can existing customers upgrade to include Platinum Support?

Yes, existing customers can upgrade their plans to include Platinum Support. The option will be automatically checked when viewing available plans, showing the respective annual fee for Platinum Support. You can select or unselect this option as needed.

How is the billing period for Platinum Support handled?

The billing period for Platinum Support is annual. When you purchase Platinum Support, the renewal date will be one year from the purchase date. Your invoice will show the purchase date, renewal date, and the total annual amount for Platinum Support.

Can I opt out of Platinum Support during the purchase process?

Yes, Platinum Support is an optional service, you can uncheck the Platinum Support box during the purchase process if you prefer not to include it.

Can I switch back to standard support after upgrading to Platinum Support?

Yes, you can switch back to standard support at any time. However, the change will take effect at the start of your next billing cycle. Contact our support team to adjust your plan.

Business Continuity - API Overages

What is an overage?

An overage occurs when you go over a quota for your API plan. When you reach your API calls limit, we will charge you a small amount for each new API call so we can make sure there will be no disruption in the service we provide to you and your website or application can continue running smoothly.

Prices for additional API calls will vary based on your plan. See the table below for prices per call and an example of an overage billing.

Plan Name	Monthly Price	Number of Calls	Overage Price per call	Overage	Total Overage Price
Basic	$14.99	10,000	0.005996	10,000	$59.96
Professional Plus	$59.99	100,000	0.0023996	10,000	$24.00
Business	$99.99	500,000	0.00079992	10,000	$8.00

Note: For complete details, please refer to the overages documentation here.

Why does APILayer have overage fees?

Overage fees allow customers to continue using an API once a quota limit is reached. We want to make sure your website or application continues running at all times, so charges will apply if you go over your monthly quota limit. If you notice you are going over your monthly quota limit each month, look on your dashboard for an upgraded plan to help with larger request limits.

How do I know if I will be charged for overages?

When you are close to reaching your API calls limit for the month, you will receive an automatic notification (at 75%, 90%, and 100% of your monthly quota). You can keep track of your quota usage to prevent overages by tracking the number of API calls you make and checking the dashboard for up-to-date usage statistics.

How will I be charged for my API subscription?

You will be charged for your monthly subscription plan, plus any overage fees applied. Your credit card will be billed after the billing period has ended.

What happens if I don't have any overage fees?

In this case, there will be no change to your monthly invoice. Only billing cycles that incur overages will see any difference in monthly charges. The Business Continuity plan is an insurance plan to be used only if needed and guarantees your end users never see a drop in coverage from you.

What if I consistently have more API calls than my plan allows?

If your usage consistently surpasses the set limits each month, you may face additional charges for the excess usage. Nevertheless, as your monthly usage reaches a certain threshold, it becomes more practical to consider upgrading to the next plan. By doing so, you ensure a smoother and more accommodating experience for your growing customer base. Find out about our pricing plans here.

I would like to upgrade my plan. How can I do that?

You can easily upgrade your plan by going to your Dashboard and selecting the new plan that would be more suitable for your business needs. Additionally, you may contact your Account Manager to discuss a custom plan if you expect a continuous increase in usage.

Exchangerates.host API for real-time and historical foreign exchange & precious metals rates

Explore the Docs Get Free API Key