Function   /buyer/auction/watch/list

Function invocation

Function description

Returns the list of watched auctions.

Input parameters

This function takes the following input parameters:

ParameterTypeRequiredDefault valueDescription
name string "" String to be searched in domain names
size integer 5000 Paging: number of list elements
start integer 0 Paging: starting list element
order string "endtime" List sorting (can be sorted by name, added, endtime, price)

Return value

The list of auctions (list of structures with the following fields):

Field nameTypeDescription
auctionId integer Auction identifier
added integer Time as Unix timestamp, when auction has been added to watched
currency string Auction currency
endtime integer Auction end time as a Unix timestamp
name string Domain name (in Punycode)
utfname string Domain name (internationalized) (deprecated, Domain name is given in 'nameIDN' field)
nameIDN string Domain name (internationalized)
price float Actual auction price
catch boolean Auction of a caught domain
minBid float Minimal amount of next bid in auction