CurrencyServer
Click here for a complete list of operations.
Convert
Converts a currency amount. The result is either a number or a string which can optionally be rounded and formatted. When a string is returned, either fromCurrency 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/Convert" <?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> <Convert xmlns="http://webservices.currencysystem.com/currencyserver/"> <licenseKey>string</licenseKey> <fromCurrency>string</fromCurrency> <toCurrency>string</toCurrency> <amount>double</amount> <rounding>boolean</rounding> <format>string</format> <returnRate>curncsrvReturnRateString or curncsrvReturnRateNumber</returnRate> <time>string</time> <type>string</type> </Convert> </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> <ConvertResponse xmlns="http://webservices.currencysystem.com/currencyserver/"> <ConvertResult /> </ConvertResponse> </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> <Convert xmlns="http://webservices.currencysystem.com/currencyserver/"> <licenseKey>string</licenseKey> <fromCurrency>string</fromCurrency> <toCurrency>string</toCurrency> <amount>double</amount> <rounding>boolean</rounding> <format>string</format> <returnRate>curncsrvReturnRateString or curncsrvReturnRateNumber</returnRate> <time>string</time> <type>string</type> </Convert> </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> <ConvertResponse xmlns="http://webservices.currencysystem.com/currencyserver/"> <ConvertResult /> </ConvertResponse> </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/Convert?licenseKey=string&fromCurrency=string&toCurrency=string&amount=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/Convert HTTP/1.1 Host: fx.currencysystem.com Content-Type: application/x-www-form-urlencoded Content-Length: length licenseKey=string&fromCurrency=string&toCurrency=string&amount=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/" />