{"uid":"cap_9OH6o4jg-dxf61J7vP0JX","slug":"laevitas-hyperliquid-node-wallet-flow-62b4e61d","name":"Laevitas Hyperliquid Node Wallet Flow","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-flow","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_wMFjvF2U5VoQa5kzMxAnN","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 trading flow data from Hyperliquid HyperCore node, including notional volumes, buy/sell activity, realized PnL, and trade counts per wallet address.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Monitor whale trading activity patterns","prompt":"Show me the top 50 Hyperliquid wallets by realized PnL over the last 30 days across perpetual markets. I want to see their buy and sell notional volumes so I can identify which addresses are consistently profitable traders."},{"title":"Track wallet flow across market types","prompt":"Get me the trading flow for wallet 0xDEF456 across Hyperliquid spot, perpetuals, and prediction markets for the past week. I need to see their net notional, trade counts, and realized PnL broken down by each market to understand their strategy."},{"title":"Analyze liquidation risk by wallet","prompt":"Pull wallet-level data for all Hyperliquid addresses that had more than 10 trades in the last 3 days, sorted by highest notional volume. Include their realized PnL and current positions so I can flag which ones might be overleveraged."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T07:00:23.318Z","isFirstParty":false}