View Source Hyperliquid.Api.Info.PerpDeployAuctionStatus (hyperliquid v0.2.2)

Status of the perpetual deployment auction.

Returns information about the current gas auction for deploying new perpetuals.

See: https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint/perpetuals

Summary

Functions

Returns metadata about this endpoint.

Returns postgres table configurations (multi-table support).

Returns storage configuration for this endpoint.

Check if the auction is currently active.

Build a cache key from response data using the configured pattern. Returns nil if cache is not enabled or no pattern configured.

Build the request payload.

Returns true if cache storage is enabled.

Returns the cache TTL if configured.

Creates a changeset for perp deploy auction status data.

Get the end time of the auction in seconds.

Fetch is an alias for request when no storage is configured.

Parse and validate the API response.

Returns true if postgres storage is enabled.

Returns the postgres table name if configured (primary table for legacy support).

Returns the upsert config for postgres (primary table for legacy support).

Get the rate limit cost for this endpoint.

Get remaining time in the auction in seconds.

Make the API request and parse the response.

Make the API request, raising on error.

Make the API request and return the raw response map (no key transformation).

Make the API request returning raw map, raising on error.

Returns true if any storage backend is enabled.

Types

@type t() :: %Hyperliquid.Api.Info.PerpDeployAuctionStatus{
  current_gas: String.t(),
  duration_seconds: non_neg_integer(),
  end_gas: String.t() | nil,
  start_gas: String.t(),
  start_time_seconds: non_neg_integer()
}

Functions

Returns metadata about this endpoint.

Example

iex> Hyperliquid.Api.Info.PerpDeployAuctionStatus.__endpoint_info__()
%{
  endpoint: "perpDeployAuctionStatus",
  type: :info,
  rate_limit_cost: 1,
  params: [],
  optional_params: [],
  doc: "Retrieve perpetual deployment auction status",
  returns: "Current gas auction information for deploying new perpetuals"
}

Returns postgres table configurations (multi-table support).

Returns storage configuration for this endpoint.

Link to this function

active?(perp_deploy_auction_status, current_time)

View Source
@spec active?(t(), non_neg_integer()) :: boolean()

Check if the auction is currently active.

Parameters

  • status: The auction status struct
  • current_time: Current time in seconds (Unix timestamp)

Returns

  • boolean()

Build a cache key from response data using the configured pattern. Returns nil if cache is not enabled or no pattern configured.

@spec build_request() :: map()

Build the request payload.

Returns true if cache storage is enabled.

Returns the cache TTL if configured.

Link to this function

changeset(status \\ %__MODULE__{}, attrs)

View Source
@spec changeset(t(), map()) :: Ecto.Changeset.t()

Creates a changeset for perp deploy auction status data.

Parameters

  • status: The auction status struct
  • attrs: Map of attributes to validate

Returns

  • Ecto.Changeset.t()
Link to this function

end_time_seconds(perp_deploy_auction_status)

View Source
@spec end_time_seconds(t()) :: non_neg_integer()

Get the end time of the auction in seconds.

Parameters

  • status: The auction status struct

Returns

  • non_neg_integer()

Fetch is an alias for request when no storage is configured.

@spec parse_response(map()) :: {:ok, t()} | {:error, term()}

Parse and validate the API response.

Returns true if postgres storage is enabled.

Returns the postgres table name if configured (primary table for legacy support).

Link to this function

postgres_upsert_config()

View Source

Returns the upsert config for postgres (primary table for legacy support).

@spec rate_limit_cost() :: non_neg_integer()

Get the rate limit cost for this endpoint.

Link to this function

remaining_seconds(status, current_time)

View Source
@spec remaining_seconds(t(), non_neg_integer()) :: integer()

Get remaining time in the auction in seconds.

Parameters

  • status: The auction status struct
  • current_time: Current time in seconds (Unix timestamp)

Returns

  • integer() - Can be negative if auction has ended
@spec request() :: {:ok, t()} | {:error, term()}

Make the API request and parse the response.

@spec request!() :: t()

Make the API request, raising on error.

@spec request_raw() :: {:ok, map()} | {:error, term()}

Make the API request and return the raw response map (no key transformation).

@spec request_raw!() :: map()

Make the API request returning raw map, raising on error.

Returns true if any storage backend is enabled.