{"uid":"cap_13XV-GH9QRtm3ZZQZwuYF","slug":"hyperliquid-trader-profile-live-perp-positions-98ff4157","name":"Hyperliquid Trader Profile & Live Perp Positions","description":"Live perp positions for a Hyperliquid EVM (0x) address, read from Hyperliquid's public on-chain state. Per-position coin, side, leverage, notional, entry, unrealized PnL, distance-to-liquidation, and risk flags (high/extreme leverage, approaching liquidation, losing). Plus account value, directional bias, profile, weighted leverage, and realized+unrealized PnL over week/month/all-time. The building block for smart-money tracking.","url":"https://api.solenrich.com/entrypoints/hyperliquid-trader-profile/invoke","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"format":{"enum":["json","llm","both"],"type":"string","default":"json"},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Hyperliquid EVM (0x) address"}}},"responseSchema":{"type":"json","example":{"output":{"briefing":"string (llm format) or object (json format)"},"run_id":"uuid","status":"succeeded"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rSDbJW5zNlfgpjCO4ZMW_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live perpetual futures positions, risk flags, account value, PnL history, and smart-money profile metrics for a given Hyperliquid EVM address.","exampleAgentPrompt":"Pull the live perp positions and risk profile for Hyperliquid address 0x1234567890abcdef1234567890abcdef12345678 — I want to see their current leverage, any liquidation warnings, and their PnL over the past week and month.","exampleUseCases":null,"resultDescription":"A structured breakdown of all open perpetual positions for the address (coin, long/short side, leverage, notional, entry price, unrealized PnL, distance to liquidation, risk flags like high/extreme leverage or approaching liquidation), plus account-level data: total account value, directional bias, weighted leverage, trader profile classification, and realized+unrealized PnL over the past week, month, and all time.","failureModes":["Invalid or malformed 0x address returns a validation error","Address has no open positions — returns empty positions array with account-level data only","Hyperliquid on-chain state temporarily unavailable — upstream timeout or data gap","Address has never traded on Hyperliquid — returns zeroed-out or minimal profile","Incorrect format enum value causes schema validation failure"],"whenToPreferThis":"Use this endpoint when you need a complete, real-time risk and performance snapshot of a specific Hyperliquid perpetuals trader — especially for smart-money surveillance, copy-trading due diligence, or liquidation risk monitoring. Prefer this over generic portfolio trackers when you specifically need Hyperliquid perp-level data including risk flags and weighted leverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:39.321Z","isFirstParty":false}