{"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?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"format":{"enum":["json","llm","both"],"type":"string","default":"json","description":"Response format: json (structured fields, default), llm (short deterministic briefing), or both (fields plus llm_summary)."},"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Hyperliquid EVM (0x) address"}}},"responseSchema":{"type":"json","example":{"output":{"pnl":{"week_usd":4791600,"month_usd":4660400,"all_time_usd":11216000},"flags":{"any_high_leverage":false,"concentrated_coin":null,"any_near_liquidation":false},"venue":"hyperliquid","totals":{"position_count":6,"net_notional_usd":25851000,"weighted_leverage":4.6874,"gross_notional_usd":25851000,"total_unrealized_pnl_usd":3430100},"account":{"value_usd":8864900,"margin_used_usd":8422400,"withdrawable_usd":4381.6,"total_notional_usd":25851000},"address":"0xd21d931890d27b6e7e2e668f27931e17698e90f1","profile":"directional_long","positions":[{"dir":"long","coin":"SOL","flags":{"losing":false,"high_leverage":false,"extreme_leverage":false,"approaching_liquidation":false},"pnl_pct":37.78,"entry_px":110.34,"leverage":5,"current_px":118.68,"size_tokens":85001,"notional_usd":10088000,"liquidation_px":90.604,"margin_used_usd":2579000,"unrealized_pnl_usd":708700,"distance_to_liq_pct":23.657}],"fetched_at":1790035807796,"has_positions":true,"directional_bias":"long"},"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":{"p10Cents":"1.2000","medianCents":"1.2000","p90Cents":"1.2000","minCents":"1.2000","maxCents":"1.2000","p95Cents":"1.2000","sampleCount":1,"varies":false,"failureChargeRate":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-10-27T18:44:45.772Z","isFirstParty":false,"canonicalSlug":"hyperliquid-trader-profile-live-perp-positions-98ff4157"}