Checking the auction price update fee and quotas

As the ability to update the price of an auction programmatically might give you an unfair advantage, we limit the number of price updates for individual auctions with a quota of free updates. Any auction price updates that exceeded a quota over a certain period of time induce an auction price update fee.

Getting the current quota for free auction price updates

Each auction has a separate quota for free auction price updates. To get that quota programmatically you can reference the priceUpdateQuota field of the S_stock query.

Example

Query

query {
  S_stock(stockId: "ffffffff-6056-11e9-b4ab-ffffffffffff") {
    edges {
      node {
        id
        priceUpdateQuota {
          quota
          nextFreeIn
          totalFree
        }
      }
    }
  }
}

Response

{
  "data": {
    "S_stock": {
      "edges": [
        {
          "node": {
            "id": "ffffffff-6056-11e9-b4ab-ffffffffffff",
            "priceUpdateQuota": {
              "quota": 7,
              "nextFreeIn": 623,
              "totalFree": 10
            }
          }
        }
      ]
    }
  }
}

Response fields:

Getting the current auction price update fee

To get the current fee programmatically you can make a request to via the T_countFee query. See the query docs for additional details.

Avoiding the auction price update fee

To update the auction price and make sure you will not be charged the fee, use the preventPaidPriceChange boolean field of the S_update_auction mutation.