Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hypernode-docs.polynode.dev/llms.txt

Use this file to discover all available pages before exploring further.

These endpoints expose read-only HyperLiquid state queries that aren’t covered by the main market data or user data pages. All responses are standard HyperLiquid info API shapes — drop-in compatible with existing code that consumes the public HL info endpoint.

​
Vaults

​
GET /v2/vaults

List every active vault on HyperLiquid. Returns an array of vault summaries (vault address, leader, TVL, recent PnL history). 
curl -H "x-api-key: YOUR_KEY" https://hyper.polynode.dev/v2/vaults
Use case: building a vault directory page, tracking vault TVL over time, comparing vault performance.

​
GET /v2/vaults/leading

Vaults led by a specific user. Pass ?user=0x... with the vault leader’s address. Use case: showing “vaults led by this user” on a profile page.

​
GET /v2/user/vaults

Vault equity positions for a specific user (what vaults they’re invested in). Pass ?user=0x.... Use case: user profile pages showing vault holdings alongside spot and perp positions.

​
Delegations and staking

​
GET /v2/user/delegations

Current active delegations for a user. Pass ?user=0x.... Use case: staking dashboards showing a user’s active stake.

​
GET /v2/user/delegator-history

Historical delegate, undelegate, and withdrawal events for a user. Pass ?user=0x.... Use case: staking history timelines, audit trails.

​
GET /v2/user/delegator-rewards

Historical and unclaimed staking rewards for a user. Pass ?user=0x.... Use case: rewards dashboards, tax reporting.

​
TWAP orders

​
GET /v2/user/twap-summaries

Aggregated TWAP order status for a user — pending, executed, and canceled TWAPs with totals. Pass ?user=0x.... Use case: displaying a user’s active TWAP orders on a trading dashboard.

​
GET /v2/user/twap-fills

Individual slice fills for each of a user’s TWAP orders. Pass ?user=0x.... Use case: showing the execution timeline of a specific TWAP order.

​
Validator state

​
GET /v2/validator/l1-votes

Current L1 governance votes from active validators. Returns an array of vote records (validator address, proposal, vote). Use case: governance dashboards, tracking what the validator set is voting on. 
curl -H "x-api-key: YOUR_KEY" https://hyper.polynode.dev/v2/validator/l1-votes
Example response when no active votes: 
[]

​
Spot deployment

​
GET /v2/spot-deploy-state

Current spot token deployment state for a deployer, plus the global gas auction parameters. Pass ?user=0x... (any address works — the gas auction state is returned regardless of whether that user is deploying). 
curl -H "x-api-key: YOUR_KEY" \
  "https://hyper.polynode.dev/v2/spot-deploy-state?user=0xacd89cFCB82Ae1f843467D56b58796bb928C9E1A"
Example response: 
{
  "states": [],
  "gasAuction": {
    "startTimeSeconds": 1776225600,
    "durationSeconds": 111600,
    "startGas": "500.0",
    "currentGas": "500.0",
    "endGas": null
  }
}
Use case: monitoring the spot deployment gas auction (Dutch auction — price decays linearly over durationSeconds). See Gas Auctions research for the full mechanism.

​
Why these endpoints

These are standard HyperLiquid info API queries exposed through your hypernode API key. You get them on the same key that serves the WebSocket stream, exchange API, and batch queries — no second integration, no separate rate limit bucket, one bill.