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}
Обратите внимание, что в целях безопасности запросы должны отправляться через https (защищенное соединение). В каждый момент времени может быть обработан только 1 запрос, поэтому прежде чем посылать новый запрос, подождите пока завершится текущий. Запрос должен включать в себя следующие параметры:
Пояснение
The results are sent as a json text.
Пояснение
success - команда выполнена
error - команда не выполнена
Get Auction List Command
If calling the "get auction list" command, the following parameters should be included:
Пояснение
Для запрошенного списка торгов будет много (many) результатов. У каждого лота будут перечисленные ниже поля
Пояснение
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:
Пояснение
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 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 */},
...
Команда регистрации ставки на аукционный лот
If calling the "Place Auction Bid" command, the following parameters should be included:
Пояснение
If your bid is successful.There will be 1 result for auction is similar to get-auction-item command.
Пример регистрации ставки на аукционный лот
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
Пояснение
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 */},
...