> ## 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.

# Additional Read Endpoints

> Vaults, staking, oracle history, TWAP summaries, spot deployment, and validator read endpoints

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).

```bash theme={null}
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.

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" https://hyper.polynode.dev/v2/validator/l1-votes
```

Example response when no active votes:

```json theme={null}
[]
```

***

## 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).

```bash theme={null}
curl -H "x-api-key: YOUR_KEY" \
  "https://hyper.polynode.dev/v2/spot-deploy-state?user=0xacd89cFCB82Ae1f843467D56b58796bb928C9E1A"
```

Example response:

```json theme={null}
{
  "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](/research/gas-auctions) 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.