{"uid":"cap_Lvj7uUxkCOE8MphVePTpu","slug":"hyperliquid-trader-positions-428a4c52","name":"Hyperliquid Trader Positions","description":"Operator-neutral Hyperliquid trading intelligence — perp fills, position lifecycles, all-wallet leaderboards, trader cohorts, liquidation risk and prediction markets. Every endpoint is FIRST-PARTY: computed from our own node_fills ledger and the Hyperliquid public info API (no third-party data source). Free quota, then HTTP 402 (x402: pay-per-call in USDC, no account, no key).","url":"https://hyperliquid-data.v1337.org/services/hyperliquid-data/v1/traders/positions","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","description":"Operator-defined JSON payload. Probe the upstream or consult the operator's /openapi.json for the concrete shape.","additionalProperties":true},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sqTZEYbrIym02zabu42yp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves current perpetual futures positions and position lifecycle data for traders on Hyperliquid DEX","exampleAgentPrompt":"Can you pull the current open perpetual positions for Hyperliquid wallet 0xAbC123...def — I want to see what markets they're in, their leverage, and how close any positions are to liquidation?","exampleUseCases":null,"resultDescription":"Returns a structured list of the trader's active perpetual futures positions on Hyperliquid, including asset, direction (long/short), position size, entry price, current mark price, unrealized PnL, leverage, and liquidation price threshold.","failureModes":["Invalid or missing wallet address returns a 400 bad request","Unknown or inactive wallet with no positions returns empty results","Upstream Hyperliquid API downtime causes 503 or timeout","Exceeding free quota without payment triggers HTTP 402 requiring USDC micropayment","Malformed request body causes 422 unprocessable entity"],"whenToPreferThis":"Use this endpoint when you need real-time, first-party Hyperliquid perpetual position data for a specific trader or wallet — particularly when you want position lifecycle details, liquidation proximity, or PnL without relying on third-party data aggregators. Prefer this over generic DeFi analytics APIs when the query is Hyperliquid-specific.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T15:26:09.121Z","isFirstParty":false}