Dynadot Auction API  (Beta)

Our Dynadot Auction API is a powerful tool to help you make the most of our domain marketplace. The API allows you to get auction details and place bids on our expired domain auctions, backorders and user auctions. With a few simple API calls you can get the most out of the Dynadot aftermarket! Our Marketplace API is available to all accounts, so get started today!

Getting Started With Our Dynadot Auction API

Requests to our Dynadot Auction API are sent to the following URL:

https://www.dynadot.com/auction-api/{command}

Note that requests should be sent over https (secure socket) for security. Only 1 request can be processed at a time, so please wait for your current request to finish before sending another request. The request should have the following parameters:

Request Parameter
Explanation
api_keyYour key to access the API, available in your account control panel
commandThe commands supported right now are "get-auction-list" , "get-auction-item","place-auction-bid" and "get-auction-bids"
currency(optional)You can decide which currency to display auction data and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use USD acquiescently

The results are sent as a json text.

Result Field
Explanation
statusThe result of this API call:
success - the command was successful
error - the command was not successful
contentMore information about the result, only used when result is "error"

Get Auction List Command

If calling the "get auction list" command, the following parameters should be included:

Get Auction List Request Parameter
Explanation
auction_typeThe auction type you want to request,now supported are "expired","user","backorder".You can request one or more auction types.If there are more than two types, you must use "," to split each auction type

There will be many results for auction list you request. Each auction will have fields as below

Get Auction List Result Field
Explanation
auction_idThe auction_id parameter, for example: 1
domainThe domain name of this auction, for example: domain-haha1.cn
utf_nameThe utf domain name of this auction, for example: domain-haha1.cn
is_idnIf this domain is international domain name, for example: false
auction_typeThe type of this auction, for example: expired
currencyThe current price currency , for example: USD
current_bid_priceThe current bid price for this auction, for example: 28.99
bidsThe bid times about this auction, for example: 5
biddersThe amount of people who take part in this auction bid, for example: 3
time_leftThe remaining time of this auction, for example: 11 hours, 30 min
start_timeThe start time of this auction, for example: 2019/02/13 05:00 PST
start_time_stampThe start time stamp of this aucion, for example: 1550062850113
end_timeThe end time of this auciton, for example: 2019/02/20 05:00 PST
end_time_stampThe end time stamp of this auction, for example: 1550667650113
visitorsThe amount of visitors, for example: 40
linksThe amount of links, for example: 365
ageThe age about this domain, for example: 2
estibot_appraisalThe price on estibot_appraisal for this domain, for example: $388.03

Get Auction List Example

Request

https://www.dynadot.com/auction-api/get-auction-list?api_key=MY_API_KEY&auction_type=expired

Response

{

"status": "success",

"auction_list": [

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "currency": "USD",

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

    },

    { /* expired-auction2 data */},

    { /* expired-auction3 data */},

...

Get Auction Item Command

If calling the "get auction Item" command, the following parameters should be included:

Get Auction Item Request Parameter
Explanation
domainThe auction details you want to request by domain to get

There will be 1 result for auction by domain under you request. The auction details will have some new fields compared with list conmand as below.The command now are supported auctions that have not ended and have ended within 1 hour

Get Auction Item Result Field
Explanation
accepted_bid_priceThe acceptable price to bid at this auction, for example: 33.99
is_high_bidderIf you are the high bidder, for example: true
auction_endedIf the auction has ended, for example: false
customer_bidedIf you has take part in this auction, for example: true
customer_bidYour bid price, for example: 33.99
customer_proxy_bidYour proxy_bid price , for example: $100
bidder_nameThe name of the bidder, for example: bidder 1
bid_priceThe amount of this bid, for example: 35.99
timestampThe timestamp when the bidder bid at this auction, for example: 1550637925300
bid_statusYour status at this auction,"high bidder" means you are the highest bidder,, for example: High Bidder
is_proxy_auto_bidIf this bid is proxy_bid, for example: false

Get Auction Item Example

Request

https://www.dynadot.com/auction-api/get-auction-item?api_key=MY_API_KEY&domain=domain-haha1.cn

Response

{

"status": "success",

"auction_json":

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "accepted_bid_price": "57.99",

        "currency": "USD",

        "is_high_bidder": false,

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

        "auction_ended": false,

        "customer_bided": true,

        "costomer_bid": "27.99",

        "customer_proxy_bid": "$159.00",

    },

    "bid_history": [

    {

        "bidder_name": "bidder 1",

        "bid_price": "$159.00",

        "currency": "USD",

        "timestamp": "1550667650113",

        "bid_status": "High Bidder",

        "is_proxy_auto_bid": "false"

    }

    { /* bid history2 data */},

    { /* bid history3 data */},

...

Place Auction Bid Command

If calling the "Place Auction Bid" command, the following parameters should be included:

Place Auction Bid Request Parameter
Explanation
domainThe domain of the auction you want to place bid on
bid_priceThe amount you want to bid, in dollar. e.g. 85.99

If your bid is successful.There will be 1 result for auction is similar to get-auction-item command.

Place Auction Bid Example

Request

https://www.dynadot.com/auction-api/place-auction-bid?api_key=MY_API_KEY&domain=domain-haha1.cn&bid_price=100

Response

{

"status": "success",

"auction_json":

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "accepted_bid_price": "57.99",

        "currency": "USD",

        "is_high_bidder": false,

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

        "auction_ended": false,

        "customer_bided": true,

        "costomer_bid": "27.99",

        "customer_proxy_bid": "$159.00",

    },

    "bid_history": [

    {

        "bidder_name": "bidder 1",

        "bid_price": "$159.00",

        "currency": "USD",

        "timestamp": "1550667650113",

        "bid_status": "High Bidder",

        "is_proxy_auto_bid": "false"

    }

    { /* bid history2 data */},

    { /* bid history3 data */},

...

Get Auction Bids Command

Get Auction Bids Result Field
Explanation
bid_idIf your request is successful.There will be some bids you have taken part in.There will be some fields as belowThe id for this bid, for example: 15
auction_idThe id for this auction, for example: 5
account_idThe id for this account, for example: 3
domainThe domain for this auction, for example: domain-haha1.com
domain_utfThe domain_utf for this auction, for example: domain-haha1.com
auction_typeThe auction type for this auction , for example: expired
is_idnIf this domain is international, for example: false
current_bidThe current bid price for this auction, for example: $33.99
your_statusYour bid status at this auction, for example: High Bidder
proxy_bidYour proxy bid price, for example: $37.99
active_biddersThe amount of bidders at this domain auction , for example: 10
ends_onThe end time for the auction, for example: Feb 20, 2019 10:00am PST
end_timeThe end time of this auciton, for example: 2019/02/20 05:00:00 PST
end_time_stampThe end time stamp of this auction, for example: 1550667650113

If your request is successful,there will be some results as you see in the example section.

Get Auction Bids Example

Request

https://www.dynadot.com/auction-api/get-auction-bids?api_key=MY_API_KEY

Response

{

"status": "success",

"auction_bids": [

    {

        "bid_id": 1,

        "auction_id": 1,

        "account_id": 1,

        "domain": "domain-haha1.cn",

        "domain_utf": "domain-haha1.cn",

        "auction_type": "expired",

        "is_idn": false,

        "current_bid": "$57.99",

        "proxy_bid": "$85.88",

        "your_status": "High Bidder",

        "active_bidders": 10,

        "time_left": "11 hours, 30 min",

        "ends_on": "2019/02/20 05:00 PST",

        "end_time": "2019/02/20 05:00:00 PST",

        "end_time_stamp": "1554774971733",

    },

    { /* bid2 data */},

    { /* bid3 data */},

...