ListOffers
From The Contingency Market
Contents |
ListOffers(ulSessionID,uSequenceID,sIntegrity,sContingencyID,sAgentID,sSince,uLimit)
Returns at most uLimit offers where the occurrence time is after sSince.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->ListOffers(sContingencyID,sAgentID,sSince,uLimit)/secret") -
string sContingencyID - ID of contingency on which offers returned should be based. Blank for all.
-
string sAgentID - If non-null, ID of agent whose offers should be returned.
-
string sSince - Earliest registered offer to return. NB Not a TimeInstant or DateTime. The timezone is UTC.
-
uint uLimit - Maximum number of offers to return (0=all).
RETURNS
[SOfferData {sID,sContingencyID,sAgentID,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,bAutoAccept,sAgentIDCommissioner,fCommission,sTimeOfOffer,bIsExpired} ]
-
string sID - ID of registered offer.
-
string sContingencyID - Contingency on which this offer is contingent.
-
string sAgentID - Agent making this offer.
-
int nOnDeal - Parts of any fund to be received by this agent from the agent taking this offer when a deal is jointly accepted.
-
int nOnSuccess - Parts of any fund to be received by this agent from the agent taking this offer when the jointly accepted deal succeeds.
-
int nOnFailure - Parts of any fund to be received by this agent from the agent taking this offer when the jointly accepted deal fails.
-
double dLimit - Maximum amount of funds offered. Zero if unlimited.
-
uint uSecondsToLive - Lifetime of this offer from registration time in seconds. 0 if indefinite.
-
bool bAutoAccept - Whether any acceptable counter-offer should be automatically accepted.
-
string sAgentIDCommissioner - Whether another agent should receive a proportion of positive funds transferred. null if not.
-
float fCommission - Proportion. 0.5 means 50%.
-
string sTimeOfOffer - Time offer was registered.
-
bool bIsExpired - Whether offer has already expired.
FAULTS
Session. Contingency. Time format.
TEST
ListOffers(null,null,2008-01-01,10) according to the respective template, returns
Offer
- sID='4754b8dec94c4aa0a41080d17038635f'
- sContingencyID='ffd966d9e8613e8abd63ee96600edb84'
- sAgentID='693e0883d3a6417a81efba606184751e'
- nOnDeal=0
- nOnSuccess=0
- nOnFailure=0
- dLimit=9999
- uSecondsToLive=0
- bAutoAccept=true
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-06-18T23:45:40.3430000Z'
- bIsExpired=false,
Offer
- sID='b08a0f7b30464e8a9a7488b00912d130'
- sContingencyID='8dc0c91bf926958182b2e9407faad11c'
- sAgentID='cf42d72d6a03488d8e690f0151e010b4'
- nOnDeal=0
- nOnSuccess=0
- nOnFailure=0
- dLimit=9999
- uSecondsToLive=0
- bAutoAccept=true
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-07-28T10:42:18.6900000Z'
- bIsExpired=false,
Offer
- sID='ced8458417b84a9288a08d9df89615dd'
- sContingencyID='d8500dbf5f7ae81ffe320cd360bd1284'
- sAgentID='693e0883d3a6417a81efba606184751e'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-08-04T19:59:48.3470000Z'
- bIsExpired=true,
Offer
- sID='59f9aede6bf5456faaa8d2e84027e110'
- sContingencyID='63bb366089ea88defdceea6c44a69bf1'
- sAgentID='86633e460c044e19b2d43cf04eacaf00'
- nOnDeal=0
- nOnSuccess=0
- nOnFailure=0
- dLimit=9999
- uSecondsToLive=0
- bAutoAccept=true
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T01:27:54.6030000Z'
- bIsExpired=false,
Offer
- sID='8ebed8ee1b6846f4be89978fbabf8d61'
- sContingencyID='06e90686a28a46a9785718cbd83bdda2'
- sAgentID='693e0883d3a6417a81efba606184751e'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T08:42:34.3970000Z'
- bIsExpired=true,
Offer
- sID='efe0befcf09046ecb8868bc1f35530b4'
- sContingencyID='cfb5de1683fcaee23becbcc232276cbf'
- sAgentID='1af92ffedc224f45ae8e2c9a8624b4ab'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T15:29:49.7700000Z'
- bIsExpired=true,
Offer
- sID='538fe24eab8f4a0ebeba3cfefad36fcd'
- sContingencyID='cfb5de1683fcaee23becbcc232276cbf'
- sAgentID='693e0883d3a6417a81efba606184751e'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T16:21:01.2870000Z'
- bIsExpired=true,
Offer
- sID='c9fb1c696e2142d08e51c8a764d0c782'
- sContingencyID='980ce1eabddb463f4fa6e9edbe6f685a'
- sAgentID='693e0883d3a6417a81efba606184751e'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T17:46:02.6330000Z'
- bIsExpired=true,
Offer
- sID='2c6a0117a8da4a409f42176dccb64872'
- sContingencyID='980ce1eabddb463f4fa6e9edbe6f685a'
- sAgentID='1af92ffedc224f45ae8e2c9a8624b4ab'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T18:36:39.9600000Z'
- bIsExpired=true,
Offer
- sID='0efb008b6b904695be28ddaebc623a3b'
- sContingencyID='e5d9d836dff01166a0b7397875f94b5a'
- sAgentID='1af92ffedc224f45ae8e2c9a8624b4ab'
- nOnDeal=0
- nOnSuccess=-1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=31536000
- bAutoAccept=false
- sAgentIDCommissioner=''
- fCommission=0
- sTimeOfOffer='2009-09-03T20:31:06.2900000Z'
- bIsExpired=true.

