{"uid":"cap_b_LkxIpWj6wukOnENewwG","slug":"speraxos-perpetuals-position-fetcher-88c8062c","name":"SperaxOS Perpetuals Position Fetcher","description":"SperaxOS is an AI-powered DeFi operating system — track portfolios, execute swaps, analyze on-chain data, and collaborate with intelligent agents that manage your crypto workflow.","url":"https://chat.sperax.io/api/x402/tools/perpetuals/getPositions?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"exchange":{"enum":["gmx","hyperliquid","dydx","all"],"type":"string","default":"all","description":"Exchange to query: gmx, hyperliquid, dydx, or all"},"walletAddress":{"type":"string","description":"Wallet address (0x...)"}}},"responseSchema":null,"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":"unknown","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_wnxxQkctucOv-DyfF3GP1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0xD74f5255D557944cf7Dd0E45FF521520002D5748","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches open perpetual futures positions for a wallet address across GMX, Hyperliquid, dYdX, or all three exchanges","exampleAgentPrompt":"Can you pull up all my open perpetual positions for wallet 0xAbCd1234... across GMX, Hyperliquid, and dYdX on SperaxOS?","exampleUseCases":[{"title":"Cross-exchange perp exposure check","prompt":"What open perpetual futures positions do I have across all exchanges for wallet 0x1234abcd5678efgh? I want to see everything on GMX, Hyperliquid, and dYdX in one view."},{"title":"Single exchange position audit","prompt":"Show me only my Hyperliquid perpetual positions for wallet 0xDeAdBeEf0000 — I want to review my current open trades there."},{"title":"Portfolio risk monitoring agent","prompt":"For wallet 0xAaBbCcDd1122, fetch all my open perp positions across every exchange so I can see my total leveraged exposure right now."}],"resultDescription":"Returns a list of open perpetual futures positions for the specified wallet address, including details such as position size, side (long/short), entry price, leverage, unrealized PnL, and the exchange each position is on. When 'all' is selected, results are aggregated across GMX, Hyperliquid, and dYdX.","failureModes":["Invalid or malformed wallet address returns an error or empty result","Specified exchange is temporarily unavailable or rate-limited","Wallet has no open positions — returns empty array","Unsupported exchange enum value causes validation error","Network timeout if on-chain data sources are slow to respond"],"whenToPreferThis":"Use this endpoint when you need to query live open perpetual futures positions for a specific wallet across one or more major decentralized perpetuals exchanges (GMX, Hyperliquid, dYdX). It is ideal for portfolio dashboards, risk monitoring agents, or any workflow that needs a cross-exchange consolidated view of leveraged positions without requiring individual exchange API integrations.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T18:38:27.646Z","isFirstParty":false,"canonicalSlug":"speraxos-perpetuals-position-fetcher-88c8062c"}