# Laevitas Hyperliquid Node Wallet Flow > Laevitas Hyperliquid Node Wallet Flow is a paid API for AI agents from apiv2.laevitas.ch, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13). Retrieves wallet-level trading flow data from Hyperliquid HyperCore node, including notional volumes, buy/sell activity, realized PnL, and trade counts per wallet address. ## Facts - Endpoint: GET https://apiv2.laevitas.ch/api/v1/hyperliquid/node/wallet-flow - Price: $0.1/call - Payment: x402 - Status: unknown - Last checked: 2026-09-13 - Activations on Zero: 0 - Tags: x402 - Canonical page: https://www.zero.xyz/c/laevitas-hyperliquid-node-wallet-flow-62b4e61d - Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9OH6o4jg-dxf61J7vP0JX 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 laevitas-hyperliquid-node-wallet-flow-62b4e61d ``` Example prompt: Pull the Hyperliquid wallet flow for address 0xABC123 on perp markets, sorted by net_notional, with a limit of 100 records, from 2024-01-01 to 2024-06-30 at 1h resolution. ## When to prefer this Use this endpoint when you need wallet-level trading flow and activity analytics specifically on the Hyperliquid HyperCore network, including buy/sell notional, net flow, realized PnL, and trade counts. Prefer this over generic on-chain analytics when you need Laevitas's proprietary Hyperliquid node data with flexible filtering by instrument, market type (perp, spot, prediction), and resolution. Best suited for agent workflows analyzing individual wallet behavior, large trader flow, or on-chain activity attribution on Hyperliquid. ## Known failure modes - Missing or invalid wallet address returns empty data array - Invalid market_type enum value returns 400 error - Invalid resolution enum value returns 400 error - sort_by value not in allowed enum returns 400 error - Limit exceeding 1000 returns validation error - Invalid date format for start/end returns 400 error - Missing or invalid API key / insufficient x402 payment returns 401/402 - No data found for given wallet in specified time range returns empty data array ## How this service works Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics. ## Authentication Use an API key for authenticated REST requests: ```http X-API-Key: your-api-key-here ``` Most data endpoints also support x402 pay-per-request without an API key. | Resource | Path | | --- | --- | | OpenAPI JSON | `GET /openapi.json` | | x402 discovery | `GET /.well-known/x402` | | Changelog | `GET /api/v1/changelog` | | WebSocket docs | `GET /websocket` | ## REST Surfaces | Surface | Examples | | --- | --- | | Instruments | Cross-market contract reference data | | Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry | | Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations | | Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX | | Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk | | Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots | | Predictions | Polymarket instruments, categories, trades, ticker history | | Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books | | Analytics | Realized volatility and derived metrics | ## Pagination Paginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page. ## WebSocket Streaming Real-time streams are documented at `/websocket`. | Data | Channel pattern | | --- | --- | | Trades | `trades.{market}.{exchange}.{instrument}` | | OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` | | OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` | Variables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`. ## Quick Start ```bash curl "https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL" \ -H "X-API-Key: your-api-key-here" ``` ## Output Returns a JSON object with a 'data' array containing wallet-level trading flow records from Hyperliquid HyperCore node, including fields such as buy notional, sell notional, net notional, realized PnL, trade count, and total notional per wallet, along with a 'success' boolean status flag. ## Request schema (JSON Schema) ```json { "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "input" ], "properties": { "input": { "type": "object", "required": [ "type", "method" ], "properties": { "type": { "type": "string", "const": "http" }, "method": { "enum": [ "GET" ], "type": "string" }, "pathParams": { "type": "object" }, "queryParams": { "type": "object", "properties": { "end": { "type": "string" }, "limit": { "type": "integer", "maximum": 1000, "minimum": 1 }, "start": { "type": "string" }, "cursor": { "type": "string" }, "dedupe": { "type": "boolean" }, "wallet": { "type": "string" }, "sort_by": { "enum": [ "time", "total_notional", "buy_notional", "sell_notional", "net_notional", "realized_pnl", "trade_count" ], "type": "string" }, "currency": { "type": "string" }, "exchange": { "type": "string" }, "resolution": { "enum": [ "1m", "5m", "15m", "1h", "4h", "1d" ], "type": "string" }, "market_type": { "enum": [ "perp", "perp_hip3", "spot", "prediction" ], "type": "string" }, "min_notional": { "type": "number" }, "instrument_name": { "type": "string" }, "instrument_name_raw": { "type": "string" }, "min_target_notional": { "type": "number" }, "max_distance_from_mark": { "type": "number" } } } }, "additionalProperties": false }, "output": { "type": "object", "required": [ "type" ], "properties": { "type": { "type": "string" }, "example": { "type": "object" } } } } } ``` ## Response schema (JSON Schema) ```json { "type": "json", "example": { "data": [], "success": true } } ``` ## More - Live health (JSON, refreshed every minute): https://www.zero.xyz/c/laevitas-hyperliquid-node-wallet-flow-62b4e61d/health.json - [Zero catalog index](https://www.zero.xyz/llms.txt) - [Other services from apiv2.laevitas.ch](https://www.zero.xyz/host/apiv2.laevitas.ch/llms.txt)