Client Management Systems API

This request allows you to perform a cash transfer between a WLC's client trading account and a WLC's funding account within the same owner or sub owner's structures (and vice-versa, from trading account to funding account). 
It is only possible to send cash between a client account and a funding account of the same currency.
This request does not place or redraw cash, into or from, Saxo Bank and the WLC's external accounts.


The following parameters are available in the request.

Parameter

Mandatory

Description

SessionID

Y

SessionID returned by the Login Request

Amount

Y

Value that will be transacted.

Comment

N

An optional comment to the transaction can be added. This comment will be seen in the EOD files.

Currency

Y

Currency in which the cash movement will be held in. Must be the same as the base currency for the funding and trading accounts.

ForceTransaction

N

The ForceTransaction field is used to force a cash withdrawal; from a client trading account to the WLC's funding account, bypassing any margin check or cash holding rules.
So you can make the clients account go into negative.  
How it works:

  • On a cash withdrawal operation if you set it to true, it will do no margin or funding checks. It will withdraw the cash amount that you specified on the request. You can ultimately, place the clients account into negative. If the client has open positions, it can cause a stop out.
  • On a cash withdrawal operation, if you set this field to false or not even place it in the message, all margin and funding checks will be obeyed.
  • If you place it in a cash transfer that goes from the WLC funding account to the client trading account it will give you an error, even if you place it as false. So do not even specify it on a cash transfer that goes from your top funding account to the client's trading account.

FromAccountNumber

Y

Account from where the cash is removed from. For funding transactions, this field will hold the funding account id. For a redraw transaction this field will hold the clients trading account id.

ToAccountNumber

Y

Account to where the cash is moved to. For funding transactions, this field will hold the trading account id. For a redraw transaction this field will hold the WLC's funding account.

Value Date

Y

Value Date

SOAP 1.2 Definition

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.saxobank.com/service/cms/2013/08">
   <soapenv:Header>
     <ns:SessionId>string</ns:SessionId>
   </soapenv:Header>
   <soapenv:Body>
     <ns:TransferCashRequest>
       <!-Optional:->
       <ns:Amount>decimal</ns:Amount>
       <!-Optional:->
       <ns:Comment>string</ns:Comment>
       <!-Optional:->
       <ns:Currency>string</ns:Currency>
       <!-Optional:->
       <ns:FromAccountNumber>string</ns:FromAccountNumber>
       <!-Optional:->
       <ns:ToAccountNumber>string</ns:ToAccountNumber>
       <!-Optional:->
      <ns:ValueDate>dateTime</ns:ValueDate>
     </ns:TransferCashRequest>
   </soapenv:Body>
 </soapenv:Envelope>


Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
     <ActivityId CorrelationId="c4d8ef22-5c3d-4c4b-ab87-e86b862a0917" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">5ed4f102-3b8c-4752-a823-3eecbdc48a25</ActivityId>
   </s:Header>
   <s:Body>
     <TransferCashResponse xmlns="http://www.saxobank.com/service/cms/2013/08">
       <Comission>decimal</Comission>
       <FromAccountAmount>decimal</FromAccountAmount>
       <FromAccountCurrency>string</FromAccountCurrency>
 <FromAccountPositionId>integer</FromAccountPositionId>
       <ToAccountAmount>decimal</ToAccountAmount>
       <ToAccountCurrency>string</ToAccountCurrency>
 <ToAccountPositionId >integer</ToAccountPositionId>
     </TransferCashResponse>
   </s:Body>
 </s:Envelope>

Code Examples


Code example 42: TransferCash Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.saxobank.com/service/cms/2013/08">
  <soapenv:Header>
     <ns:SessionId>QAs01NW22ajBAsjFZTGM</ns:SessionId>
  </soapenv:Header>
   <soapenv:Body>
     <ns:TransferCashRequest>
       <!-Optional:->
       <ns:Amount>1</ns:Amount>
       <!-Optional:->
       <ns:Comment>InternalId:1234</ns:Comment>
       <!-Optional:->
       <ns:Currency>USD</ns:Currency>
       <!-Optional:->
       <ns:FromAccountNumber>33930/COMMUSD</ns:FromAccountNumber>
       <!-Optional:->
       <ns:ToAccountNumber>33930/Test125</ns:ToAccountNumber>
       <!-Optional:->
       <ns:ValueDate>2015-02-04T11:20:00</ns:ValueDate>
     </ns:TransferCashRequest>
   </soapenv:Body>
 </soapenv:Envelope>


Code example 43: TransferCash Response

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
     <ActivityId CorrelationId="c4d8ef22-5c3d-4c4b-ab87-e86b862a0917" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">5ed4f102-3b8c-4752-a823-3eecbdc48a25</ActivityId>
   </s:Header>
   <s:Body>
     <TransferCashResponse xmlns="http://www.saxobank.com/service/cms/2013/08">
       <Comission>0</Comission>
       <FromAccountAmount>1</FromAccountAmount>
       <FromAccountCurrency>USD</FromAccountCurrency>
       <ToAccountAmount>1</ToAccountAmount>
       <ToAccountCurrency>USD</ToAccountCurrency>
     </TransferCashResponse>
   </s:Body>
 </s:Envelope>