CurrencyServer
Click here for a complete list of operations.
Rate
Returns the exchange (conversion) rate. The result is either a number or a string which can optionally be rounded and formatted. When a string is returned, either baseCurrency or toCurrency (but not both) may contain a list of semicolon-separated active currencies. Leave the time and type parameters empty for forward compatibility.
Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/CurrencyServer5.asmx HTTP/1.1 Host: fx.currencysystem.com Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://webservices.currencysystem.com/currencyserver/Rate" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Rate xmlns="http://webservices.currencysystem.com/currencyserver/"> <licenseKey>string</licenseKey> <baseCurrency>string</baseCurrency> <toCurrency>string</toCurrency> <rounding>boolean</rounding> <format>string</format> <returnRate>curncsrvReturnRateString or curncsrvReturnRateNumber</returnRate> <time>string</time> <type>string</type> </Rate> </soap:Body> </soap:Envelope>
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <RateResponse xmlns="http://webservices.currencysystem.com/currencyserver/"> <RateResult /> </RateResponse> </soap:Body> </soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/CurrencyServer5.asmx HTTP/1.1 Host: fx.currencysystem.com Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <Rate xmlns="http://webservices.currencysystem.com/currencyserver/"> <licenseKey>string</licenseKey> <baseCurrency>string</baseCurrency> <toCurrency>string</toCurrency> <rounding>boolean</rounding> <format>string</format> <returnRate>curncsrvReturnRateString or curncsrvReturnRateNumber</returnRate> <time>string</time> <type>string</type> </Rate> </soap12:Body> </soap12:Envelope>
HTTP/1.1 200 OK Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <RateResponse xmlns="http://webservices.currencysystem.com/currencyserver/"> <RateResult /> </RateResponse> </soap12:Body> </soap12:Envelope>
HTTP GET
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
GET /webservices/CurrencyServer5.asmx/Rate?licenseKey=string&baseCurrency=string&toCurrency=string&rounding=string&format=string&returnRate=string&time=string&type=string HTTP/1.1 Host: fx.currencysystem.com
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <anyType xmlns="http://webservices.currencysystem.com/currencyserver/" />
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/CurrencyServer5.asmx/Rate HTTP/1.1 Host: fx.currencysystem.com Content-Type: application/x-www-form-urlencoded Content-Length: length licenseKey=string&baseCurrency=string&toCurrency=string&rounding=string&format=string&returnRate=string&time=string&type=string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <anyType xmlns="http://webservices.currencysystem.com/currencyserver/" />