{"uid":"cap_Bfm6wiP8EWPeC9aMAZ6a8","slug":"trader-perps-f9c850b2","name":"trader-perps","description":"Open Hyperliquid perpetual positions for an EVM address: per-position direction, size, USD notional, leverage, entry, mark, unrealized PnL, ROE and liquidation price, PLUS derived signals — distance-to-liquidation, account leverage, aggregate unrealized PnL, concentration and a deterministic 0-100 liquidation-risk score. Follow-the-smart-money wallet intelligence in one call. public on-chain data, not financial advice.","url":"https://payai.agentstools.dev/trader/perps","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"A 0x-prefixed 40-hex EVM address (the wallet to profile). Hosts are fixed server-side; you pass only this address."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.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_buQo5JEL-oRWDpLGB8Ir0","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":"Returns wallet-level perpetuals position data and derived risk metrics for a given EVM address using Hyperliquid on-chain state","exampleAgentPrompt":"Pull the Hyperliquid perpetuals position data and liquidation risk metrics for wallet 0x1234567890abcdef1234567890abcdef12345678 — I want to see their open positions, account summary, and how close they are to getting liquidated.","exampleUseCases":null,"resultDescription":"Returns a structured object containing the wallet's Hyperliquid perpetuals account summary, all open perpetual positions (size, side, entry price, mark price, unrealized PnL), derived liquidation risk metrics, and attribution data such as margin usage and leverage levels.","failureModes":["Invalid or malformed 0x address returns 400 or validation error","Address with no Hyperliquid activity returns empty positions array","Hyperliquid on-chain state temporarily unavailable causes 503 or timeout","Missing required 'address' query parameter returns error","Non-EVM address format (e.g. ENS name not resolved) fails validation"],"whenToPreferThis":"Use this endpoint when you need wallet-level perpetuals position data from Hyperliquid specifically, including liquidation risk and account-level risk metrics derived from on-chain state. Prefer this over generic DeFi portfolio trackers when the user is specifically asking about perpetuals or derivatives exposure on Hyperliquid, or when you need liquidation proximity analysis for a specific trader address.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:10:42.206Z","isFirstParty":false}