Current

Get the status of the current auction.

Returns an overview of the current auction. There is only one auction at a time. If there is no auction most fields will be null. If the current auction phase is in vrfDelay and you are looking to retrieve the latest winning bids, it is advised to query one block before finishEnd in the endingPeriod phase for that auction as there technically are no winners during the vrfDelay and thus the field is null.

GEThttps://dot-playbook.nownodes.io/paras/auctions/current

Query parameters

Response

200

successful operation

Body

application/json

atBlockIdentifiers (object)

Block number and hash at which the call was made.

beginEndstring (unisgnedInteger or $null)

Fist block (number) of the auction ending phase. null if there is no ongoing auction.

finishEndstring (unisgnedInteger or $null)

Last block (number) of the auction ending phase. null if there is no ongoing auction.

phaseenum

An auction can be in one of 4 phases. Both startingPeriod () and endingPeriod indicate an ongoing auction, while vrfDelay lines up with the AuctionStatus::VrfDelay . Finally, a value of null indicates there is no ongoing auction. Keep in mind the that the finishEnd field is the block number the endingPeriod finishes and the vrfDelay period begins. The vrfDelay period is typically about an epoch long and no crowdloan contributions are accepted.

startPeriodendPeriodvrfDelay

auctionIndexstring (unsignedInteger)

The auction number. If there is no current auction this will be the number of the previous auction.

leasePeriodsarray of string (unsignedInteger)

Lease period indexes that may be bid on in this auction. null if there is no ongoing auction.

winningarray of WinningData (object)

Request

JavaScriptCurlPython

const response = await fetch('https://dot-playbook.nownodes.io/paras/auctions/current', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "at": {
    "hash": "text",
    "height": "text"
  },
  "beginEnd": "text",
  "finishEnd": "text",
  "phase": "startPeriod",
  "auctionIndex": "text",
  "leasePeriods": [
    "text"
  ],
  "winning": [
    {
      "bid": {
        "accountId": "text",
        "paraId": "text",
        "amount": "text"
      },
      "leaseSet": [
        "text"
      ]
    }
  ]
}