{"uid":"cap_3HwdItib831QAcleXC3p6","slug":"hivemindos-hyperliquid-perp-positions-trades-134fbeba","name":"HivemindOS Hyperliquid Perp Positions & Trades","description":"Perp positions and trades: Hyperliquid perp positions and trades for a wallet or a perp token, or the busiest perp markets. Use when an agent needs Hyperliquid positions and trades for a wallet, or the busiest perp markets. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.","url":"https://api.hivemindos.app/v1/x402/onchain-intelligence/perps.brief?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"}},"description":"The window to read, as YYYY-MM-DD dates. Defaults to recent days."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"EVM wallet address (0x…)."},"request":{"type":"string","maxLength":2000,"description":"The read in plain words, naming the address, $SYMBOL, chain or exchange."},"tokenSymbol":{"type":"string","maxLength":20,"description":"A perp market symbol, such as BTC."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wyl9Snq5viank7ueNg6Yj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves Hyperliquid perpetual futures positions, trades, and market activity for a wallet address, a specific perp token, or the busiest perp markets overall.","exampleAgentPrompt":"Pull the Hyperliquid perp positions and recent trades for wallet 0x1234...abcd over the past week, and also tell me which perp markets are busiest right now.","exampleUseCases":[{"title":"Wallet perp exposure audit","prompt":"Show me all open Hyperliquid perpetual positions and trades for wallet 0xAbCd1234...5678 from January 1 to January 14 so I can see their current crypto exposure."},{"title":"Top perp markets by activity","prompt":"Which Hyperliquid perpetual futures markets are the most active right now? Give me a ranked list of the busiest perp markets."},{"title":"Token-specific perp trade history","prompt":"Fetch all BTC perpetual trades on Hyperliquid from the last 7 days — I want to see how the market has been moving."}],"resultDescription":"Returns a structured summary of Hyperliquid perpetual futures data including open positions (size, direction, entry price, unrealized P&L), recent trade history (timestamps, sides, quantities, prices), and/or a ranked list of the busiest perp markets by activity, depending on the query parameters provided.","failureModes":["Invalid or malformed wallet address returns a validation error","Unknown token symbol returns no results or an error","Date range with no trading activity returns an empty result set","Payment failure (insufficient USDC on Base) causes the call to fail before data is returned","Overly broad or ambiguous plain-text request may return unexpected market scope"],"whenToPreferThis":"Use this endpoint when you specifically need Hyperliquid perpetual futures data — positions, trades, or market rankings. Prefer this over generic wallet profile endpoints when the user's focus is on derivatives/perp trading activity rather than spot balances or DeFi lending. Best suited for portfolio monitoring, trader analysis, or market intelligence on Hyperliquid perps.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:31:20.555Z","isFirstParty":false,"canonicalSlug":"hivemindos-hyperliquid-perp-positions-trades-134fbeba"}