Standard Requests

Documentation for the Standard ExchangeRate-API endpoint.

To use our Standard endpoint simply make the two substitutions explained below and then send a GET request.

• Substitute `YOUR-API-KEY` with the API key displayed in your dashboard.

• Substitute `USD` with the code you want to use as a base currency.

We use ISO 4217 Three Letter Currency Codes - e.g. USD for US Dollars, EUR for Euro etc. Here are the codes we support.


This will return the exchange rates from your base code to all the other currencies we support:

	"result": "success",
	"documentation": "",
	"terms_of_use": "",
	"time_zone": "UTC",
	"time_last_update": 1580947200,
	"time_next_update": 1580950860,
	"base": "USD",
	"conversion_rates": {
		"USD": 1,
		"AUD": 1.4817,
		"BGN": 1.7741,
		"CAD": 1.3168,
		"CHF": 0.9774,
		"CNY": 6.9454,
		"EGP": 15.7361,
		"EUR": 0.9013,
		"GBP": 0.7679,
		"...": 7.8536,
		"...": 1.3127,
		"...": 7.4722, etc. etc.

Error Responses

	"result": "error",
	"error": "unknown-code"

Where "error" can be any of the following:

  • "unknown-code" if we don't support the supplied currency code (see supported currencies...)
  • "malformed-request" when some part of your request doesn't follow the structure shown above
  • "invalid-key" when your API key is not valid
  • "quota-reached" when your account has reached the the number of requests allowed by your plan

If you have any questions about the above please don't hesitate to email us!