GET ExchangeRates API Version 1

Aldo Lambruschini

Modified on: Mon, 18 Jan, 2021 at 12:12 PM

GET ExchangeRates API

Updated on 2014-05-21
Current Version: Version 1
Deprecated Version: NA
Requests Allowed: GET&SOAP

Summary:

Returns an array of exchange rates.

Resource/WSDL Page:

http://<your_domain_here>/api/1/get.asmx?op=ExchangeRates

Parameters

api_key
Required
Type: STRING
Length (Max/Min): 50

Must be a valid API key (existing and not expired)

Example Values: Fo35NRAqvFLXoZxqB4aViaiYM7iVMhh

start_date
Required
Type: DATE

Allowed formats: "yyyy-mm-dd","mm-dd-yyyy"

end_date
Required
Type: DATE

Allowed formats: "yyyy-mm-dd","mm-dd-yyyy"

**Note all optional parameters still need to be passed through in the actual call. These parameters do not need a value (therefore you can use a null value).

Example Request

GET	https://demo-new.cakemarketing.com/api/1/get.asmx/ExchangeRates?api_key=3YmDJeT3VHTFhDqAjr2OlQ&start_date=01/01/2013+00:00:00&end_date=01/02/2013+12:00:00

Sample XML Response:

<exchange_rates_response>
<success>true</success>
<row_count>12</row_count>
<exchange_rates>
<exchange_rate>
<base_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.7643420000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.3083148642</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.6454240000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.5493690969</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.9828430000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>1</currency_id>
<currency_symbol>$</currency_symbol>
<currency_name>US Dollar</currency_name>
<currency_abbr>USD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.0174565011</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.8444180000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.1842476119</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.2858680000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>2</currency_id>
<currency_symbol>€</currency_symbol>
<currency_name>Euro</currency_name>
<currency_abbr>EUR</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.7776848012</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>1.5227870000</rate>
</exchange_rate>
<exchange_rate>
<base_currency>
<currency_id>4</currency_id>
<currency_symbol>A$</currency_symbol>
<currency_name>AU Dollar</currency_name>
<currency_abbr>AUD</currency_abbr>
</base_currency>
<quote_currency>
<currency_id>3</currency_id>
<currency_symbol>£</currency_symbol>
<currency_name>British Pound</currency_name>
<currency_abbr>GBP</currency_abbr>
</quote_currency>
<start_date>2013-01-01T00:00:00</start_date>
<end_date>2013-01-31T00:00:00</end_date>
<rate>0.6566906599</rate>
</exchange_rate>
</exchange_rates>
</exchange_rates_response>

Example Error Messages:

Error Message	Likely Cause
Invalid API Key	API key does not exist or is expired