GetDeal
From The Contingency Market
Contents |
GetDeal(ulSessionID,uSequenceID,sIntegrity,sDealID)
Retrieves a specific, registered deal.
PARAMETERS
-
ulong ulSessionID - ID of authenticated session.
-
uint uSequenceID - Sequence number.
-
string sIntegrity -
md5("ipaddr(sid,seq)->GetDeal(sDealID)/secret") -
sDealID - ID of deal required.
RETURNS
SDealData {sID,sOfferIDMade,sOfferIDTaken,nOnDeal,nOnSuccess,nOnFailure,dLimit,uSecondsToLive,sTimeOfDeal,dFund,sTimeDetermined,bMakerCanClose,bTakerCanClose,bIsExpired,bIsDetermined,bIsAccepted,bIsRejected}
-
string sID - ID of registered offer.
-
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.
FAULTS
Session. Deal.
TEST
GetDeal() according to the respective template currently returns 'Null ID invalid'.

