{"uid":"cap_NMYLiFtfSeafE2o9u55Ka","slug":"laevitas-hyperliquid-node-wallet-positions-afc52b97","name":"Laevitas Hyperliquid Node Wallet Positions","description":"Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.\n\n## Authentication\n\nUse an API key for authenticated REST requests:\n\n```http\nX-API-Key: your-api-key-here\n```\n\nMost data endpoints also support x402 pay-per-request without an API key.\n\n| Resource | Path |\n| --- | --- |\n| OpenAPI JSON | `GET /openapi.json` |\n| x402 discovery | `GET /.well-known/x402` |\n| Changelog | `GET /api/v1/changelog` |\n| WebSocket docs | `GET /websocket` |\n\n## REST Surfaces\n\n| Surface | Examples |\n| --- | --- |\n| Instruments | Cross-market contract reference data |\n| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |\n| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |\n| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |\n| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |\n| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |\n| Predictions | Polymarket instruments, categories, trades, ticker history |\n| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |\n| Analytics | Realized volatility and derived metrics |\n\n## Pagination\n\nPaginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.\n\n## WebSocket Streaming\n\nReal-time streams are documented at `/websocket`.\n\n| Data | Channel pattern |\n| --- | --- |\n| Trades | `trades.{market}.{exchange}.{instrument}` |\n| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |\n| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |\n\nVariables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.\n\n## Quick Start\n\n```bash\ncurl \"https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL\" \\\n  -H \"X-API-Key: your-api-key-here\"\n```","url":"https://apiv2.laevitas.ch/api/v1/hyperliquid/node/wallet-positions","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"data":[],"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UmSiM66bGMiwL4X8Z5whz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves wallet-level position data from Hyperliquid HyperCore node, including trade history and position details filterable by wallet address, market type, and time range.","exampleAgentPrompt":"Show me the perpetual positions and realized PnL for Hyperliquid wallet 0xAbC123... — sort by realized_pnl, limit to 100 results, and filter to perp market type.","exampleUseCases":[{"title":"Monitor whale trading activity on Hyperliquid","prompt":"Pull the last 500 trades for wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f42bE, grouped by instrument — I need to see which perp markets this trader is most active in and their total notional exposure."},{"title":"Track realized PnL across multiple trader wallets","prompt":"Fetch realized PnL and position details for these five Hyperliquid addresses over the last 30 days, then show me which ones are net profitable and what their biggest winners and losers were by instrument."},{"title":"Audit spot and perpetual holdings for a fund","prompt":"Get all open positions and trade history for our fund's Hyperliquid wallet 0x8e2A0E02b1F9a0cB8c1E5F6D3A2b4C9d7E1f5A3B — break it down by market type (spot vs perps) and show me current notional value and unrealized PnL for each position."}],"resultDescription":"Returns a JSON object with a `data` array of wallet position records from the Hyperliquid HyperCore node, including fields for trade notional, buy/sell notional, net notional, realized PnL, and trade count, plus a `success` boolean indicating request status.","failureModes":["Missing or invalid wallet address returns empty data array","Invalid market_type enum value returns 400 error","limit out of range (must be 1–1000) returns validation error","Invalid sort_by enum value returns 400 error","Unpaid or expired x402 payment returns 402 Payment Required","Invalid API key returns 401 Unauthorized","No data found for the given wallet/time range returns empty data array"],"whenToPreferThis":"Use this endpoint when you need wallet-level position or trade data specifically from the Hyperliquid HyperCore decentralized exchange node. Prefer this over generic crypto portfolio endpoints when the user is focused on Hyperliquid-native perp, spot, or prediction market positions with on-chain wallet granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:33:46.842Z","isFirstParty":false}