> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# perpDeployAuctionStatus | Hyperliquid info

> Reference docs for the perpDeployAuctionStatus JSON-RPC method on the Hyperliquid info blockchain, available via Chainstack JSON-RPC nodes.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

<Note>
  The `perpDeployAuctionStatus` call will return non-null when [HIP-3: Builder-Deployed Perpetuals](https://hyperliquid.gitbook.io/hyperliquid-docs/hyperliquid-improvement-proposals-hips/hip-3-builder-deployed-perpetuals) goes live on the mainnet.
</Note>

The `info` endpoint with `type: "perpDeployAuctionStatus"` retrieves the status information about perpetual contract deployment auctions on the Hyperliquid exchange. This endpoint provides timing information and gas-related data for the auction system.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"perpDeployAuctionStatus"` to retrieve perpetual deployment auction status.

## Response

The response is an object containing auction timing and gas information:

### Timing information

* `startTimeSeconds` (integer) — Auction start time in seconds since epoch
* `durationSeconds` (integer) — Duration of the auction in seconds

### Gas information

* `startGas` (string) — Starting gas amount for the auction
* `currentGas` (string) — Current gas amount
* `endGas` (string or null) — Ending gas amount (null if auction is ongoing)

## Example request

<CodeGroup>
  ```shell Shell theme={"system"}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "perpDeployAuctionStatus"}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={"system"}
  from hyperliquid.info import Info

  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  status = info.query_perp_deploy_auction_status()
  print(status)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={"system"}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  const status = await info.perpDeployAuctionStatus();
  console.log(status);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

```json theme={"system"}
{
  "startTimeSeconds": 1747656000,
  "durationSeconds": 111600,
  "startGas": "500.0",
  "currentGas": "500.0",
  "endGas": null
}
```

## Use case

The `info` endpoint with `type: "perpDeployAuctionStatus"` is essential for applications that need to:

* **Auction timing**: Monitor the timing and duration of perpetual deployment auctions
* **Gas tracking**: Track gas amounts and changes during auction processes
* **System monitoring**: Monitor the status of the auction system infrastructure
* **Timeline calculation**: Calculate auction progress and remaining time
* **Integration timing**: Plan system integrations around auction schedules
* **Status reporting**: Report on auction system operational status
* **Data analysis**: Analyze auction patterns and gas consumption trends
* **Monitoring dashboards**: Display auction timing information in management interfaces

This endpoint provides basic timing and gas information for the perpetual deployment auction system on Hyperliquid.


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_perpdeployauctionstatus.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (perpDeployAuctionStatus)
      operationId: infoPerpDeployAuctionStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  default: perpDeployAuctionStatus
                  enum:
                    - perpDeployAuctionStatus
                  description: Request type to retrieve perpetual deployment auction status
              required:
                - type
      responses:
        '200':
          description: Current status of perpetual deployment auctions
          content:
            application/json:
              schema:
                type: object
                description: Perpetual deployment auction timing and gas information
                properties:
                  startTimeSeconds:
                    type: integer
                    description: Auction start time in seconds since epoch
                  durationSeconds:
                    type: integer
                    description: Duration of the auction in seconds
                  startGas:
                    type: string
                    description: Starting gas amount for the auction
                  currentGas:
                    type: string
                    description: Current gas amount
                  endGas:
                    type: string
                    nullable: true
                    description: Ending gas amount (null if auction is ongoing)
                required:
                  - startTimeSeconds
                  - durationSeconds
                  - startGas
                  - currentGas
                  - endGas
              example:
                startTimeSeconds: 1747656000
                durationSeconds: 111600
                startGas: '500.0'
                currentGas: '500.0'
                endGas: null

````