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.

GET https://prime.exchangerate-api.com/v5/YOUR-API-KEY/latest/USD

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

{
	"result": "success",
	"documentation": "https://www.exchangerate-api.com/docs",
	"terms_of_use": "https://www.exchangerate-api.com/terms",
	"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!