# Vextorium Hyperliquid Positions

> Vextorium Hyperliquid Positions is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns all open perpetual futures positions and account-level margin stats for a given EVM wallet address on Hyperliquid

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-positions?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hyperliquid-positions-7445ba58
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dbYT5EjPBjrf5SzFU6D1U

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vextorium-hyperliquid-positions-7445ba58 -d '<json body>'
```

Example prompt: Pull the top 20 open Hyperliquid positions for wallet 0x010461c14e146ac35fe42271bdc1134ee31c703a and show me the unrealized PnL, leverage, and liquidation price for each.

## When to prefer this

Use this endpoint when you need real-time on-chain open position data specifically from Hyperliquid perpetuals for any EVM wallet, including margin utilization, liquidation prices, and funding accruals. Prefer it over generic portfolio trackers when you need Hyperliquid-specific derivatives data rather than spot balances or data from other DEXes.

## Known failure modes

- Invalid or malformed EVM wallet address returns an error or empty positions array
- Wallet has no open Hyperliquid positions — returns empty positions array with zeroed account stats
- Hyperliquid API downtime or rate limiting causes timeout or 5xx error
- Limit parameter out of range may return default count or validation error
- Non-EVM address format (e.g. Solana pubkey) will fail schema validation

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the wallet address, total open position count, account value in USD, withdrawable balance, total notional, total unrealized PnL, used margin, and an array of individual positions each containing asset name, long/short side, size, entry price (input), leverage, margin type (cross/isolated), used margin in USD, position value in USD, unrealized PnL in USD, ROE %, liquidation price, and cumulative funding in USD — sorted by position size descending.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Positions to return, largest first (default 20)"
  },
  "wallet": {
   "type": "string",
   "description": "EVM address (0x...)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "Hyperliquid (on-chain open data)",
  "wallet": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
  "positions": [
   {
    "side": "short",
    "size": 257798,
    "asset": "WIF",
    "input": 0.248962,
    "roe_pct": -49.54,
    "leverage": 20,
    "margin_type": "cross",
    "used_margin_usd": 3288.600187,
    "liquidation_price": 12.101198661,
    "position_value_usd": 65772.00374,
    "unrealized_pnl_usd": -1589.906025,
    "cumulative_funding_usd": -1415.618832
   },
   {
    "side": "long",
    "size": 251595,
    "asset": "APEX",
    "input": 0.264139,
    "roe_pct": -88.66,
    "leverage": 20,
    "margin_type": "cross",
    "used_margin_usd": 3175.506292,
    "liquidation_price": null,
    "position_value_usd": 63510.12585,
    "unrealized_pnl_usd": -2946.152408,
    "cumulative_funding_usd": 3578.168162
   }
  ],
  "open_positions": 177,
  "used_margin_usd": 223737.93189,
  "withdrawable_usd": 2681703.459226,
  "account_value_usd": 3129179.323074,
  "total_notional_usd": 4474758.638828,
  "total_unrealized_pnl_usd": 4167.69
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hyperliquid-positions-7445ba58/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)