View Source Hyperliquid.Api.Info.Delegations (hyperliquid v0.2.2)
User's staking delegations.
Returns the list of validators a user has delegated to, with amounts and lock times.
Usage
{:ok, delegations} = Delegations.request("0x1234...")
{:ok, total} = Delegations.total_delegated(delegations)
Summary
Functions
Returns metadata about this endpoint.
Returns postgres table configurations (multi-table support).
Returns storage configuration for this endpoint.
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 delegations data.
Fetch is an alias for request when no storage is configured.
Get delegations that are currently locked.
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.
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.
Get delegation to a specific validator.
Get total delegated amount.
Get delegations that are unlocked.
Get all unique validators.
Types
@type t() :: %Hyperliquid.Api.Info.Delegations{delegations: [Delegation.t()]}
Functions
Returns metadata about this endpoint.
Example
iex> Hyperliquid.Api.Info.Delegations.__endpoint_info__()
%{
endpoint: "delegations",
type: :info,
rate_limit_cost: 2,
params: [:user],
optional_params: [],
doc: "Retrieve user's staking delegations",
returns: "List of validators user has delegated to with amounts and lock times"
}
Returns postgres table configurations (multi-table support).
Returns storage configuration for this endpoint.
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.
@spec changeset(t(), map()) :: Ecto.Changeset.t()
Creates a changeset for delegations data.
Parameters
delegations: The delegations structattrs: Map with delegations key
Returns
Ecto.Changeset.t()
Fetch is an alias for request when no storage is configured.
@spec locked(t(), non_neg_integer()) :: [map()]
Get delegations that are currently locked.
Parameters
delegations: The delegations structcurrent_time: Current time in milliseconds
Returns
- List of locked delegations
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).
@spec rate_limit_cost() :: non_neg_integer()
Get the rate limit cost for this endpoint.
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.
Get delegation to a specific validator.
Parameters
delegations: The delegations structvalidator: Validator address
Returns
{:ok, Delegation.t()}if found{:error, :not_found}if not found
Get total delegated amount.
Parameters
delegations: The delegations struct
Returns
{:ok, float()}- Total amount{:error, :parse_error}- If parsing fails
@spec unlocked(t(), non_neg_integer()) :: [map()]
Get delegations that are unlocked.
Parameters
delegations: The delegations structcurrent_time: Current time in milliseconds
Returns
- List of unlocked delegations
Get all unique validators.
Parameters
delegations: The delegations struct
Returns
- List of validator addresses