ListOffers

From The Contingency Market

Jump to: navigation, search

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.
Views
Personal tools