ListDeals
From The Contingency Market
Contents |
ListDeals(ulSessionID,uSequenceID,sIntegrity,sID,sAgentID,sSince,uLimit)
Returns (at most uLimit) deals (involving sID contingency or offer) (and sAgentID) (where the occurrence time is after sSince).
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->ListDeals(sID,sAgentID,sSince,uLimit)/secret") -
string sID - ID of contingency or offer which deals returned should involve. Blank for all.
-
string sAgentID - If non-null, ID of agent which deals returned should involve.
-
string sSince - Earliest registered deal to return. NB Not a TimeInstant or DateTime. The timezone is UTC.
-
uint uLimit - Maximum number of deals to return (0=all).
RETURNS
[SDealData {sID,SDealSpecificationData {sOfferIDMade,sOfferIDTaken,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive},sTimeOfDeal,dFund,sTimeDetermined,bMakerCanClose,bTakerCanClose,bIsExpired,bIsDetermined,bIsAccepted,bIsRejected} ]
-
string sID - ID of registered deal.
-
string sOfferIDMade - ID of offer being made.
-
string sOfferIDTaken - ID of compatible counter-offer.
-
int nOnDeal - Parts of any fund to be received by this agent from the agent taking this offer when a deal is struck.
-
int nOnSuccess - Parts of any fund to be received by this agent from the agent taking this offer when the deal succeeds.
-
int nOnFailure - Parts of any fund to be received by this agent from the agent taking this offer when the deal fails.
-
double dLimit - Maximum amount of transferrable funds. Zero if unlimited.
-
uint uSecondsToLive - Lifetime of this offer from registration time in seconds. 0 if indefinite.
-
string sTimeOfDeal - Time deal was registered.
-
double dFund - Amount of funds actually transferred. Zero if if not yet determined, rejected or expired.
-
string sTimeDetermined - Time at which the outcome of this deal was determined. Blank if not yet determined.
-
bool bMakerCanClose - True if the maker's acceptance is all that's necessary to make this deal jointly accepted.
-
bool bTakerCanClose - True if the taker's acceptance is all that's necessary to make this deal jointly accepted.
-
bool bIsExpired - Whether deal has already expired.
-
bool bIsDetermined - Whether the deal has been determined yet.
-
bool bIsAccepted - Whether the deal has been jointly accepted.
-
bool bIsRejected - Whether the deal has been rejected by either party.
-
bool bHasCompleted - Whether both contingencies have completed.
-
string sTimeOfCompletion - Time at which both contingencies completed.
-
bool bIsSuccessful - Whether both contingencies are successful.
-
string sTimeOfOutcome - Time at which both contingencies succeeded, or the earliest failed.
FAULTS
Session. Offer. Time format.
TEST
ListDeals(null,null,2008-01-01,10) according to the respective template, returns
Deal
- sID='5ddaa5beab654156a9c1ef61771a801a'
- sOfferIDMade='b08a0f7b30464e8a9a7488b00912d130'
- sOfferIDTaken='ced8458417b84a9288a08d9df89615dd'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-08-04T19:59:48.4730000Z'
- dFund=0.01
- sTimeDetermined='2009-08-04T19:59:48.8000000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=false
- sTimeOfCompletion=''
- bIsSuccessful=false
- sTimeOfOutcome='',
Deal
- sID='551466c131c340f79e66a234017c7f2c'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='8ebed8ee1b6846f4be89978fbabf8d61'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T08:42:34.4430000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T08:42:34.5700000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-03T16:11:16.7400000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-03T14:58:27.1430000Z',
Deal
- sID='d82e1826318c4702b91760044dabf54e'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='efe0befcf09046ecb8868bc1f35530b4'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T15:29:49.8300000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T15:29:49.9570000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-03T17:31:37.7200000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-03T16:37:26.9970000Z',
Deal
- sID='f77410465a014c019ae8730a7fe13433'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='538fe24eab8f4a0ebeba3cfefad36fcd'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T16:21:01.3330000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T16:21:01.5670000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-03T17:31:37.7200000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-03T16:37:26.9970000Z',
Deal
- sID='2a63830439fd466cb71509ce1952f46b'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='c9fb1c696e2142d08e51c8a764d0c782'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T17:46:02.6670000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T17:46:02.7430000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-03T20:20:18.9000000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-03T18:51:30.8600000Z',
Deal
- sID='53cac034d56a4f30a9d184e7b18e82c8'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='2c6a0117a8da4a409f42176dccb64872'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T18:36:39.9930000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T18:36:40.1330000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-03T20:20:18.9000000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-03T18:51:30.8600000Z',
Deal
- sID='55b090d9b4ba4d3dbd9ed18417e37c01'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='0efb008b6b904695be28ddaebc623a3b'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T20:31:06.3370000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T20:31:06.4630000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-04T16:56:13.9970000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-04T16:25:06.8230000Z',
Deal
- sID='f99e74c91c224eaf8139afe0d2291be0'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='679e6cdf941f48e3a8e751e447a57326'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-03T20:36:01.3300000Z'
- dFund=0.01
- sTimeDetermined='2009-09-03T20:36:01.5800000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-04T16:56:13.9970000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-04T16:25:06.8230000Z',
Deal
- sID='21bdf9e88cbf47798686f491f5df8bb4'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='fa8439a5860a42beabd92eff5827f9a9'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-04T17:09:00.9830000Z'
- dFund=0.01
- sTimeDetermined='2009-09-04T17:09:01.1400000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-04T18:23:54.7570000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-04T17:14:17.6630000Z',
Deal
- sID='f4af5e559ef74441bd747a2045194c47'
- sOfferIDMade='59f9aede6bf5456faaa8d2e84027e110'
- sOfferIDTaken='fb9302ea277e4ef297fe5685833d5a38'
- nOnDeal=0
- nOnSuccess=1
- nOnFailure=0
- dLimit=0.01
- uSecondsToLive=0
- sTimeOfDeal='2009-09-04T17:10:01.4400000Z'
- dFund=0.01
- sTimeDetermined='2009-09-04T17:10:01.5630000Z'
- bMakerCanClose=false
- bTakerCanClose=false
- bIsExpired=false
- bIsDetermined=true
- bIsAccepted=true
- bIsRejected=false
- bHasCompleted=true
- sTimeOfCompletion='2009-09-04T18:23:54.7570000Z'
- bIsSuccessful=true
- sTimeOfOutcome='2009-09-04T17:14:17.6630000Z'.

