Skip to main content
POST
validatorL1Votes | Hyperliquid Info API

Credit Cost

1 per call

Processing

Realtime
The Hyperliquid info endpoint with type: "validatorL1Votes" is used to fetch the pending validator L1 governance votes/actions.
Estimate your monthly cost for this API using the Pricing Calculator.
  • Wire-equal to POST api.hyperliquid.xyz/info with {"type": "validatorL1Votes"}.
  • Each entry is an L1 governance action currently awaiting validator votes, with an expireTime (ms) after which the pending vote lapses.
  • The action object is a tagged variant; its inner shape depends on the specific L1 action being voted on (the example below shows a settleOutcome action).
  • This is a global, non-user-keyed type.
Returns the pending validator L1 governance votes - the L1 actions currently awaiting validator approval. Each entry pairs an expireTime with the action under vote. The action is a tagged variant whose inner structure depends on the action type, so treat it as an opaque object keyed by action tag unless you are decoding a specific action you recognize.

Endpoint

Request

string
required
Always "validatorL1Votes".

Example

Response

An array of pending L1 action votes. Empty when no L1 action is awaiting votes.

Field descriptions

object
A pending L1 governance action awaiting validator votes.

exchangeStatus

fetch the current exchange operational status.

liquidatable

list accounts currently eligible for liquidation.

marginTable

fetch the margin-tier (leverage-bracket) table for a given margin table id.

maxBuilderFee

fetch the maximum builder fee a user has approved for a given builder.

maxMarketOrderNtls

fetch the maximum market-order notional for each leverage bucket.
See all Hyperliquid endpoints: Overview hub · Info API reference Last reviewed: 2026-07-24