Wiki

Counter bids list for current wmid

This api allows to receive information about new bids of the specific WMID.

<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid></wmid>
    <signstr></signstr>
    <type></type>
    <queryid></queryid>
    <capitallerwmid></capitallerwmid>
</wm.exchanger.request>
  • Request parameters:
name purpose comments
wmid Signer's WMID WMID from which a new bid will be placed.
signstr Request signature. 132-digits digital signature (by .kwm keys of the wmid) encoding the value of three tags of the request, pulled together in one line without spaces, "wmid + type + queryid"
type request type reserved for future use. currently n/a
queryid optional field id of the counter bid belonging to WMID , which data/details are to be returned; if the parameter is indicated as "-1", last 20 bids of this WMID are returned
capitallerwmid optional field if Capitaller’s WMID is being transferred in this field (www.capitaller.ru) the exchange bid on behalf of capitallerwmid may be set under this request. In this case there must be an access for WMID which signs the request which is described at Capitaller’s Impersonalization page.
  • Response format:
<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <WMExchnagerQuerys wmid=""" type="">
        ...............
        <query id="" isxid="" exchtype="" state="" amountin="" amountout="" inoutrate="" outinrate="" inpurse="" outpurse="" querydatecr="" querydate="" direction="" newtrid="" datesynchro=""></query>
        ...............
    </WMExchnagerQuerys>
    <retval></retval>
    <retdesc></retdesc>
</wm.exchanger.response>
  • Response parameters
Name Purpose Description
retval Execution code "0" means that the request was executed successfully. Check the execution code table for detailed information;
retdesc Execution code description error description in case retval tag is not 0
query query information infoamtion abount bid
id attribute - number of the counter bid
isxid attribute - number of the new bid as per the counter bid
exchtype attribute - exchange direction, see interface # X1
state - current status ◾0 - bid not processed
◾1 - processed, exchange performed, funds not yet processed
◾2 - exchanged completely, funds processed
◾3 - exchange not processed, bid converted into the new bid for the same wmid(possible reasons: exchange couldn't have been performed for any reasons, rate of the new bid has changed or there were not enough funds to cover the counter bid)
amountin attribute - amount in WM, exchanged in the specific counter bid
amountout attribute - amount in WM received by WMID as per specific counter bid
inoutrate attribute - direct exchange rate of the bid
outinrate attribute - reverse exchange rate of the bid
inpurse attribute - purse, from which the bid was processed
outpurse attribute - purse to receive exchanged funds
querydatecr attribute - bid application date
querydate attribute - date of bid’s last change
direction attribute - exchange direction
newtrid attribute - if current counter bid was converted into the new (there were no purse payouts) so in current attribute the number of this bid
capitallerwmid
  • Example
<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid>500000000008</wmid>
    <signstr>bdeafd87baaffa660e6d359ffc2f76145aa3ac11b6075387eddb0c9fb6b96bf1b2cd3b6b16e67328b2bc7bef2fb21a9fbe9849381429c6b9e7a53bdb01b22b1e00eb</signstr>
    <type>1</type>
    <queryid>-1</queryid>
    <capitallerwmid>0</capitallerwmid>
</wm.exchanger.request>

<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <WMExchnagerQuerys wmid=\"500000000008\" type=\"1\">
        <query id=\"1549440\" isxid=\"786527\" exchtype=\"1\" state=\"2\" amountin=\"55\" amountout=\"1377,79\" inoutrate=\"0,0399\" outinrate=\"25,0507\" inpurse=\"Z000000000006\" outpurse=\"R300000000006\" querydatecr=\"01.11.2007 15:39:35\" querydate=\"01.11.2007 15:39:42\" direction=\"WMZ-WMR\" newtrid=\"0\" datesynchro=\"2007-11-01 15:39:42.420\"></query>
    </WMExchnagerQuerys>
    <retval>0</retval>
    <retdesc></retdesc>
</wm.exchanger.response>