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:
Explanation
The results are sent as a json text.
Explanation
success - the command was successful
error - the command was not successful
Get Auction List Command
If calling the "get auction list" command, the following parameters should be included:
Explanation
There will be many results for auction list you request. Each auction will have fields as below
Explanation
Get Auction List Example
https://www.dynadot.com/auction-api/get-auction-list?api_key=MY_API_KEY&auction_type=expired
{
"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:
Explanation
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
Explanation
Get Auction Item Example
https://www.dynadot.com/auction-api/get-auction-item?api_key=MY_API_KEY&domain=domain-haha1.cn
{
"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:
Explanation
If your bid is successful.There will be 1 result for auction is similar to get-auction-item command.
Place Auction Bid Example
https://www.dynadot.com/auction-api/place-auction-bid?api_key=MY_API_KEY&domain=domain-haha1.cn&bid_price=100
{
"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
Explanation
If your request is successful,there will be some results as you see in the example section.
Get Auction Bids Example
https://www.dynadot.com/auction-api/get-auction-bids?api_key=MY_API_KEY
{
"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 */},
...